Registry / web-framework / vite-plugin-solid

vite-plugin-solid

library2.11.12jsnpmunverified

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.

web-framework

npm install vite-plugin-solid

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · VITE-PLUGIN-SOLID

vite-plugin-solid

web-frameworkjavascriptv2.11.12

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–226 runs

build_error

glibc

node 18–226 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

vitePluginSolid

✓ import vitePluginSolid from 'vite-plugin-solid'

✗ import { vitePluginSolid } from 'vite-plugin-solid'

Default export; named export 'default' also works.

solidPlugin

✓ import solidPlugin from 'vite-plugin-solid'

Alias for default export, commonly used in Vite configs.

solid

✓ import solid from 'vite-plugin-solid'

✗ const solid = require('vite-plugin-solid')

ESM-only plugin; CommonJS require not supported.

Shows minimal Vite config with Solid plugin, enabling HMR and JSX transforms.

import { defineConfig } from 'vite'; import solidPlugin from 'vite-plugin-solid'; export default defineConfig({ plugins: [solidPlugin()], });

Debug

Known issues

breakingSSR resolve.external behavior changed in Vite 6+

fix

Upgrade to v2.11.10+ to avoid unconditional externalization.

affects: >=2.11.10

deprecatedvite-plugin-solid v3.x is in pre-release; breaking changes expected

fix

Pin to v2.x for stable projects: npm install vite-plugin-solid@^2

affects: >=3.0.0-0

gotchaPlugin must be the first in plugins array

fix

Order plugins: solidPlugin() before other transforms.

affects: all

gotchaSupports Vite 3–7 only; Vite 8 requires v2.11.11+ or v3

fix

Update to v2.11.11+ or v3 pre-release.

affects: <=2.11.10

deprecatedUse of require() to import plugin

fix

Use ESM import syntax exclusively.

affects: all

Errors

Common errors & fixes

Cannot find module 'vite-plugin-solid'

Missing dependency; npm install not run

fix

Run 'npm install vite-plugin-solid'

TypeError: solidPlugin is not a function

Wrong import style; used named import for default export

fix

Use 'import solidPlugin from 'vite-plugin-solid''

[vite] Internal server error: [plugin:vite-plugin-solid] <file> is not a valid JSX file

File extension not .jsx or .tsx

fix

Ensure Solid components use .jsx or .tsx extension.

Upgrade

Version history

2.11.12latest on npm

Audit

Dependencies

viterequiredcore peer dependency for plugin integration

solid-jsrequiredrequired for Solid.js compilation and HMR

@testing-library/jest-domoptionalpeer dependency for testing setups

Agent activity

19 hits · last 30 days

node

Bingbot

OpenAI (training)

Resources

githubhttps://github.com/solidjs/vite-plugin-solid ↗

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

homepagehttps://solidjs.com ↗