{"id":22629,"library":"vite-plugin-css-modules","title":"vite-plugin-css-modules","description":"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.","status":"active","version":"0.0.1","language":"javascript","source_language":"en","source_url":"https://github.com/wangzongming/vite-plugin-require","tags":["javascript","vite","vite-plugin","vite-plugin-css-modules"],"install":[{"cmd":"npm install vite-plugin-css-modules","lang":"bash","label":"npm"},{"cmd":"yarn add vite-plugin-css-modules","lang":"bash","label":"yarn"},{"cmd":"pnpm add vite-plugin-css-modules","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"peer dependency; plugin runs in Vite build pipeline","package":"vite","optional":false},{"reason":"used to parse style files for CSS Modules transformations","package":"@babel/parser","optional":true},{"reason":"traverses AST for CSS Module logic","package":"@babel/traverse","optional":true},{"reason":"generates code from AST","package":"@babel/generator","optional":true},{"reason":"core CSS preprocessor","package":"postcss","optional":false},{"reason":"built-in precompiler for less files","package":"less","optional":false},{"reason":"implements CSS Modules specification","package":"postcss-modules","optional":false}],"imports":[{"note":"Plugin exports a default function. CommonJS require may not work if package is ESM-only.","wrong":"const vitePluginCssModules = require('vite-plugin-css-modules')","symbol":"vitePluginCssModules","correct":"import vitePluginCssModules from 'vite-plugin-css-modules'"},{"note":"The package has no named exports; must use default import.","wrong":"import { vitePluginCssModules } from 'vite-plugin-css-modules'","symbol":"default","correct":"import vitePluginCssModules from 'vite-plugin-css-modules'"},{"note":"Plugin type is from Vite, not from this package. This package does not export any types.","wrong":"import { Plugin } from 'vite-plugin-css-modules'","symbol":"Plugin (type)","correct":"import type { Plugin } from 'vite'; import vitePluginCssModules from 'vite-plugin-css-modules'"}],"quickstart":{"code":"import vitePluginCssModules from 'vite-plugin-css-modules';\n\nexport default {\n  plugins: [\n    vitePluginCssModules()\n  ]\n};","lang":"typescript","description":"Enables CSS Modules on all stylesheets in a Vite project by adding the plugin to vite.config.ts."},"warnings":[{"fix":"Ensure all style files are imported with class name references, or migrate to explicit .module files for module behavior.","message":"The plugin treats all stylesheets as CSS Modules, which may break global styles not using .module convention.","severity":"gotcha","affected_versions":">=0.0.0"},{"fix":"Install exact peer dependency versions as listed in package.json.","message":"Peer 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.","severity":"breaking","affected_versions":">=0.0.0"},{"fix":"Avoid processing untrusted less files or override precompiler with safer options.","message":"Built-in less compiler uses nodeLess.render with syncImport:true and javascriptEnabled:true, which may be insecure if less files come from untrusted sources.","severity":"gotcha","affected_versions":">=0.0.0"},{"fix":"Evaluate using 'vite-plugin-css-modules' (different) or roll your own postcss setup.","message":"Package 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.","severity":"deprecated","affected_versions":">=0.0.0"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"Run 'npm install vite-plugin-css-modules' or 'yarn add vite-plugin-css-modules'.","cause":"Package not installed or missing from node_modules.","error":"Error: Cannot find module 'vite-plugin-css-modules'"},{"fix":"Use 'import vitePluginCssModules from 'vite-plugin-css-modules'' instead of 'import { vitePluginCssModules } ...'.","cause":"Incorrect import: named import instead of default import.","error":"TypeError: vitePluginCssModules is not a function"},{"fix":"Install postcss@^8.3.6 or later with 'npm install postcss@^8.3.6'.","cause":"PostCSS version mismatch; older PostCSS installed.","error":"Error: PostCSS plugin postcss-modules requires PostCSS 8"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}