{"id":22290,"library":"rollup-plugin-windicss","title":"rollup-plugin-windicss","description":"A Rollup plugin for Windi CSS, an on-demand Tailwind CSS replacement that generates utilities at build time instead of scanning a massive pre-generated stylesheet. Version 1.9.4 is current, maintained as part of the vite-plugin-windicss monorepo. It provides fast compilation, supports Tailwind CSS v2 configs, utility groups, CSS @apply/@screen transforms, and Vite/HMR compatibility. Peer dependency on Rollup. Differentiates from Tailwind CSS by being faster for large projects and generating only used styles.","status":"active","version":"1.9.4","language":"javascript","source_language":"en","source_url":"https://github.com/antfu/vite-plugin-windicss","tags":["javascript","rollup","rollup-plugin","windicss","tailwindcss","typescript"],"install":[{"cmd":"npm install rollup-plugin-windicss","lang":"bash","label":"npm"},{"cmd":"yarn add rollup-plugin-windicss","lang":"bash","label":"yarn"},{"cmd":"pnpm add rollup-plugin-windicss","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Peer dependency required for Rollup plugin compatibility","package":"rollup","optional":true}],"imports":[{"note":"Default export; must use ESM import in Rollup config due to plugin ecosystem.","wrong":"const WindiCSS = require('rollup-plugin-windicss')","symbol":"WindiCSS","correct":"import WindiCSS from 'rollup-plugin-windicss'"},{"note":"Named export for configuring Windi CSS options.","wrong":"const { defineConfig } = require('rollup-plugin-windicss')","symbol":"defineConfig","correct":"import { defineConfig } from 'rollup-plugin-windicss'"},{"note":"Must import the virtual module in your entry file; the plugin transforms it.","wrong":"import 'windi.css'","symbol":"VirtualModule","correct":"import 'virtual:windi.css'"}],"quickstart":{"code":"// rollup.config.mjs\nimport WindiCSS from 'rollup-plugin-windicss';\nexport default {\n  input: 'src/main.js',\n  output: { dir: 'dist', format: 'esm' },\n  plugins: [WindiCSS()]\n};\n\n// src/main.js\nimport 'virtual:windi.css';\nconsole.log('Hello, Windi CSS!');","lang":"javascript","description":"Shows minimal Rollup config with the plugin and virtual CSS import in entry."},"warnings":[{"fix":"Use Rollup >=2.0.0; check for breaking changes in monorepo releases.","message":"The plugin is part of the vite-plugin-windicss monorepo; ensure compatibility with Rollup version (peer dep *).","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Migrate to Tailwind CSS v3 or UnoCSS; rollup-plugin-windicss still works for existing projects.","message":"Windi CSS project is deprecated in favor of Tailwind CSS v3. New projects should consider Tailwind CSS or UnoCSS.","severity":"deprecated","affected_versions":">=1.0.0"},{"fix":"Ensure the plugin is added to the rollup config before the import in your source.","message":"Virtual CSS module 'virtual:windi.css' must be imported after the plugin is added to config, or it won't be resolved.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Update Rollup to ^2.60.0 or higher.","message":"Version 1.9.0 dropped support for some older Rollup versions; require Rollup >=2.60.0.","severity":"breaking","affected_versions":">=1.9.0"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"Update to version >=1.8.11 or ensure a windi.config.js exists.","cause":"Plugin version 1.8.10 had a bug when config file was not found but required.","error":"The \"path\" argument must be of type string or an instance of URL. Received undefined"},{"fix":"Use import syntax and ensure rollup.config.mjs or \"type\": \"module\" in package.json.","cause":"Using require() with ESM-only package; rollup-plugin-windicss is ESM-only.","error":"SyntaxError: Cannot use import statement outside a module"},{"fix":"Only use public API exports; do not import from subpath \"rollup-plugin-windicss/utils\".","cause":"Accessing internal modules that are not exported from package.","error":"Module not found: Error: Package path ./utils is not exported"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}