# solidjs/solid architecture

> Architecture diagram of the GitHub repository solidjs/solid, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/solidjs/solid
- Repository: https://github.com/solidjs/solid

## Overview

Solid is a declarative UI library. An application author defines reactive state and components, JSX is compiled into DOM-oriented operations, and the runtime mounts components into browser DOM nodes. Signal changes propagate through fine-grained computations to update only dependent nodes. The same component model supports stores, asynchronous resources and Suspense, server rendering with hydration, custom elements, and universal renderers. Some adapter implementations are represented from documented package structure; sampled excerpts do not establish every internal call edge.

Main entry points: [`packages/solid/src/reactive/signal.ts`](https://github.com/solidjs/solid/blob/main/packages/solid/src/reactive/signal.ts) (Signal Runtime), [`packages/solid/src/render/component.ts`](https://github.com/solidjs/solid/blob/main/packages/solid/src/render/component.ts) (Component Runtime), [`packages/solid/web/src/client.ts`](https://github.com/solidjs/solid/blob/main/packages/solid/web/src/client.ts) (DOM Renderer), [`packages/solid/src/render/index.ts`](https://github.com/solidjs/solid/blob/main/packages/solid/src/render/index.ts) (Render API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_authoring["Authoring"]
  node_jsx_compiler["JSX Compiler<br/>[index.js]"]
end

subgraph group_runtime["Reactive Runtime"]
  node_component_runtime["Component Runtime<br/>[component.ts]"]
  node_signal_runtime["Signal Runtime<br/>[signal.ts]"]
  node_scheduler["Update Scheduler<br/>[scheduler.ts]"]
  node_store_runtime["Store Runtime<br/>[store.ts]"]
  node_resource_runtime["Resource Runtime<br/>[signal.ts]"]
end

subgraph group_rendering["Rendering"]
  node_dom_renderer["DOM Renderer<br/>[client.ts]"]
  node_render_api["Render API<br/>[index.ts]"]
  node_ssr_renderer["SSR Renderer<br/>[rendering.ts]"]
  node_hydration["Hydration Runtime<br/>[hydration.ts]"]
end

subgraph group_platform["Platform Adapters"]
  node_server_adapter["Server Adapter<br/>[server.ts]"]
  node_universal_renderer["Universal Renderer<br/>[universal.ts]"]
end

subgraph group_extensions["Extensions"]
  node_store_api["Store API<br/>[index.ts]"]
  node_custom_elements["Custom Elements<br/>[index.ts]"]
end

node_app_author(("Application Author"))
node_browser_dom["Browser DOM"]
node_server_app(("Server Application"))

node_app_author -->|"writes JSX"| node_jsx_compiler
node_app_author -->|"defines components"| node_component_runtime
node_jsx_compiler -->|"generates operations"| node_dom_renderer
node_component_runtime -->|"creates computations"| node_signal_runtime
node_signal_runtime -->|"queues updates"| node_scheduler
node_signal_runtime -->|"notifies bindings"| node_dom_renderer
node_app_author -->|"declares stores"| node_store_api
node_store_api -->|"updates state"| node_store_runtime
node_store_runtime -->|"tracks changes"| node_signal_runtime
node_app_author -->|"loads resources"| node_resource_runtime
node_resource_runtime -->|"publishes state"| node_signal_runtime
node_app_author -->|"mounts app"| node_render_api
node_render_api -->|"invokes components"| node_component_runtime
node_render_api -->|"renders nodes"| node_dom_renderer
node_dom_renderer -->|"updates DOM"| node_browser_dom
node_server_app -->|"requests SSR"| node_server_adapter
node_server_adapter -->|"renders HTML"| node_ssr_renderer
node_ssr_renderer -->|"serializes hydration"| node_hydration
node_hydration -.->|"hydrates nodes"| node_browser_dom
node_app_author -.->|"defines elements"| node_custom_elements
node_custom_elements -->|"wraps components"| node_component_runtime
node_custom_elements -->|"inserts output"| node_dom_renderer
node_app_author -.->|"selects renderer"| node_universal_renderer
node_universal_renderer -->|"renders components"| node_component_runtime

click node_jsx_compiler "https://github.com/solidjs/solid/blob/main/packages/babel-preset-solid/index.js"
click node_component_runtime "https://github.com/solidjs/solid/blob/main/packages/solid/src/render/component.ts"
click node_signal_runtime "https://github.com/solidjs/solid/blob/main/packages/solid/src/reactive/signal.ts"
click node_scheduler "https://github.com/solidjs/solid/blob/main/packages/solid/src/reactive/scheduler.ts"
click node_store_runtime "https://github.com/solidjs/solid/blob/main/packages/solid/store/src/store.ts"
click node_store_api "https://github.com/solidjs/solid/blob/main/packages/solid/store/src/index.ts"
click node_resource_runtime "https://github.com/solidjs/solid/blob/main/packages/solid/src/reactive/signal.ts"
click node_dom_renderer "https://github.com/solidjs/solid/blob/main/packages/solid/web/src/client.ts"
click node_render_api "https://github.com/solidjs/solid/blob/main/packages/solid/src/render/index.ts"
click node_ssr_renderer "https://github.com/solidjs/solid/blob/main/packages/solid/src/server/rendering.ts"
click node_server_adapter "https://github.com/solidjs/solid/blob/main/packages/solid/web/server/server.ts"
click node_hydration "https://github.com/solidjs/solid/blob/main/packages/solid/src/render/hydration.ts"
click node_custom_elements "https://github.com/solidjs/solid/blob/main/packages/solid-element/src/index.ts"
click node_universal_renderer "https://github.com/solidjs/solid/blob/main/packages/solid/universal/src/universal.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_jsx_compiler,node_browser_dom toneBlue
class node_component_runtime,node_signal_runtime,node_scheduler,node_store_runtime,node_resource_runtime toneAmber
class node_dom_renderer,node_render_api,node_ssr_renderer,node_hydration,node_server_app toneMint
class node_server_adapter,node_universal_renderer toneRose
class node_store_api,node_custom_elements,node_app_author toneIndigo
```

## Components

### Authoring

- [JSX Compiler](https://github.com/solidjs/solid/blob/main/packages/babel-preset-solid/index.js): `packages/babel-preset-solid/index.js`

### Reactive Runtime

- [Component Runtime](https://github.com/solidjs/solid/blob/main/packages/solid/src/render/component.ts): `packages/solid/src/render/component.ts`
- [Signal Runtime](https://github.com/solidjs/solid/blob/main/packages/solid/src/reactive/signal.ts): `packages/solid/src/reactive/signal.ts`
- [Update Scheduler](https://github.com/solidjs/solid/blob/main/packages/solid/src/reactive/scheduler.ts): `packages/solid/src/reactive/scheduler.ts`
- [Store Runtime](https://github.com/solidjs/solid/blob/main/packages/solid/store/src/store.ts): `packages/solid/store/src/store.ts`
- [Resource Runtime](https://github.com/solidjs/solid/blob/main/packages/solid/src/reactive/signal.ts): `packages/solid/src/reactive/signal.ts`

### Rendering

- [DOM Renderer](https://github.com/solidjs/solid/blob/main/packages/solid/web/src/client.ts): `packages/solid/web/src/client.ts`
- [Render API](https://github.com/solidjs/solid/blob/main/packages/solid/src/render/index.ts): `packages/solid/src/render/index.ts`
- [SSR Renderer](https://github.com/solidjs/solid/blob/main/packages/solid/src/server/rendering.ts): `packages/solid/src/server/rendering.ts`
- [Hydration Runtime](https://github.com/solidjs/solid/blob/main/packages/solid/src/render/hydration.ts): `packages/solid/src/render/hydration.ts`

### Platform Adapters

- [Server Adapter](https://github.com/solidjs/solid/blob/main/packages/solid/web/server/server.ts): `packages/solid/web/server/server.ts`
- [Universal Renderer](https://github.com/solidjs/solid/blob/main/packages/solid/universal/src/universal.ts): `packages/solid/universal/src/universal.ts`

### Extensions

- [Store API](https://github.com/solidjs/solid/blob/main/packages/solid/store/src/index.ts): `packages/solid/store/src/index.ts`
- [Custom Elements](https://github.com/solidjs/solid/blob/main/packages/solid-element/src/index.ts): `packages/solid-element/src/index.ts`

### Other components

- **Application Author**
- **Browser DOM**
- **Server Application**

## Connections

- Application Author → JSX Compiler: writes JSX
- Application Author → Component Runtime: defines components
- JSX Compiler → DOM Renderer: generates operations
- Component Runtime → Signal Runtime: creates computations
- Signal Runtime → Update Scheduler: queues updates
- Signal Runtime → DOM Renderer: notifies bindings
- Application Author → Store API: declares stores
- Store API → Store Runtime: updates state
- Store Runtime → Signal Runtime: tracks changes
- Application Author → Resource Runtime: loads resources
- Resource Runtime → Signal Runtime: publishes state
- Application Author → Render API: mounts app
- Render API → Component Runtime: invokes components
- Render API → DOM Renderer: renders nodes
- DOM Renderer → Browser DOM: updates DOM
- Server Application → Server Adapter: requests SSR
- Server Adapter → SSR Renderer: renders HTML
- SSR Renderer → Hydration Runtime: serializes hydration
- Hydration Runtime → Browser DOM: hydrates nodes
- Application Author → Custom Elements: defines elements
- Custom Elements → Component Runtime: wraps components
- Custom Elements → DOM Renderer: inserts output
- Application Author → Universal Renderer: selects renderer
- Universal Renderer → Component Runtime: renders components
