Build interfaces that re-render only the specific parts of the screen when state changes
Solid manipulates actual DOM nodes directly, bypassing the virtual DOM to eliminate unnecessary re-rendering. It is a JavaScript library that uses declarative syntax to build UIs but converts templates into actual DOM operations at the compile stage for efficiency. When state changes, only the code depending on that value executes, making reactivity fast and predictable even in complex apps.
Expression-level reactivity
Component functions execute only once when mounted, after which only specific expression updates occur rather than full re-renders. For example, if a counter value changes, only the button text using that value is updated, while the rest of the DOM structure remains intact. These fine-grained updates are batched and processed at the microtask level, and you can call flush() to reflect changes immediately when synchronization is required. Read operations are reflected in the next microtask, but effects are separated into a tracking phase and a side-effect application phase, providing a clear flow.
Built-in state management and async handling
State management is performed using primitives like createSignal, createMemo, and createStore without external state management libraries. Dependency tracking is automatic, so you are subscribed to a reactive state the moment you read it. Async handling is supported as a first-class feature, allowing any computation to return a Promise or AsyncIterable. Loading states and errors are handled naturally through <Loading> and <Errored> boundary elements, and primitives like createOptimistic are provided for optimistic UIs.
Installation and initial setup
To add Solid to an existing Vite project, install solid-js and @solidjs/web, and add vite and @solidjs/vite-plugin as development dependencies. Register the Solid plugin in vite.config.ts and set jsxImportSource to @solidjs/web in your TypeScript configuration. If migrating from Solid 1.x, you should refer to the migration guide, as 1.x versions are maintained in a separate branch.
Performance and ecosystem
Solid shows runtime costs close to optimized vanilla JavaScript in the JS Framework Benchmark. Its small size and full tree-shaking support enable fast performance on the server. It uses TypeScript and JSX by default and integrates well with the Vite ecosystem. It is also compatible with web components, and you can write custom renderers targeting platforms other than the DOM using @solidjs/universal. Browser support covers the latest Firefox, Safari, Chrome, and Edge desktop and mobile versions from the last two years, while server environments support Node LTS, the latest Deno, and the Cloudflare Worker runtime.
Pre-adoption considerations
Solid 2.0 has a different public API than 1.x, so generating code based on existing 1.x examples may result in errors. When using AI assistants, you must first read the SKILL.md and CHEATSHEET.md files included in the solid-js npm package to generate accurate 2.0 code. This repository is a PNPM workspace monorepo where the core runtime and compiler share version control. DOM-related issues are handled in this repository, and runtime packages like @solidjs/web are managed alongside the compiler. It is advisable to check the suitability of Vite integration based on your project scale or your team's existing stack.