{"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,"search_vec":"'1.7.2':30 '2.11.12':21 '3':25 '8':27 'address':61 'altern':70 'automat':51 'babel/solid':54 'candid':38 'case':63 'class':43 'compat':65 'configur':52 'current':17 'develop':31 'differenti':40 'edg':62 'first':42 'first-class':41 'frequent':58 'hmr':11,49 'integr':45 'javascript':78 'jsx':12 'key':39 'less':76 'like':71 'newer':67 'offici':5,77 'ongo':35 'patch':60 'plugin':3,7,81,84,87 'provid':10 'refresh':48 'releas':37,56 'solid':4,47,74,88 'solid-refresh':46 'solid.js':9,29,44 'ssr':15 'stabl':18 'support':16,22 'transform':13,55 'typescript':89 'unplugin':73 'unplugin-solid':72 'v3.0.0':33 'version':19,24,69 'vite':2,6,23,68,79,80,86 'vite-plugin':85 'vite-plugin-solid':1 'vitej':82,83","created_at":"2026-04-25T11:24:25.277830+00:00","updated_at":"2026-04-25T11:24:25.277830+00:00","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,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":"","cli_version":null,"type":"library","homepage":"https://solidjs.com","github":"https://github.com/solidjs/vite-plugin-solid","docs":null,"changelog":null,"pypi":null,"npm":"https://www.npmjs.com/package/vite-plugin-solid","openapi_spec":null,"status_page":null,"smithery":null,"categories":["web-framework"],"base_url":null,"auth_type":null,"provenance":{"verified_status":null,"verified_at":null,"last_verified":"2026-06-17","next_check":"2026-07-24","install_tag":null}}