{"id":21971,"library":"rollup-plugin-css-asset","title":"rollup-plugin-css-asset","description":"A Rollup plugin that bundles imported CSS files into a separate CSS asset file, respecting Rollup's asset handling and sourcemap options. Version 1.0.2 is the current stable release; the plugin is in maintenance mode with no recent updates. It differentiates from other CSS plugins by focusing on simplicity: no post-processing, no JS injection, just emitting CSS as a Rollup asset with hashing and path customization. Requires Rollup >=1.19.0.","status":"maintenance","version":"1.0.2","language":"javascript","source_language":"en","source_url":"https://github.com/alexdilley/rollup-plugin-css-asset","tags":["javascript","rollup-plugin","css"],"install":[{"cmd":"npm install rollup-plugin-css-asset","lang":"bash","label":"npm"},{"cmd":"yarn add rollup-plugin-css-asset","lang":"bash","label":"yarn"},{"cmd":"pnpm add rollup-plugin-css-asset","lang":"bash","label":"pnpm"}],"dependencies":[],"imports":[{"note":"Plugin is ESM-only; CommonJS require will fail.","wrong":"const css = require('rollup-plugin-css-asset')","symbol":"default (css)","correct":"import css from 'rollup-plugin-css-asset'"},{"note":"Package exports both default and named 'css', but default is preferred for clarity.","wrong":"import { default as css } from 'rollup-plugin-css-asset'","symbol":"css (named import)","correct":"import { css } from 'rollup-plugin-css-asset'"},{"note":"Package includes TypeScript types; no separate type import needed.","wrong":"","symbol":"TypeScript types","correct":"import css from 'rollup-plugin-css-asset'"}],"quickstart":{"code":"// rollup.config.js\nimport css from 'rollup-plugin-css-asset';\n\nexport default {\n  input: 'src/index.js',\n  output: {\n    dir: 'dist',\n    format: 'es',\n    sourcemap: true,\n    assetFileNames: 'assets/[name]-[hash][extname]',\n  },\n  plugins: [\n    css({\n      name: 'bundle',\n    }),\n  ],\n};","lang":"javascript","description":"Basic Rollup configuration using rollup-plugin-css-asset to bundle CSS into a separate asset file with hashing and sourcemaps."},"warnings":[{"fix":"Combine with postcss plugin (e.g., rollup-plugin-postcss) if CSS processing is needed.","message":"Plugin does not process CSS (no autoprefixer, minification, etc.); it emits CSS as-is.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Ensure all CSS files are imported in your entry points or dependencies.","message":"CSS files must be imported in JavaScript to be bundled; standalone CSS references are ignored.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Use code splitting or multiple plugin instances if separate CSS outputs are required.","message":"The plugin only emits a single CSS asset per build; multiple inputs produce one CSS file.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Upgrade Rollup to >=1.19.0.","message":"Version 1.0.0 dropped support for Rollup <1.19.0.","severity":"breaking","affected_versions":">=1.0.0 <2.0.0"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"Run: npm install --save-dev rollup-plugin-css-asset","cause":"Package not installed or not in devDependencies.","error":"Error: Cannot find module 'rollup-plugin-css-asset'"},{"fix":"Change to: import css from 'rollup-plugin-css-asset'","cause":"Using CommonJS require() instead of ESM import.","error":"TypeError: css is not a function"},{"fix":"Add import './styles.css' in your entry file.","cause":"No CSS files imported in the JavaScript bundle.","error":"The emitted file 'assets/bundle-xxxxx.css' does not contain any CSS content."}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}