Registry / web-framework / vite-plugin-css-modules

vite-plugin-css-modules

library0.0.1jsnpmunverified

A Vite plugin that enables CSS Modules on all stylesheets, not only those ending in `.module.css`. Version 0.0.1, early stage with no established release cadence. Differentiators: eliminates the `.module` filename convention for CSS Modules, allows treating any CSS/less file as a module. Supports precompilers (less built-in) and postcss-modules configuration. Requires Vite >2.0.0-0 and multiple peer dependencies. Currently minimal documentation and likely unstable.

web-framework devops

npm install vite-plugin-css-modules

github ↗package ↗

INSTALL

IMPORT

SIG · VITE-PLUGIN-CSS-MO

vite-plugin-css-modules

web-frameworkjavascriptv0.0.1

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.

vitePluginCssModules

✓ import vitePluginCssModules from 'vite-plugin-css-modules'

✗ const vitePluginCssModules = require('vite-plugin-css-modules')

Plugin exports a default function. CommonJS require may not work if package is ESM-only.

default

✓ import vitePluginCssModules from 'vite-plugin-css-modules'

✗ import { vitePluginCssModules } from 'vite-plugin-css-modules'

The package has no named exports; must use default import.

Plugin (type)

✓ import type { Plugin } from 'vite'; import vitePluginCssModules from 'vite-plugin-css-modules'

✗ import { Plugin } from 'vite-plugin-css-modules'

Plugin type is from Vite, not from this package. This package does not export any types.

Enables CSS Modules on all stylesheets in a Vite project by adding the plugin to vite.config.ts.

import vitePluginCssModules from 'vite-plugin-css-modules'; export default { plugins: [ vitePluginCssModules() ] };

Debug

Known issues

gotchaThe plugin treats all stylesheets as CSS Modules, which may break global styles not using .module convention.

fix

Ensure all style files are imported with class name references, or migrate to explicit .module files for module behavior.

affects: >=0.0.0

breakingPeer dependencies are strict: requires Vite >2.0.0-0, postcss ^8.3.6, less ^4.1.1, postcss-modules ^4.2.2. Incompatible versions may cause build failures.

fix

Install exact peer dependency versions as listed in package.json.

affects: >=0.0.0

gotchaBuilt-in less compiler uses nodeLess.render with syncImport:true and javascriptEnabled:true, which may be insecure if less files come from untrusted sources.

fix

Avoid processing untrusted less files or override precompiler with safer options.

affects: >=0.0.0

deprecatedPackage is at version 0.0.1 and has no changelog or release notes. Consider alternatives like postcss-modules directly or other Vite CSS modules plugins.

fix

Evaluate using 'vite-plugin-css-modules' (different) or roll your own postcss setup.

affects: >=0.0.0

Errors

Common errors & fixes

Error: Cannot find module 'vite-plugin-css-modules'

Package not installed or missing from node_modules.

fix

Run 'npm install vite-plugin-css-modules' or 'yarn add vite-plugin-css-modules'.

TypeError: vitePluginCssModules is not a function

Incorrect import: named import instead of default import.

fix

Use 'import vitePluginCssModules from 'vite-plugin-css-modules'' instead of 'import { vitePluginCssModules } ...'.

Error: PostCSS plugin postcss-modules requires PostCSS 8

PostCSS version mismatch; older PostCSS installed.

fix

Install postcss@^8.3.6 or later with 'npm install postcss@^8.3.6'.

Upgrade

Version history

0.0.1latest on npm

Audit

Dependencies

viterequiredpeer dependency; plugin runs in Vite build pipeline

@babel/parseroptionalused to parse style files for CSS Modules transformations

@babel/traverseoptionaltraverses AST for CSS Module logic

@babel/generatoroptionalgenerates code from AST

postcssrequiredcore CSS preprocessor

lessrequiredbuilt-in precompiler for less files

postcss-modulesrequiredimplements CSS Modules specification

Agent activity

9 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/wangzongming/vite-plugin-require ↗

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