{"id":20684,"library":"vite-plugin-solid","title":"vite-plugin-solid","description":"Official Vite plugin for Solid.js, providing HMR, JSX transformation, and SSR support. Current stable version is 2.11.12, supporting Vite versions 3 through 8 and Solid.js 1.7.2+. Development on v3.0.0 is ongoing with release candidates. Key differentiators: first-class Solid.js integration, solid-refresh HMR, and automatic configuration of Babel/Solid transforms. Releases are frequent with patches addressing edge cases and compatibility with newer Vite versions. Alternatives like unplugin-solid are less official.","status":"active","version":"2.11.12","language":"javascript","source_language":"en","source_url":"https://github.com/solidjs/vite-plugin-solid","tags":["javascript","vite","vite plugin","vitejs","vitejs plugin","vite-plugin","solid","typescript"],"install":[{"cmd":"npm install vite-plugin-solid","lang":"bash","label":"npm"},{"cmd":"yarn add vite-plugin-solid","lang":"bash","label":"yarn"},{"cmd":"pnpm add vite-plugin-solid","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"core peer dependency for plugin integration","package":"vite","optional":false},{"reason":"required for Solid.js compilation and HMR","package":"solid-js","optional":false},{"reason":"peer dependency for testing setups","package":"@testing-library/jest-dom","optional":true}],"imports":[{"note":"Default export; named export 'default' also works.","wrong":"import { vitePluginSolid } from 'vite-plugin-solid'","symbol":"vitePluginSolid","correct":"import vitePluginSolid from 'vite-plugin-solid'"},{"note":"Alias for default export, commonly used in Vite configs.","wrong":"","symbol":"solidPlugin","correct":"import solidPlugin from 'vite-plugin-solid'"},{"note":"ESM-only plugin; CommonJS require not supported.","wrong":"const solid = require('vite-plugin-solid')","symbol":"solid","correct":"import solid from 'vite-plugin-solid'"}],"quickstart":{"code":"import { defineConfig } from 'vite';\nimport solidPlugin from 'vite-plugin-solid';\n\nexport default defineConfig({\n  plugins: [solidPlugin()],\n});","lang":"typescript","description":"Shows minimal Vite config with Solid plugin, enabling HMR and JSX transforms."},"warnings":[{"fix":"Upgrade to v2.11.10+ to avoid unconditional externalization.","message":"SSR resolve.external behavior changed in Vite 6+","severity":"breaking","affected_versions":">=2.11.10"},{"fix":"Pin to v2.x for stable projects: npm install vite-plugin-solid@^2","message":"vite-plugin-solid v3.x is in pre-release; breaking changes expected","severity":"deprecated","affected_versions":">=3.0.0-0"},{"fix":"Order plugins: solidPlugin() before other transforms.","message":"Plugin must be the first in plugins array","severity":"gotcha","affected_versions":"all"},{"fix":"Update to v2.11.11+ or v3 pre-release.","message":"Supports Vite 3–7 only; Vite 8 requires v2.11.11+ or v3","severity":"gotcha","affected_versions":"<=2.11.10"},{"fix":"Use ESM import syntax exclusively.","message":"Use of require() to import plugin","severity":"deprecated","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-04-25T00:00:00.000Z","next_check":"2026-07-24T00:00:00.000Z","problems":[{"fix":"Run 'npm install vite-plugin-solid'","cause":"Missing dependency; npm install not run","error":"Cannot find module 'vite-plugin-solid'"},{"fix":"Use 'import solidPlugin from 'vite-plugin-solid''","cause":"Wrong import style; used named import for default export","error":"TypeError: solidPlugin is not a function"},{"fix":"Ensure Solid components use .jsx or .tsx extension.","cause":"File extension not .jsx or .tsx","error":"[vite] Internal server error: [plugin:vite-plugin-solid] <file> is not a valid JSX file"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}