{"id":22931,"library":"vite-plugin-windicss","title":"vite-plugin-windicss","description":"Vite plugin for Windi CSS, a utility-first CSS framework that is fully compatible with Tailwind CSS v2 but 20-100x faster due to on-demand generation and HMR. Current stable version is 1.9.4, updated to support Vite 6. It offers attributify mode, variant groups, alias config, and design-in-devtools features. The project is actively maintained but Windi CSS is sunsetting; new projects are recommended to seek alternatives like Tailwind CSS v4 or UnoCSS. Ships TypeScript types. Peer dependency on Vite.","status":"deprecated","version":"1.9.4","language":"javascript","source_language":"en","source_url":"https://github.com/antfu/vite-plugin-windicss","tags":["javascript","vite","vite-plugin","windicss","tailwindcss","typescript"],"install":[{"cmd":"npm install vite-plugin-windicss","lang":"bash","label":"npm"},{"cmd":"yarn add vite-plugin-windicss","lang":"bash","label":"yarn"},{"cmd":"pnpm add vite-plugin-windicss","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"peer dependency required for the plugin to function","package":"vite","optional":false}],"imports":[{"note":"Default export only; named import will fail.","wrong":"import { vitePluginWindicss } from 'vite-plugin-windicss'","symbol":"vitePluginWindicss","correct":"import vitePluginWindicss from 'vite-plugin-windicss'"},{"note":"Named export for configuring Windi CSS options.","wrong":null,"symbol":"defineConfig","correct":"import { defineConfig } from 'vite-plugin-windicss'"},{"note":"Type import only; not a runtime value.","wrong":"import { WindiCssOptions } from 'vite-plugin-windicss'","symbol":"WindiCssOptions","correct":"import type { WindiCssOptions } from 'vite-plugin-windicss'"}],"quickstart":{"code":"// vite.config.ts\nimport { defineConfig } from 'vite'\nimport vitePluginWindicss from 'vite-plugin-windicss'\n\nexport default defineConfig({\n  plugins: [\n    vitePluginWindicss(),\n  ],\n})\n\n// Optionally, create windi.config.ts\n// export default { attributify: true }","lang":"typescript","description":"Adds Windi CSS to a Vite project. Place in vite.config.ts and optionally configure via windi.config.ts."},"warnings":[{"fix":"Migrate to an alternative like UnoCSS (unocss) for similar on-demand utility-first CSS.","message":"Windi CSS is sunsetting; consider using Tailwind CSS v4 or UnoCSS instead.","severity":"deprecated","affected_versions":">=1.0.0"},{"fix":"Upgrade to v1.9.4 or later to support modern Vite versions.","message":"Version 1.x requires Vite peer dependency major version matching; 1.9+ supports Vite 2-6 but not Vite 1.","severity":"breaking","affected_versions":">=1.0.0 <1.9.0"},{"fix":"Use import vitePluginWindicss from 'vite-plugin-windicss' (default import).","message":"Do NOT use named import for the plugin: import { vitePluginWindicss } from 'vite-plugin-windicss' will fail. Use default import.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Upgrade to v1.9.1 or later to get type declarations.","message":"When using TypeScript, ensure 'types' are exported in package.json exports in v1.9.1+; earlier versions may have missing type declarations.","severity":"gotcha","affected_versions":"<1.9.1"},{"fix":"Upgrade to at least v1.9.3 for Vite 5 or v1.9.4 for Vite 6.","message":"Vite 4+ changed HMR handling; v1.8.9 added Vite 4 support, v1.9.3 fixed HMR for Vite 5, and v1.9.4 added Vite 6 support. Older versions may break HMR.","severity":"breaking","affected_versions":"<1.8.9"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"Update to v1.9.1+ and use default import: import vitePluginWindicss from 'vite-plugin-windicss'","cause":"Missing type exports in older versions or incorrect import syntax.","error":"Cannot find module 'vite-plugin-windicss' or its corresponding type declarations."},{"fix":"Upgrade to v1.8.11 or later.","cause":"Bug in v1.8.10 related to internal file resolution.","error":"Error: The \"path\" argument must be of type string or an instance of URL. Received undefined"},{"fix":"Run npm install windicss","cause":"Missed installing windicss as a peer dependency.","error":"Module not found: Can't resolve 'windicss'"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}