# triliumnext/trilium architecture

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

- Interactive diagram: https://gitdiagram.com/triliumnext/trilium
- Repository: https://github.com/triliumnext/trilium

## Overview

Trilium Notes is a cross-platform personal knowledge-base application. Users create and organize hierarchical notes, navigate and edit them in a client, and persist or synchronize them through a server-backed core; the desktop and standalone apps provide alternate runtime hosts. The graph also preserves documented capabilities such as search, imports, sharing, scripting, collections, and AI chat. Some feature links are documented rather than source-verified; these use the README as evidence, and unsampled internal wiring is intentionally omitted.

Main entry points: [`apps/client/src/components/app_context.ts`](https://github.com/triliumnext/trilium/blob/main/apps/client/src/components/app_context.ts) (App context), [`apps/client/src/components/tab_manager.ts`](https://github.com/triliumnext/trilium/blob/main/apps/client/src/components/tab_manager.ts) (Tab navigation), [`apps/client/src/services/froca.ts`](https://github.com/triliumnext/trilium/blob/main/apps/client/src/services/froca.ts) (Note data cache), [`apps/server/src/routes/routes.ts`](https://github.com/triliumnext/trilium/blob/main/apps/server/src/routes/routes.ts) (HTTP routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Note client"]
  node_app_context["App context<br/>[app_context.ts]"]
  node_tabs["Tab navigation<br/>[tab_manager.ts]"]
  node_note_context["Note context<br/>[note_context.ts]"]
  node_widget["Note widgets<br/>[basic_widget.ts]"]
  node_server_client["HTTP client<br/>[server.ts]"]
end

subgraph group_content["Knowledge features"]
  node_note_model["Note model<br/>[fnote.ts]"]
  node_data_cache["Note data cache<br/>[froca.ts]"]
  node_tree["Note tree<br/>[tree.ts]"]
  node_links["Links and navigation<br/>[link.ts]"]
  node_search["Full-text search<br/>[search.ts]"]
  node_collections["Collections"]
  node_imports["Import and export"]
  node_sync["Synchronization<br/>[sync.ts]"]
end

subgraph group_server["Server and core"]
  node_server_app["Server application<br/>[app.ts]"]
  node_routes["HTTP routes<br/>[routes.ts]"]
  node_core_handlers["Domain handlers<br/>[handlers.ts]"]
  node_share_handlers["Public sharing<br/>[handlers.ts]"]
  node_database[("Knowledge database")]
end

subgraph group_hosts["Runtime hosts"]
  node_desktop["Desktop host<br/>[main.ts]"]
  node_standalone["Standalone host<br/>[main.ts]"]
end

subgraph group_integrations["Extensions"]
  node_clipper["Web clipper<br/>[main.tsx]"]
  node_llm_chat["AI chat<br/>[useLlmChat.ts]"]
  node_llm_types["AI chat types<br/>[llm_chat_types.ts]"]
end

node_user(("Note taker"))
node_external_llm{{"LLM providers"}}

node_user -->|"uses"| node_app_context
node_app_context -->|"initializes"| node_data_cache
node_app_context -->|"loads tabs"| node_tabs
node_app_context -->|"renders widgets"| node_widget
node_tabs -->|"creates contexts"| node_note_context
node_tabs -->|"resolves paths"| node_tree
node_tabs -->|"loads notes"| node_data_cache
node_note_context -->|"executes widgets"| node_widget
node_note_model -->|"loads note data"| node_data_cache
node_note_model -->|"requests updates"| node_server_client
node_data_cache -->|"fetches notes"| node_server_client
node_links -->|"opens notes"| node_note_context
node_app_context -->|"uses options"| node_server_client
node_server_app -->|"registers routes"| node_routes
node_routes -->|"mounts core routes"| node_core_handlers
node_routes -->|"mounts share routes"| node_share_handlers
node_core_handlers -.->|"accesses data"| node_database
node_share_handlers -->|"reads shared notes"| node_database
node_desktop -->|"initializes core"| node_database
node_standalone -->|"starts client"| node_app_context
node_clipper -.->|"saves web content"| node_server_app
node_llm_chat -->|"streams completions"| node_external_llm
node_llm_chat -->|"uses chat types"| node_llm_types
node_user -->|"searches notes"| node_search
node_user -->|"organizes notes"| node_collections
node_user -->|"imports content"| node_imports
node_user -->|"synchronizes notes"| node_sync
node_user -.->|"asks questions"| node_llm_chat

click node_app_context "https://github.com/triliumnext/trilium/blob/main/apps/client/src/components/app_context.ts"
click node_tabs "https://github.com/triliumnext/trilium/blob/main/apps/client/src/components/tab_manager.ts"
click node_note_context "https://github.com/triliumnext/trilium/blob/main/apps/client/src/components/note_context.ts"
click node_widget "https://github.com/triliumnext/trilium/blob/main/apps/client/src/widgets/basic_widget.ts"
click node_note_model "https://github.com/triliumnext/trilium/blob/main/apps/client/src/entities/fnote.ts"
click node_data_cache "https://github.com/triliumnext/trilium/blob/main/apps/client/src/services/froca.ts"
click node_tree "https://github.com/triliumnext/trilium/blob/main/apps/client/src/services/tree.ts"
click node_links "https://github.com/triliumnext/trilium/blob/main/apps/client/src/services/link.ts"
click node_search "https://github.com/triliumnext/trilium/blob/main/apps/client/src/services/search.ts"
click node_collections "https://github.com/triliumnext/trilium/tree/main/apps/client/src/widgets/collections"
click node_imports "https://github.com/triliumnext/trilium/tree/main/apps/client/src/widgets/dialogs/import"
click node_sync "https://github.com/triliumnext/trilium/blob/main/apps/client/src/services/sync.ts"
click node_server_client "https://github.com/triliumnext/trilium/blob/main/apps/client/src/services/server.ts"
click node_server_app "https://github.com/triliumnext/trilium/blob/main/apps/server/src/app.ts"
click node_routes "https://github.com/triliumnext/trilium/blob/main/apps/server/src/routes/routes.ts"
click node_core_handlers "https://github.com/triliumnext/trilium/blob/main/packages/trilium-core/src/services/handlers.ts"
click node_share_handlers "https://github.com/triliumnext/trilium/blob/main/packages/trilium-core/src/share/handlers.ts"
click node_desktop "https://github.com/triliumnext/trilium/blob/main/apps/desktop/src/main.ts"
click node_standalone "https://github.com/triliumnext/trilium/blob/main/apps/standalone/src/main.ts"
click node_clipper "https://github.com/triliumnext/trilium/blob/main/apps/web-clipper/entrypoints/popup/main.tsx"
click node_llm_chat "https://github.com/triliumnext/trilium/blob/main/apps/client/src/widgets/type_widgets/llm_chat/useLlmChat.ts"
click node_llm_types "https://github.com/triliumnext/trilium/blob/main/apps/client/src/widgets/type_widgets/llm_chat/llm_chat_types.ts"
click node_database "https://github.com/triliumnext/trilium/tree/main/packages/trilium-core/src"

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_app_context,node_tabs,node_note_context,node_widget,node_server_client toneBlue
class node_note_model,node_data_cache,node_tree,node_links,node_search,node_collections,node_imports,node_sync toneAmber
class node_server_app,node_routes,node_core_handlers,node_share_handlers,node_database toneMint
class node_desktop,node_standalone toneRose
class node_clipper,node_llm_chat,node_llm_types,node_user,node_external_llm toneIndigo
```

## Components

### Note client

- [App context](https://github.com/triliumnext/trilium/blob/main/apps/client/src/components/app_context.ts): `apps/client/src/components/app_context.ts`
- [Tab navigation](https://github.com/triliumnext/trilium/blob/main/apps/client/src/components/tab_manager.ts): `apps/client/src/components/tab_manager.ts`
- [Note context](https://github.com/triliumnext/trilium/blob/main/apps/client/src/components/note_context.ts): `apps/client/src/components/note_context.ts`
- [Note widgets](https://github.com/triliumnext/trilium/blob/main/apps/client/src/widgets/basic_widget.ts): `apps/client/src/widgets/basic_widget.ts`
- [HTTP client](https://github.com/triliumnext/trilium/blob/main/apps/client/src/services/server.ts): `apps/client/src/services/server.ts`

### Knowledge features

- [Note model](https://github.com/triliumnext/trilium/blob/main/apps/client/src/entities/fnote.ts): `apps/client/src/entities/fnote.ts`
- [Note data cache](https://github.com/triliumnext/trilium/blob/main/apps/client/src/services/froca.ts): `apps/client/src/services/froca.ts`
- [Note tree](https://github.com/triliumnext/trilium/blob/main/apps/client/src/services/tree.ts): `apps/client/src/services/tree.ts`
- [Links and navigation](https://github.com/triliumnext/trilium/blob/main/apps/client/src/services/link.ts): `apps/client/src/services/link.ts`
- [Full-text search](https://github.com/triliumnext/trilium/blob/main/apps/client/src/services/search.ts): `apps/client/src/services/search.ts`
- [Collections](https://github.com/triliumnext/trilium/tree/main/apps/client/src/widgets/collections): `apps/client/src/widgets/collections`
- [Import and export](https://github.com/triliumnext/trilium/tree/main/apps/client/src/widgets/dialogs/import): `apps/client/src/widgets/dialogs/import`
- [Synchronization](https://github.com/triliumnext/trilium/blob/main/apps/client/src/services/sync.ts): `apps/client/src/services/sync.ts`

### Server and core

- [Server application](https://github.com/triliumnext/trilium/blob/main/apps/server/src/app.ts): `apps/server/src/app.ts`
- [HTTP routes](https://github.com/triliumnext/trilium/blob/main/apps/server/src/routes/routes.ts): `apps/server/src/routes/routes.ts`
- [Domain handlers](https://github.com/triliumnext/trilium/blob/main/packages/trilium-core/src/services/handlers.ts): `packages/trilium-core/src/services/handlers.ts`
- [Public sharing](https://github.com/triliumnext/trilium/blob/main/packages/trilium-core/src/share/handlers.ts): `packages/trilium-core/src/share/handlers.ts`
- [Knowledge database](https://github.com/triliumnext/trilium/tree/main/packages/trilium-core/src): `packages/trilium-core/src`

### Runtime hosts

- [Desktop host](https://github.com/triliumnext/trilium/blob/main/apps/desktop/src/main.ts): `apps/desktop/src/main.ts`
- [Standalone host](https://github.com/triliumnext/trilium/blob/main/apps/standalone/src/main.ts): `apps/standalone/src/main.ts`

### Extensions

- [Web clipper](https://github.com/triliumnext/trilium/blob/main/apps/web-clipper/entrypoints/popup/main.tsx): `apps/web-clipper/entrypoints/popup/main.tsx`
- [AI chat](https://github.com/triliumnext/trilium/blob/main/apps/client/src/widgets/type_widgets/llm_chat/useLlmChat.ts): `apps/client/src/widgets/type_widgets/llm_chat/useLlmChat.ts`
- [AI chat types](https://github.com/triliumnext/trilium/blob/main/apps/client/src/widgets/type_widgets/llm_chat/llm_chat_types.ts): `apps/client/src/widgets/type_widgets/llm_chat/llm_chat_types.ts`

### Other components

- **Note taker**
- **LLM providers**

## Connections

- Note taker → App context: uses
- App context → Note data cache: initializes (evidence: `apps/client/src/components/app_context.ts`)
- App context → Tab navigation: loads tabs (evidence: `apps/client/src/components/app_context.ts`)
- App context → Note widgets: renders widgets (evidence: `apps/client/src/components/app_context.ts`)
- Tab navigation → Note context: creates contexts (evidence: `apps/client/src/components/tab_manager.ts`)
- Tab navigation → Note tree: resolves paths (evidence: `apps/client/src/components/tab_manager.ts`)
- Tab navigation → Note data cache: loads notes (evidence: `apps/client/src/components/tab_manager.ts`)
- Note context → Note widgets: executes widgets (evidence: `apps/client/src/components/note_context.ts`)
- Note model → Note data cache: loads note data (evidence: `apps/client/src/entities/fnote.ts`)
- Note model → HTTP client: requests updates (evidence: `apps/client/src/entities/fnote.ts`)
- Note data cache → HTTP client: fetches notes (evidence: `apps/client/src/services/froca.ts`)
- Links and navigation → Note context: opens notes (evidence: `apps/client/src/services/link.ts`)
- App context → HTTP client: uses options (evidence: `apps/client/src/components/app_context.ts`)
- Server application → HTTP routes: registers routes (evidence: `apps/server/src/app.ts`)
- HTTP routes → Domain handlers: mounts core routes (evidence: `apps/server/src/routes/routes.ts`)
- HTTP routes → Public sharing: mounts share routes (evidence: `apps/server/src/routes/routes.ts`)
- Domain handlers → Knowledge database: accesses data (evidence: `packages/trilium-core/src/services/handlers.ts`)
- Public sharing → Knowledge database: reads shared notes (evidence: `packages/trilium-core/src/share/handlers.ts`)
- Desktop host → Knowledge database: initializes core (evidence: `apps/desktop/src/main.ts`)
- Standalone host → App context: starts client (evidence: `apps/standalone/src/main.ts`)
- Web clipper → Server application: saves web content
- AI chat → LLM providers: streams completions (evidence: `apps/client/src/widgets/type_widgets/llm_chat/useLlmChat.ts`)
- AI chat → AI chat types: uses chat types (evidence: `apps/client/src/widgets/type_widgets/llm_chat/useLlmChat.ts`)
- Note taker → Full-text search: searches notes
- Note taker → Collections: organizes notes
- Note taker → Import and export: imports content
- Note taker → Synchronization: synchronizes notes
- Note taker → AI chat: asks questions
