# slidevjs/slidev architecture

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

- Interactive diagram: https://gitdiagram.com/slidevjs/slidev
- Repository: https://github.com/slidevjs/slidev

## Overview

Slidev is a Markdown-based presentation system for developers. Authors write slide content and configure themes; the parser and Node/Vite runtime prepare a presentation that the Vue client renders and navigates. The client also provides interactive slide features and dedicated presenter, drawing, recording, and export experiences. A VS Code extension adds project discovery and an editor preview. The README documents the main capabilities; some runtime links are shown as unverified where the supplied excerpts do not expose their wiring.

Main entry points: [`packages/client/setup/routes.ts`](https://github.com/slidevjs/slidev/blob/main/packages/client/setup/routes.ts) (Presentation Routes), [`packages/vscode/src/projects.ts`](https://github.com/slidevjs/slidev/blob/main/packages/vscode/src/projects.ts) (Project Discovery), [`packages/slidev/node/cli.ts`](https://github.com/slidevjs/slidev/blob/main/packages/slidev/node/cli.ts) (Node Runtime), [`packages/client/internals/SlideContainer.vue`](https://github.com/slidevjs/slidev/blob/main/packages/client/internals/SlideContainer.vue) (Slide Rendering)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_authoring["Authoring Runtime"]
  node_markdown["Markdown Slides"]
  node_parser["Slide Parser<br/>[core.ts]"]
  node_node_runtime["Node Runtime<br/>[cli.ts]"]
  node_syntax["Markdown Syntax"]
  node_vite["Vite Integration"]
  node_themes["Themes and Add-ons"]
end

subgraph group_client["Presentation Client"]
  node_client_app["Vue Client<br/>[App.vue]"]
  node_routes["Presentation Routes<br/>[routes.ts]"]
  node_navigation["Slide Navigation<br/>[useNav.ts]"]
  node_slide_render["Slide Rendering<br/>[SlideContainer.vue]"]
  node_layouts["Slide Layouts"]
end

subgraph group_features["Presentation Features"]
  node_interactions["Interactive Directives<br/>[v-click.ts]"]
  node_dragging["Drag Elements<br/>[useDragElements.ts]"]
  node_presenter["Presenter Mode<br/>[presenter.vue]"]
  node_drawing["Drawing Tools<br/>[drawings.ts]"]
  node_recording["Recording<br/>[recording.ts]"]
  node_export["Export<br/>[export.vue]"]
end

subgraph group_editor["VS Code Extension"]
  node_vscode_projects["Project Discovery<br/>[projects.ts]"]
  node_server_detect["Server Detection"]
  node_editor_preview["Editor Preview<br/>[previewWebview.ts]"]
end

node_author(("Slide Author"))

node_author -->|"writes slides"| node_markdown
node_markdown -.->|"parses content"| node_parser
node_node_runtime -.->|"loads slides"| node_parser
node_node_runtime -.->|"prepares syntax"| node_syntax
node_node_runtime -.->|"serves presentation"| node_vite
node_vite -.->|"delivers client"| node_client_app
node_themes -.->|"extends presentation"| node_client_app
node_client_app -->|"sets up root"| node_routes
node_routes -.->|"routes slides"| node_navigation
node_routes -->|"routes presenter"| node_presenter
node_routes -->|"routes export"| node_export
node_navigation -.->|"selects slide"| node_slide_render
node_slide_render -.->|"renders layout"| node_layouts
node_slide_render -.->|"supports interactions"| node_interactions
node_interactions -->|"enables dragging"| node_dragging
node_presenter -.->|"offers annotation"| node_drawing
node_presenter -.->|"offers recording"| node_recording
node_author -.->|"opens project"| node_vscode_projects
node_vscode_projects -->|"loads project data"| node_parser
node_vscode_projects -->|"detects servers"| node_server_detect
node_editor_preview -->|"checks server"| node_server_detect
node_editor_preview -->|"uses project state"| node_vscode_projects

click node_parser "https://github.com/slidevjs/slidev/blob/main/packages/parser/src/core.ts"
click node_node_runtime "https://github.com/slidevjs/slidev/blob/main/packages/slidev/node/cli.ts"
click node_syntax "https://github.com/slidevjs/slidev/tree/main/packages/slidev/node/syntax"
click node_vite "https://github.com/slidevjs/slidev/tree/main/packages/slidev/node/vite"
click node_themes "https://github.com/slidevjs/slidev/tree/main/packages/slidev/node/integrations"
click node_client_app "https://github.com/slidevjs/slidev/blob/main/packages/client/App.vue"
click node_routes "https://github.com/slidevjs/slidev/blob/main/packages/client/setup/routes.ts"
click node_navigation "https://github.com/slidevjs/slidev/blob/main/packages/client/composables/useNav.ts"
click node_slide_render "https://github.com/slidevjs/slidev/blob/main/packages/client/internals/SlideContainer.vue"
click node_layouts "https://github.com/slidevjs/slidev/tree/main/packages/client/layouts"
click node_interactions "https://github.com/slidevjs/slidev/blob/main/packages/client/modules/v-click.ts"
click node_dragging "https://github.com/slidevjs/slidev/blob/main/packages/client/composables/useDragElements.ts"
click node_presenter "https://github.com/slidevjs/slidev/blob/main/packages/client/pages/presenter.vue"
click node_drawing "https://github.com/slidevjs/slidev/blob/main/packages/client/state/drawings.ts"
click node_recording "https://github.com/slidevjs/slidev/blob/main/packages/client/logic/recording.ts"
click node_export "https://github.com/slidevjs/slidev/blob/main/packages/client/pages/export.vue"
click node_vscode_projects "https://github.com/slidevjs/slidev/blob/main/packages/vscode/src/projects.ts"
click node_server_detect "https://github.com/slidevjs/slidev/blob/main/packages/vscode/src/composables/useServerDetector.ts"
click node_editor_preview "https://github.com/slidevjs/slidev/blob/main/packages/vscode/src/views/previewWebview.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_markdown,node_parser,node_node_runtime,node_syntax,node_vite,node_themes toneBlue
class node_client_app,node_routes,node_navigation,node_slide_render,node_layouts toneAmber
class node_interactions,node_dragging,node_presenter,node_drawing,node_recording,node_export toneMint
class node_vscode_projects,node_server_detect,node_editor_preview toneRose
class node_author toneIndigo
```

## Components

### Authoring Runtime

- **Markdown Slides**
- [Slide Parser](https://github.com/slidevjs/slidev/blob/main/packages/parser/src/core.ts): `packages/parser/src/core.ts`
- [Node Runtime](https://github.com/slidevjs/slidev/blob/main/packages/slidev/node/cli.ts): `packages/slidev/node/cli.ts`
- [Markdown Syntax](https://github.com/slidevjs/slidev/tree/main/packages/slidev/node/syntax): `packages/slidev/node/syntax`
- [Vite Integration](https://github.com/slidevjs/slidev/tree/main/packages/slidev/node/vite): `packages/slidev/node/vite`
- [Themes and Add-ons](https://github.com/slidevjs/slidev/tree/main/packages/slidev/node/integrations): `packages/slidev/node/integrations`

### Presentation Client

- [Vue Client](https://github.com/slidevjs/slidev/blob/main/packages/client/App.vue): `packages/client/App.vue`
- [Presentation Routes](https://github.com/slidevjs/slidev/blob/main/packages/client/setup/routes.ts): `packages/client/setup/routes.ts`
- [Slide Navigation](https://github.com/slidevjs/slidev/blob/main/packages/client/composables/useNav.ts): `packages/client/composables/useNav.ts`
- [Slide Rendering](https://github.com/slidevjs/slidev/blob/main/packages/client/internals/SlideContainer.vue): `packages/client/internals/SlideContainer.vue`
- [Slide Layouts](https://github.com/slidevjs/slidev/tree/main/packages/client/layouts): `packages/client/layouts`

### Presentation Features

- [Interactive Directives](https://github.com/slidevjs/slidev/blob/main/packages/client/modules/v-click.ts): `packages/client/modules/v-click.ts`
- [Drag Elements](https://github.com/slidevjs/slidev/blob/main/packages/client/composables/useDragElements.ts): `packages/client/composables/useDragElements.ts`
- [Presenter Mode](https://github.com/slidevjs/slidev/blob/main/packages/client/pages/presenter.vue): `packages/client/pages/presenter.vue`
- [Drawing Tools](https://github.com/slidevjs/slidev/blob/main/packages/client/state/drawings.ts): `packages/client/state/drawings.ts`
- [Recording](https://github.com/slidevjs/slidev/blob/main/packages/client/logic/recording.ts): `packages/client/logic/recording.ts`
- [Export](https://github.com/slidevjs/slidev/blob/main/packages/client/pages/export.vue): `packages/client/pages/export.vue`

### VS Code Extension

- [Project Discovery](https://github.com/slidevjs/slidev/blob/main/packages/vscode/src/projects.ts): `packages/vscode/src/projects.ts`
- [Server Detection](https://github.com/slidevjs/slidev/blob/main/packages/vscode/src/composables/useServerDetector.ts): `packages/vscode/src/composables/useServerDetector.ts`
- [Editor Preview](https://github.com/slidevjs/slidev/blob/main/packages/vscode/src/views/previewWebview.ts): `packages/vscode/src/views/previewWebview.ts`

### Other components

- **Slide Author**

## Connections

- Slide Author → Markdown Slides: writes slides (evidence: `README.md`)
- Markdown Slides → Slide Parser: parses content
- Node Runtime → Slide Parser: loads slides
- Node Runtime → Markdown Syntax: prepares syntax
- Node Runtime → Vite Integration: serves presentation
- Vite Integration → Vue Client: delivers client
- Themes and Add-ons → Vue Client: extends presentation
- Vue Client → Presentation Routes: sets up root (evidence: `packages/client/App.vue`)
- Presentation Routes → Slide Navigation: routes slides
- Presentation Routes → Presenter Mode: routes presenter (evidence: `packages/client/setup/routes.ts`)
- Presentation Routes → Export: routes export (evidence: `packages/client/setup/routes.ts`)
- Slide Navigation → Slide Rendering: selects slide
- Slide Rendering → Slide Layouts: renders layout
- Slide Rendering → Interactive Directives: supports interactions
- Interactive Directives → Drag Elements: enables dragging
- Presenter Mode → Drawing Tools: offers annotation
- Presenter Mode → Recording: offers recording
- Slide Author → Project Discovery: opens project
- Project Discovery → Slide Parser: loads project data (evidence: `packages/vscode/src/projects.ts`)
- Project Discovery → Server Detection: detects servers (evidence: `packages/vscode/src/projects.ts`)
- Editor Preview → Server Detection: checks server (evidence: `packages/vscode/src/views/previewWebview.ts`)
- Editor Preview → Project Discovery: uses project state (evidence: `packages/vscode/src/views/previewWebview.ts`)
