Registry / web-framework / vite-plugin-stylex

vite-plugin-stylex

library0.13.0jsnpmunverified

Integrates StyleX CSS-in-JS library with Vite build tool. Current version 0.13.0 supports StyleX 0.9.3, Vite ^5.2.7. Active development with monthly releases. Differentiates by leveraging Vite's CSS pipeline for minification and post-processing, supporting LightningCSS, CSS layers, and automatic style generation. Requires manual Vite configuration unlike some auto-setup CSS-in-JS solutions.

web-framework devops

npm install vite-plugin-stylex

github ↗package ↗

INSTALL

IMPORT

SIG · VITE-PLUGIN-STYLEX

vite-plugin-stylex

web-frameworkjavascriptv0.13.0

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.

vitePluginStylex

✓ import vitePluginStylex from 'vite-plugin-stylex'

✗ import { vitePluginStylex } from 'vite-plugin-stylex'

Default export; named import will cause undefined.

UserConfig export

✓ import type { UserConfig } from 'vite'

TypeScript users should import Vite's UserConfig separately; this plugin does not re-export it.

CommonJS require

✓ const vitePluginStylex = require('vite-plugin-stylex').default

✗ const vitePluginStylex = require('vite-plugin-stylex')

ESM-only package; require() returns module with default export, so .default is needed.

Minimal Vite config with vite-plugin-stylex showing common options: CSS layers, StyleX imports, and module resolution for CommonJS compatibility.

import { defineConfig } from 'vite'; import vitePluginStylex from 'vite-plugin-stylex'; export default defineConfig({ plugins: [ vitePluginStylex({ useCSSLayers: true, stylexImports: ['@stylexjs/stylex'], unstable_moduleResolution: { type: 'commonJS', rootDir: import.meta.url, }, }), ], });

Debug

Known issues

breakingBREAKING CHANGE: Plugin now requires Vite 5.2.7 or higher

fix

Upgrade to Vite ^5.2.7 and plugin >=0.9.0.

affects: <0.9.0

breakingBREAKING CHANGE: Plugin now delegates CSS processing to Vite, requiring Vite's CSS pipeline

fix

Ensure Vite's CSS handling is not disabled; CSS minification and post-processing are now Vite-controlled.

affects: >=0.9.0

gotchaAlias path on Windows uses forward slashes

fix

Use @/_ or @src/_ instead of @\_ or @src\_ in path aliases.

affects: >=0.8.3

gotchaPlugin uses Vite's waitForRequestsIdle experimental API for development

fix

May cause delay in style generation; update Vite if API changes.

affects: >=0.9.0

deprecatedOptions like 'stylexImports' and 'unstable_moduleResolution' may change in future versions

fix

Monitor release notes for stable API replacements.

affects: >=0.9.0

Errors

Common errors & fixes

Error: Cannot find module '@stylexjs/stylex'

Missing peer dependency @stylexjs/stylex

fix

npm install @stylexjs/stylex

TypeError: vitePluginStylex is not a function

Importing as named export instead of default

fix

Use `import vitePluginStylex from 'vite-plugin-stylex'` (no braces)

[plugin:vite-plugin-stylex] Stylex plugin is not a function

Plugin used outside Vite's plugin array or misconfigured

fix

Ensure plugin is included in the `plugins` array: `plugins: [vitePluginStylex()]`

Error: Vite 5.2.7 or higher is required

Using an older version of Vite

fix

Upgrade to Vite ^5.2.7

Upgrade

Version history

0.13.0latest on npm

Audit

Dependencies

@stylexjs/stylexrequiredCore peer dependency for StyleX functionality

viterequiredPeer dependency; requires Vite ^5.2.7

Agent activity

20 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/HorusGoul/vite-plugin-stylex ↗

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