# sveltejs/svelte architecture

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

- Interactive diagram: https://gitdiagram.com/sveltejs/svelte
- Repository: https://github.com/sveltejs/svelte

## Overview

Svelte turns declarative components into JavaScript that updates the DOM. The principal workflow is component authoring, compilation, generated output, and browser rendering; parsing, analysis, and target-specific transformation are distinct compiler stages. The repository also contains preprocessing, migration, CSS handling, server rendering, legacy compatibility, and reactive utilities. The README documents the overall compile-to-DOM flow, while the excerpts show selected compiler and client-runtime relationships; links for unsampled stages and subsystems are therefore omitted or marked unverified.

Main entry points: [`packages/svelte/src/internal/client/runtime.js`](https://github.com/sveltejs/svelte/blob/main/packages/svelte/src/internal/client/runtime.js) (Client Runtime), [`packages/svelte/src/compiler/index.js`](https://github.com/sveltejs/svelte/blob/main/packages/svelte/src/compiler/index.js) (Compiler API), [`packages/svelte/src/compiler/phases/2-analyze/index.js`](https://github.com/sveltejs/svelte/blob/main/packages/svelte/src/compiler/phases/2-analyze/index.js) (Semantic Analysis), [`packages/svelte/src/compiler/phases/3-transform/client/transform-client.js`](https://github.com/sveltejs/svelte/blob/main/packages/svelte/src/compiler/phases/3-transform/client/transform-client.js) (Client Transform)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_compiler["Compiler"]
  node_compiler_api["Compiler API<br/>[index.js]"]
  node_parser["Component Parser<br/>[index.js]"]
  node_analysis["Semantic Analysis<br/>[index.js]"]
  node_ast_model["AST And Scope<br/>[nodes.js]"]
  node_client_transform["Client Transform"]
  node_server_transform["Server Transform"]
  node_css_transform["CSS Transform<br/>[index.js]"]
  node_preprocess["Preprocessing<br/>[index.js]"]
  node_migration["Migration<br/>[index.js]"]
end

subgraph group_runtime["Runtime"]
  node_client_api["Client API<br/>[index-client.js]"]
  node_client_runtime["Client Runtime<br/>[runtime.js]"]
  node_reactivity["Reactivity Engine<br/>[batch.js]"]
  node_dom_events["DOM Events<br/>[events.js]"]
  node_dom_operations["DOM Operations<br/>[operations.js]"]
  node_component_context["Component Context<br/>[context.js]"]
  node_server_runtime["Server Rendering<br/>[render-context.js]"]
end

subgraph group_compat["Compatibility"]
  node_legacy_api["Legacy Components<br/>[legacy-client.js]"]
end

subgraph group_utilities["Reactive Utilities"]
  node_stores["Stores<br/>[index-client.js]"]
  node_reactive_helpers["Reactive Helpers<br/>[media-query.js]"]
  node_motion["Motion And Transitions<br/>[spring.js]"]
end

node_author(("Component Author"))
node_generated_js["Generated JavaScript"]
node_browser(("Browser DOM"))

node_author -->|"compiles components"| node_compiler_api
node_compiler_api -->|"generates JavaScript"| node_generated_js
node_generated_js -->|"updates DOM"| node_browser
node_compiler_api -.->|"parses input"| node_parser
node_parser -.->|"analyzes structure"| node_analysis
node_analysis -.->|"transforms client"| node_client_transform
node_analysis -.->|"transforms server"| node_server_transform
node_client_transform -.->|"emits client code"| node_generated_js
node_server_transform -.->|"emits server code"| node_generated_js
node_client_transform -->|"renders styles"| node_css_transform
node_client_api -->|"uses runtime"| node_client_runtime
node_client_runtime -->|"uses context"| node_component_context
node_client_runtime -->|"uses batching"| node_reactivity
node_legacy_api -->|"reads runtime state"| node_client_runtime
node_legacy_api -->|"mounts components"| node_dom_operations
node_stores -->|"uses runtime"| node_client_runtime
node_reactive_helpers -->|"observes media"| node_browser

click node_compiler_api "https://github.com/sveltejs/svelte/blob/main/packages/svelte/src/compiler/index.js"
click node_parser "https://github.com/sveltejs/svelte/blob/main/packages/svelte/src/compiler/phases/1-parse/index.js"
click node_analysis "https://github.com/sveltejs/svelte/blob/main/packages/svelte/src/compiler/phases/2-analyze/index.js"
click node_ast_model "https://github.com/sveltejs/svelte/blob/main/packages/svelte/src/compiler/phases/nodes.js"
click node_client_transform "https://github.com/sveltejs/svelte/blob/main/packages/svelte/src/compiler/phases/3-transform/client/transform-client.js"
click node_server_transform "https://github.com/sveltejs/svelte/blob/main/packages/svelte/src/compiler/phases/3-transform/server/transform-server.js"
click node_css_transform "https://github.com/sveltejs/svelte/blob/main/packages/svelte/src/compiler/phases/3-transform/css/index.js"
click node_preprocess "https://github.com/sveltejs/svelte/blob/main/packages/svelte/src/compiler/preprocess/index.js"
click node_migration "https://github.com/sveltejs/svelte/blob/main/packages/svelte/src/compiler/migrate/index.js"
click node_client_api "https://github.com/sveltejs/svelte/blob/main/packages/svelte/src/index-client.js"
click node_client_runtime "https://github.com/sveltejs/svelte/blob/main/packages/svelte/src/internal/client/runtime.js"
click node_reactivity "https://github.com/sveltejs/svelte/blob/main/packages/svelte/src/internal/client/reactivity/batch.js"
click node_dom_events "https://github.com/sveltejs/svelte/blob/main/packages/svelte/src/internal/client/dom/elements/events.js"
click node_dom_operations "https://github.com/sveltejs/svelte/blob/main/packages/svelte/src/internal/client/dom/operations.js"
click node_component_context "https://github.com/sveltejs/svelte/blob/main/packages/svelte/src/internal/client/context.js"
click node_server_runtime "https://github.com/sveltejs/svelte/blob/main/packages/svelte/src/internal/server/render-context.js"
click node_legacy_api "https://github.com/sveltejs/svelte/blob/main/packages/svelte/src/legacy/legacy-client.js"
click node_stores "https://github.com/sveltejs/svelte/blob/main/packages/svelte/src/store/index-client.js"
click node_reactive_helpers "https://github.com/sveltejs/svelte/blob/main/packages/svelte/src/reactivity/media-query.js"
click node_motion "https://github.com/sveltejs/svelte/blob/main/packages/svelte/src/motion/spring.js"

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_compiler_api,node_parser,node_analysis,node_ast_model,node_client_transform,node_server_transform,node_css_transform,node_preprocess,node_migration,node_browser toneBlue
class node_client_api,node_client_runtime,node_reactivity,node_dom_events,node_dom_operations,node_component_context,node_server_runtime toneAmber
class node_legacy_api toneMint
class node_stores,node_reactive_helpers,node_motion toneRose
class node_author,node_generated_js toneIndigo
```

## Components

### Compiler

- [Compiler API](https://github.com/sveltejs/svelte/blob/main/packages/svelte/src/compiler/index.js): `packages/svelte/src/compiler/index.js`
- [Component Parser](https://github.com/sveltejs/svelte/blob/main/packages/svelte/src/compiler/phases/1-parse/index.js): `packages/svelte/src/compiler/phases/1-parse/index.js`
- [Semantic Analysis](https://github.com/sveltejs/svelte/blob/main/packages/svelte/src/compiler/phases/2-analyze/index.js): `packages/svelte/src/compiler/phases/2-analyze/index.js`
- [AST And Scope](https://github.com/sveltejs/svelte/blob/main/packages/svelte/src/compiler/phases/nodes.js): `packages/svelte/src/compiler/phases/nodes.js`
- [Client Transform](https://github.com/sveltejs/svelte/blob/main/packages/svelte/src/compiler/phases/3-transform/client/transform-client.js): `packages/svelte/src/compiler/phases/3-transform/client/transform-client.js`
- [Server Transform](https://github.com/sveltejs/svelte/blob/main/packages/svelte/src/compiler/phases/3-transform/server/transform-server.js): `packages/svelte/src/compiler/phases/3-transform/server/transform-server.js`
- [CSS Transform](https://github.com/sveltejs/svelte/blob/main/packages/svelte/src/compiler/phases/3-transform/css/index.js): `packages/svelte/src/compiler/phases/3-transform/css/index.js`
- [Preprocessing](https://github.com/sveltejs/svelte/blob/main/packages/svelte/src/compiler/preprocess/index.js): `packages/svelte/src/compiler/preprocess/index.js`
- [Migration](https://github.com/sveltejs/svelte/blob/main/packages/svelte/src/compiler/migrate/index.js): `packages/svelte/src/compiler/migrate/index.js`

### Runtime

- [Client API](https://github.com/sveltejs/svelte/blob/main/packages/svelte/src/index-client.js): `packages/svelte/src/index-client.js`
- [Client Runtime](https://github.com/sveltejs/svelte/blob/main/packages/svelte/src/internal/client/runtime.js): `packages/svelte/src/internal/client/runtime.js`
- [Reactivity Engine](https://github.com/sveltejs/svelte/blob/main/packages/svelte/src/internal/client/reactivity/batch.js): `packages/svelte/src/internal/client/reactivity/batch.js`
- [DOM Events](https://github.com/sveltejs/svelte/blob/main/packages/svelte/src/internal/client/dom/elements/events.js): `packages/svelte/src/internal/client/dom/elements/events.js`
- [DOM Operations](https://github.com/sveltejs/svelte/blob/main/packages/svelte/src/internal/client/dom/operations.js): `packages/svelte/src/internal/client/dom/operations.js`
- [Component Context](https://github.com/sveltejs/svelte/blob/main/packages/svelte/src/internal/client/context.js): `packages/svelte/src/internal/client/context.js`
- [Server Rendering](https://github.com/sveltejs/svelte/blob/main/packages/svelte/src/internal/server/render-context.js): `packages/svelte/src/internal/server/render-context.js`

### Compatibility

- [Legacy Components](https://github.com/sveltejs/svelte/blob/main/packages/svelte/src/legacy/legacy-client.js): `packages/svelte/src/legacy/legacy-client.js`

### Reactive Utilities

- [Stores](https://github.com/sveltejs/svelte/blob/main/packages/svelte/src/store/index-client.js): `packages/svelte/src/store/index-client.js`
- [Reactive Helpers](https://github.com/sveltejs/svelte/blob/main/packages/svelte/src/reactivity/media-query.js): `packages/svelte/src/reactivity/media-query.js`
- [Motion And Transitions](https://github.com/sveltejs/svelte/blob/main/packages/svelte/src/motion/spring.js): `packages/svelte/src/motion/spring.js`

### Other components

- **Component Author**
- **Generated JavaScript**
- **Browser DOM**

## Connections

- Component Author → Compiler API: compiles components (evidence: `README.md`)
- Compiler API → Generated JavaScript: generates JavaScript (evidence: `README.md`)
- Generated JavaScript → Browser DOM: updates DOM (evidence: `README.md`)
- Compiler API → Component Parser: parses input
- Component Parser → Semantic Analysis: analyzes structure
- Semantic Analysis → Client Transform: transforms client
- Semantic Analysis → Server Transform: transforms server
- Client Transform → Generated JavaScript: emits client code
- Server Transform → Generated JavaScript: emits server code
- Client Transform → CSS Transform: renders styles (evidence: `packages/svelte/src/compiler/phases/3-transform/client/transform-client.js`)
- Client API → Client Runtime: uses runtime (evidence: `packages/svelte/src/index-client.js`)
- Client Runtime → Component Context: uses context (evidence: `packages/svelte/src/internal/client/runtime.js`)
- Client Runtime → Reactivity Engine: uses batching (evidence: `packages/svelte/src/internal/client/runtime.js`)
- Legacy Components → Client Runtime: reads runtime state (evidence: `packages/svelte/src/legacy/legacy-client.js`)
- Legacy Components → DOM Operations: mounts components (evidence: `packages/svelte/src/legacy/legacy-client.js`)
- Stores → Client Runtime: uses runtime (evidence: `packages/svelte/src/store/index-client.js`)
- Reactive Helpers → Browser DOM: observes media (evidence: `packages/svelte/src/reactivity/media-query.js`)
