# vuejs/core architecture

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

- Interactive diagram: https://gitdiagram.com/vuejs/core
- Repository: https://github.com/vuejs/core

## Overview

Vue is a JavaScript framework for building component-based user interfaces. The principal workflow is to author a template or single-file component, compile it into render code, create and render component instances, and update the resulting UI reactively. The repository also provides DOM and server-rendering runtimes, plus a compatibility build. The graph focuses on these product layers; several cross-package runtime links are only indicated as unverified because the supplied excerpts do not show their calls.

Main entry points: [`packages/vue/src/index.ts`](https://github.com/vuejs/core/blob/main/packages/vue/src/index.ts) (Vue API), [`packages/reactivity/src/reactive.ts`](https://github.com/vuejs/core/blob/main/packages/reactivity/src/reactive.ts) (Reactive proxies), [`packages/runtime-core/src/renderer.ts`](https://github.com/vuejs/core/blob/main/packages/runtime-core/src/renderer.ts) (Virtual DOM renderer), [`packages/compiler-core/src/parser.ts`](https://github.com/vuejs/core/blob/main/packages/compiler-core/src/parser.ts) (Template parser)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_authoring["Framework entry"]
  node_vue["Vue API<br/>[index.ts]"]
end

subgraph group_compile["Compilation"]
  node_sfc["SFC compiler<br/>[compileScript.ts]"]
  node_template["Template parser<br/>[parser.ts]"]
  node_ast["Compiler AST<br/>[ast.ts]"]
  node_transforms["Template transforms<br/>[transform.ts]"]
  node_codegen["Render codegen<br/>[codegen.ts]"]
  node_domcompiler["DOM compiler<br/>[parserOptions.ts]"]
  node_ssrcompiler["SSR compiler"]
end

subgraph group_runtime["Component runtime"]
  node_components["Component instances<br/>[component.ts]"]
  node_renderer["Virtual DOM renderer<br/>[renderer.ts]"]
  node_vnode["VNode model<br/>[vnode.ts]"]
end

subgraph group_platform["Rendering platforms"]
  node_domruntime["DOM renderer<br/>[index.ts]"]
  node_serverrenderer["Server renderer<br/>[render.ts]"]
end

subgraph group_state["Reactive state"]
  node_reactive["Reactive proxies<br/>[reactive.ts]"]
  node_dependencies["Dependency tracking<br/>[dep.ts]"]
  node_reactivehandlers["Proxy handlers<br/>[baseHandlers.ts]"]
  node_collections["Reactive collections"]
end

node_developer(("Application developer"))

node_developer -->|"uses"| node_vue
node_vue -->|"exposes"| node_domcompiler
node_vue -->|"exposes"| node_domruntime
node_sfc -.->|"parses"| node_template
node_sfc -->|"compiles template"| node_codegen
node_template -->|"creates nodes"| node_ast
node_transforms -.->|"transforms"| node_ast
node_codegen -.->|"consumes"| node_ast
node_domcompiler -->|"configures parsing"| node_template
node_ssrcompiler -->|"uses"| node_domcompiler
node_components -->|"uses"| node_reactive
node_reactive -->|"selects handlers"| node_reactivehandlers
node_reactive -->|"selects handlers"| node_collections
node_reactivehandlers -.->|"tracks changes"| node_dependencies
node_collections -->|"tracks changes"| node_dependencies
node_renderer -.->|"renders components"| node_components
node_renderer -.->|"patches nodes"| node_vnode
node_domruntime -.->|"provides host"| node_renderer
node_serverrenderer -.->|"renders compiled output"| node_ssrcompiler

click node_vue "https://github.com/vuejs/core/blob/main/packages/vue/src/index.ts"
click node_sfc "https://github.com/vuejs/core/blob/main/packages/compiler-sfc/src/compileScript.ts"
click node_template "https://github.com/vuejs/core/blob/main/packages/compiler-core/src/parser.ts"
click node_ast "https://github.com/vuejs/core/blob/main/packages/compiler-core/src/ast.ts"
click node_transforms "https://github.com/vuejs/core/blob/main/packages/compiler-core/src/transform.ts"
click node_codegen "https://github.com/vuejs/core/blob/main/packages/compiler-core/src/codegen.ts"
click node_domcompiler "https://github.com/vuejs/core/blob/main/packages/compiler-dom/src/parserOptions.ts"
click node_ssrcompiler "https://github.com/vuejs/core/blob/main/packages/compiler-ssr/src/ssrCodegenTransform.ts"
click node_components "https://github.com/vuejs/core/blob/main/packages/runtime-core/src/component.ts"
click node_renderer "https://github.com/vuejs/core/blob/main/packages/runtime-core/src/renderer.ts"
click node_vnode "https://github.com/vuejs/core/blob/main/packages/runtime-core/src/vnode.ts"
click node_domruntime "https://github.com/vuejs/core/blob/main/packages/runtime-dom/src/index.ts"
click node_serverrenderer "https://github.com/vuejs/core/blob/main/packages/server-renderer/src/render.ts"
click node_reactive "https://github.com/vuejs/core/blob/main/packages/reactivity/src/reactive.ts"
click node_dependencies "https://github.com/vuejs/core/blob/main/packages/reactivity/src/dep.ts"
click node_reactivehandlers "https://github.com/vuejs/core/blob/main/packages/reactivity/src/baseHandlers.ts"
click node_collections "https://github.com/vuejs/core/blob/main/packages/reactivity/src/collectionHandlers.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_vue toneBlue
class node_sfc,node_template,node_ast,node_transforms,node_codegen,node_domcompiler,node_ssrcompiler toneAmber
class node_components,node_renderer,node_vnode toneMint
class node_domruntime,node_serverrenderer toneRose
class node_reactive,node_dependencies,node_reactivehandlers,node_collections,node_developer toneIndigo
```

## Components

### Framework entry

- [Vue API](https://github.com/vuejs/core/blob/main/packages/vue/src/index.ts): `packages/vue/src/index.ts`

### Compilation

- [SFC compiler](https://github.com/vuejs/core/blob/main/packages/compiler-sfc/src/compileScript.ts): `packages/compiler-sfc/src/compileScript.ts`
- [Template parser](https://github.com/vuejs/core/blob/main/packages/compiler-core/src/parser.ts): `packages/compiler-core/src/parser.ts`
- [Compiler AST](https://github.com/vuejs/core/blob/main/packages/compiler-core/src/ast.ts): `packages/compiler-core/src/ast.ts`
- [Template transforms](https://github.com/vuejs/core/blob/main/packages/compiler-core/src/transform.ts): `packages/compiler-core/src/transform.ts`
- [Render codegen](https://github.com/vuejs/core/blob/main/packages/compiler-core/src/codegen.ts): `packages/compiler-core/src/codegen.ts`
- [DOM compiler](https://github.com/vuejs/core/blob/main/packages/compiler-dom/src/parserOptions.ts): `packages/compiler-dom/src/parserOptions.ts`
- [SSR compiler](https://github.com/vuejs/core/blob/main/packages/compiler-ssr/src/ssrCodegenTransform.ts): `packages/compiler-ssr/src/ssrCodegenTransform.ts`

### Component runtime

- [Component instances](https://github.com/vuejs/core/blob/main/packages/runtime-core/src/component.ts): `packages/runtime-core/src/component.ts`
- [Virtual DOM renderer](https://github.com/vuejs/core/blob/main/packages/runtime-core/src/renderer.ts): `packages/runtime-core/src/renderer.ts`
- [VNode model](https://github.com/vuejs/core/blob/main/packages/runtime-core/src/vnode.ts): `packages/runtime-core/src/vnode.ts`

### Rendering platforms

- [DOM renderer](https://github.com/vuejs/core/blob/main/packages/runtime-dom/src/index.ts): `packages/runtime-dom/src/index.ts`
- [Server renderer](https://github.com/vuejs/core/blob/main/packages/server-renderer/src/render.ts): `packages/server-renderer/src/render.ts`

### Reactive state

- [Reactive proxies](https://github.com/vuejs/core/blob/main/packages/reactivity/src/reactive.ts): `packages/reactivity/src/reactive.ts`
- [Dependency tracking](https://github.com/vuejs/core/blob/main/packages/reactivity/src/dep.ts): `packages/reactivity/src/dep.ts`
- [Proxy handlers](https://github.com/vuejs/core/blob/main/packages/reactivity/src/baseHandlers.ts): `packages/reactivity/src/baseHandlers.ts`
- [Reactive collections](https://github.com/vuejs/core/blob/main/packages/reactivity/src/collectionHandlers.ts): `packages/reactivity/src/collectionHandlers.ts`

### Other components

- **Application developer**

## Connections

- Application developer → Vue API: uses (evidence: `README.md`)
- Vue API → DOM compiler: exposes (evidence: `packages/vue/src/index.ts`)
- Vue API → DOM renderer: exposes (evidence: `packages/vue/src/index.ts`)
- SFC compiler → Template parser: parses
- SFC compiler → Render codegen: compiles template (evidence: `packages/compiler-sfc/src/compileScript.ts`)
- Template parser → Compiler AST: creates nodes (evidence: `packages/compiler-core/src/parser.ts`)
- Template transforms → Compiler AST: transforms (evidence: `packages/compiler-core/src/ast.ts`)
- Render codegen → Compiler AST: consumes
- DOM compiler → Template parser: configures parsing (evidence: `packages/compiler-dom/src/parserOptions.ts`)
- SSR compiler → DOM compiler: uses
- Component instances → Reactive proxies: uses (evidence: `packages/runtime-core/src/component.ts`)
- Reactive proxies → Proxy handlers: selects handlers (evidence: `packages/reactivity/src/reactive.ts`)
- Reactive proxies → Reactive collections: selects handlers (evidence: `packages/reactivity/src/reactive.ts`)
- Proxy handlers → Dependency tracking: tracks changes (evidence: `packages/reactivity/src/baseHandlers.ts`)
- Reactive collections → Dependency tracking: tracks changes (evidence: `packages/reactivity/src/collectionHandlers.ts`)
- Virtual DOM renderer → Component instances: renders components (evidence: `packages/runtime-core/src/component.ts`)
- Virtual DOM renderer → VNode model: patches nodes
- DOM renderer → Virtual DOM renderer: provides host
- Server renderer → SSR compiler: renders compiled output
