Registry / web-framework / vite-plugin-windicss

vite-plugin-windicss

library1.9.4jsnpmunverified

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.

web-framework

npm install vite-plugin-windicss

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · VITE-PLUGIN-WINDIC

vite-plugin-windicss

web-frameworkjavascriptv1.9.4

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–223 runs

build_error

glibc

node 18–223 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

vitePluginWindicss

✓ import vitePluginWindicss from 'vite-plugin-windicss'

✗ import { vitePluginWindicss } from 'vite-plugin-windicss'

Default export only; named import will fail.

defineConfig

✓ import { defineConfig } from 'vite-plugin-windicss'

Named export for configuring Windi CSS options.

WindiCssOptions

✓ import type { WindiCssOptions } from 'vite-plugin-windicss'

✗ import { WindiCssOptions } from 'vite-plugin-windicss'

Type import only; not a runtime value.

Adds Windi CSS to a Vite project. Place in vite.config.ts and optionally configure via windi.config.ts.

// vite.config.ts import { defineConfig } from 'vite' import vitePluginWindicss from 'vite-plugin-windicss' export default defineConfig({ plugins: [ vitePluginWindicss(), ], }) // Optionally, create windi.config.ts // export default { attributify: true }

Debug

Known issues

deprecatedWindi CSS is sunsetting; consider using Tailwind CSS v4 or UnoCSS instead.

fix

Migrate to an alternative like UnoCSS (unocss) for similar on-demand utility-first CSS.

affects: >=1.0.0

breakingVersion 1.x requires Vite peer dependency major version matching; 1.9+ supports Vite 2-6 but not Vite 1.

fix

Upgrade to v1.9.4 or later to support modern Vite versions.

affects: >=1.0.0 <1.9.0

gotchaDo NOT use named import for the plugin: import { vitePluginWindicss } from 'vite-plugin-windicss' will fail. Use default import.

fix

Use import vitePluginWindicss from 'vite-plugin-windicss' (default import).

affects: >=1.0.0

gotchaWhen using TypeScript, ensure 'types' are exported in package.json exports in v1.9.1+; earlier versions may have missing type declarations.

fix

Upgrade to v1.9.1 or later to get type declarations.

affects: <1.9.1

breakingVite 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.

fix

Upgrade to at least v1.9.3 for Vite 5 or v1.9.4 for Vite 6.

affects: <1.8.9

Errors

Common errors & fixes

Cannot find module 'vite-plugin-windicss' or its corresponding type declarations.

Missing type exports in older versions or incorrect import syntax.

fix

Update to v1.9.1+ and use default import: import vitePluginWindicss from 'vite-plugin-windicss'

Error: The "path" argument must be of type string or an instance of URL. Received undefined

Bug in v1.8.10 related to internal file resolution.

fix

Upgrade to v1.8.11 or later.

Module not found: Can't resolve 'windicss'

Missed installing windicss as a peer dependency.

fix

Run npm install windicss

Upgrade

Version history

1.9.4latest on npm

Audit

Dependencies

viterequiredpeer dependency required for the plugin to function

Agent activity

9 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/antfu/vite-plugin-windicss ↗

packagehttps://www.npmjs.com/package/vite-plugin-windicss ↗

homepagehttps://windicss.org ↗