# gohighlevel/outline architecture

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

- Interactive diagram: https://gitdiagram.com/gohighlevel/outline
- Repository: https://github.com/gohighlevel/outline

## Overview

Outline is a React/Node.js collaborative team knowledge base. A user works with collections and documents through the client, where document editing, comments, sharing, search, and navigation form the main product experience; the server exposes application services and persists domain data. The editor has a reusable extension and Markdown layer, while the server supports pluggable integrations and file storage. The README identifies the product but does not specify runtime flow; edges below are limited to relationships visible in indexed references or excerpts, and some major subsystems are represented by their exact directories because their source was not sampled.

Main entry points: [`server/main.ts`](https://github.com/gohighlevel/outline/blob/main/server/main.ts) (HTTP services), [`app/index.tsx`](https://github.com/gohighlevel/outline/blob/main/app/index.tsx) (Client application), [`app/scenes`](https://github.com/gohighlevel/outline/tree/main/app/scenes) (Product scenes), [`app/editor/index.tsx`](https://github.com/gohighlevel/outline/blob/main/app/editor/index.tsx) (Editor interface)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Client experience"]
  node_clientapp["Client application<br/>[index.tsx]"]
  node_scenes["Product scenes"]
  node_actions["Action system<br/>[index.ts]"]
end

subgraph group_editor["Document editing"]
  node_editorui["Editor interface<br/>[index.tsx]"]
  node_extensions["Editor extensions"]
  node_markdown["Markdown serializer<br/>[serializer.ts]"]
end

subgraph group_server["Server services"]
  node_server["HTTP services<br/>[main.ts]"]
  node_api["Application routes"]
  node_plugins["Plugin manager<br/>[PluginManager.ts]"]
  node_filebase["File storage interface<br/>[BaseStorage.ts]"]
  node_s3["S3 storage<br/>[S3Storage.ts]"]
  node_integrations["Product integrations"]
end

subgraph group_domain["Domain and persistence"]
  node_stores["Client stores<br/>[RootStore.ts]"]
  node_documents["Document model<br/>[Document.ts]"]
  node_modelbase["Model foundation<br/>[Model.ts]"]
  node_database[("Database layer")]
end

node_user(("Team member"))

node_user -.->|"uses"| node_clientapp
node_clientapp -.->|"presents"| node_scenes
node_clientapp -->|"uses"| node_stores
node_scenes -.->|"offers actions"| node_actions
node_scenes -.->|"hosts editing"| node_editorui
node_stores -.->|"manages"| node_documents
node_documents -.->|"extends"| node_modelbase
node_editorui -.->|"configures"| node_extensions
node_extensions -->|"creates serializer"| node_markdown
node_server -->|"checks connection"| node_database
node_server -->|"loads plugins"| node_plugins
node_server -.->|"serves routes"| node_api
node_integrations -.->|"register with"| node_plugins
node_filebase -->|"specialized by"| node_s3

click node_clientapp "https://github.com/gohighlevel/outline/blob/main/app/index.tsx"
click node_scenes "https://github.com/gohighlevel/outline/tree/main/app/scenes"
click node_actions "https://github.com/gohighlevel/outline/blob/main/app/actions/index.ts"
click node_stores "https://github.com/gohighlevel/outline/blob/main/app/stores/RootStore.ts"
click node_documents "https://github.com/gohighlevel/outline/blob/main/app/models/Document.ts"
click node_modelbase "https://github.com/gohighlevel/outline/blob/main/app/models/base/Model.ts"
click node_editorui "https://github.com/gohighlevel/outline/blob/main/app/editor/index.tsx"
click node_extensions "https://github.com/gohighlevel/outline/blob/main/shared/editor/lib/ExtensionManager.ts"
click node_markdown "https://github.com/gohighlevel/outline/blob/main/shared/editor/lib/markdown/serializer.ts"
click node_server "https://github.com/gohighlevel/outline/blob/main/server/main.ts"
click node_api "https://github.com/gohighlevel/outline/tree/main/server/routes"
click node_plugins "https://github.com/gohighlevel/outline/blob/main/server/utils/PluginManager.ts"
click node_filebase "https://github.com/gohighlevel/outline/blob/main/server/storage/files/BaseStorage.ts"
click node_s3 "https://github.com/gohighlevel/outline/blob/main/server/storage/files/S3Storage.ts"
click node_integrations "https://github.com/gohighlevel/outline/tree/main/plugins"

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_clientapp,node_scenes,node_actions toneBlue
class node_editorui,node_extensions,node_markdown toneAmber
class node_server,node_api,node_plugins,node_filebase,node_s3,node_integrations toneMint
class node_stores,node_documents,node_modelbase,node_database toneRose
class node_user toneIndigo
```

## Components

### Client experience

- [Client application](https://github.com/gohighlevel/outline/blob/main/app/index.tsx): `app/index.tsx`
- [Product scenes](https://github.com/gohighlevel/outline/tree/main/app/scenes): `app/scenes`
- [Action system](https://github.com/gohighlevel/outline/blob/main/app/actions/index.ts): `app/actions/index.ts`

### Document editing

- [Editor interface](https://github.com/gohighlevel/outline/blob/main/app/editor/index.tsx): `app/editor/index.tsx`
- [Editor extensions](https://github.com/gohighlevel/outline/blob/main/shared/editor/lib/ExtensionManager.ts): `shared/editor/lib/ExtensionManager.ts`
- [Markdown serializer](https://github.com/gohighlevel/outline/blob/main/shared/editor/lib/markdown/serializer.ts): `shared/editor/lib/markdown/serializer.ts`

### Server services

- [HTTP services](https://github.com/gohighlevel/outline/blob/main/server/main.ts): `server/main.ts`
- [Application routes](https://github.com/gohighlevel/outline/tree/main/server/routes): `server/routes`
- [Plugin manager](https://github.com/gohighlevel/outline/blob/main/server/utils/PluginManager.ts): `server/utils/PluginManager.ts`
- [File storage interface](https://github.com/gohighlevel/outline/blob/main/server/storage/files/BaseStorage.ts): `server/storage/files/BaseStorage.ts`
- [S3 storage](https://github.com/gohighlevel/outline/blob/main/server/storage/files/S3Storage.ts): `server/storage/files/S3Storage.ts`
- [Product integrations](https://github.com/gohighlevel/outline/tree/main/plugins): `plugins`

### Domain and persistence

- [Client stores](https://github.com/gohighlevel/outline/blob/main/app/stores/RootStore.ts): `app/stores/RootStore.ts`
- [Document model](https://github.com/gohighlevel/outline/blob/main/app/models/Document.ts): `app/models/Document.ts`
- [Model foundation](https://github.com/gohighlevel/outline/blob/main/app/models/base/Model.ts): `app/models/base/Model.ts`
- **Database layer**

### Other components

- **Team member**

## Connections

- Team member → Client application: uses (evidence: `README.md`)
- Client application → Product scenes: presents
- Client application → Client stores: uses (evidence: `app/stores/RootStore.ts`)
- Product scenes → Action system: offers actions
- Product scenes → Editor interface: hosts editing
- Client stores → Document model: manages
- Document model → Model foundation: extends
- Editor interface → Editor extensions: configures
- Editor extensions → Markdown serializer: creates serializer (evidence: `shared/editor/lib/ExtensionManager.ts`)
- HTTP services → Database layer: checks connection (evidence: `server/main.ts`)
- HTTP services → Plugin manager: loads plugins (evidence: `server/main.ts`)
- HTTP services → Application routes: serves routes
- Product integrations → Plugin manager: register with
- File storage interface → S3 storage: specialized by (evidence: `server/storage/files/S3Storage.ts`)
