# hexojs/hexo architecture

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

- Interactive diagram: https://gitdiagram.com/hexojs/hexo
- Repository: https://github.com/hexojs/hexo

## Overview

Hexo is a Node.js blog framework that turns content and theme files into a generated static site. The main documented workflow is authoring a post, then generating site files; the runtime also supports rendering, plugins and themes, migrations, and deployment. The graph captures the core lifecycle and major product capabilities. Some subsystems are unsampled, so their internal calls are omitted rather than inferred.

Main entry points: [`lib/hexo/index.ts`](https://github.com/hexojs/hexo/blob/master/lib/hexo/index.ts) (Hexo Runtime), [`lib/plugins/console/index.ts`](https://github.com/hexojs/hexo/blob/master/lib/plugins/console/index.ts) (Console Commands), [`lib/plugins/processor/post.ts`](https://github.com/hexojs/hexo/blob/master/lib/plugins/processor/post.ts) (Post Processor), [`lib/box/index.ts`](https://github.com/hexojs/hexo/blob/master/lib/box/index.ts) (File Processing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Runtime and Files"]
  node_hexo["Hexo Runtime<br/>[index.ts]"]
  node_filebox["File Processing<br/>[index.ts]"]
  node_database[("Site Database<br/>[load_database.ts]")]
  node_router[("Generated Routes<br/>[router.ts]")]
end

subgraph group_content["Content Processing"]
  node_processors["Content Processors"]
  node_postprocessor["Post Processor<br/>[post.ts]"]
  node_postmodel["Post Model<br/>[post.ts]"]
  node_models["Site Models"]
  node_generator["Page Generators"]
end

subgraph group_rendering["Rendering and Themes"]
  node_render["Render Service<br/>[render.ts]"]
  node_renderer["Renderer Registry<br/>[renderer.ts]"]
  node_theme["Theme Views<br/>[view.ts]"]
  node_themefiles["Theme Processing"]
  node_helpers["Template Helpers"]
end

subgraph group_extensions["Commands and Extensions"]
  node_console["Console Commands<br/>[index.ts]"]
  node_generatecmd["Generate Command<br/>[generate.ts]"]
  node_filters["Content Filters"]
  node_tags["Tag Extensions<br/>[tag.ts]"]
  node_deployer["Deployment Extension<br/>[deployer.ts]"]
  node_migrator["Migration Extension<br/>[migrator.ts]"]
end

node_author(("Site Author"))

node_author -.->|"runs commands"| node_console
node_author -.->|"requests generation"| node_generatecmd
node_hexo -->|"registers commands"| node_console
node_console -->|"registers"| node_generatecmd
node_hexo -->|"loads database"| node_database
node_hexo -->|"processes sources"| node_filebox
node_filebox -.->|"dispatches files"| node_postprocessor
node_postprocessor -.->|"updates records"| node_models
node_hexo -->|"runs generators"| node_generator
node_hexo -->|"stores routes"| node_router
node_hexo -->|"creates render service"| node_render
node_render -->|"selects renderer"| node_renderer
node_theme -->|"renders through"| node_render
node_hexo -->|"initializes theme"| node_themefiles
node_themefiles -->|"processes theme files"| node_filebox
node_hexo -->|"loads filters"| node_filters
node_hexo -->|"loads helpers"| node_helpers
node_theme -->|"exposes helpers"| node_helpers
node_postprocessor -->|"processes posts"| node_postmodel
node_hexo -->|"registers extensions"| node_tags
node_console -.->|"offers deployment"| node_deployer
node_console -.->|"offers migration"| node_migrator

click node_hexo "https://github.com/hexojs/hexo/blob/master/lib/hexo/index.ts"
click node_filebox "https://github.com/hexojs/hexo/blob/master/lib/box/index.ts"
click node_database "https://github.com/hexojs/hexo/blob/master/lib/hexo/load_database.ts"
click node_router "https://github.com/hexojs/hexo/blob/master/lib/hexo/router.ts"
click node_processors "https://github.com/hexojs/hexo/tree/master/lib/plugins/processor"
click node_postprocessor "https://github.com/hexojs/hexo/blob/master/lib/plugins/processor/post.ts"
click node_postmodel "https://github.com/hexojs/hexo/blob/master/lib/models/post.ts"
click node_models "https://github.com/hexojs/hexo/tree/master/lib/models"
click node_generator "https://github.com/hexojs/hexo/tree/master/lib/plugins/generator"
click node_render "https://github.com/hexojs/hexo/blob/master/lib/hexo/render.ts"
click node_renderer "https://github.com/hexojs/hexo/blob/master/lib/extend/renderer.ts"
click node_theme "https://github.com/hexojs/hexo/blob/master/lib/theme/view.ts"
click node_themefiles "https://github.com/hexojs/hexo/tree/master/lib/theme"
click node_helpers "https://github.com/hexojs/hexo/tree/master/lib/plugins/helper"
click node_console "https://github.com/hexojs/hexo/blob/master/lib/plugins/console/index.ts"
click node_generatecmd "https://github.com/hexojs/hexo/blob/master/lib/plugins/console/generate.ts"
click node_filters "https://github.com/hexojs/hexo/tree/master/lib/plugins/filter"
click node_tags "https://github.com/hexojs/hexo/blob/master/lib/extend/tag.ts"
click node_deployer "https://github.com/hexojs/hexo/blob/master/lib/extend/deployer.ts"
click node_migrator "https://github.com/hexojs/hexo/blob/master/lib/extend/migrator.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_hexo,node_filebox,node_database,node_router toneBlue
class node_processors,node_postprocessor,node_postmodel,node_models,node_generator toneAmber
class node_render,node_renderer,node_theme,node_themefiles,node_helpers toneMint
class node_console,node_generatecmd,node_filters,node_tags,node_deployer,node_migrator toneRose
class node_author toneIndigo
```

## Components

### Runtime and Files

- [Hexo Runtime](https://github.com/hexojs/hexo/blob/master/lib/hexo/index.ts): `lib/hexo/index.ts`
- [File Processing](https://github.com/hexojs/hexo/blob/master/lib/box/index.ts): `lib/box/index.ts`
- [Site Database](https://github.com/hexojs/hexo/blob/master/lib/hexo/load_database.ts): `lib/hexo/load_database.ts`
- [Generated Routes](https://github.com/hexojs/hexo/blob/master/lib/hexo/router.ts): `lib/hexo/router.ts`

### Content Processing

- [Content Processors](https://github.com/hexojs/hexo/tree/master/lib/plugins/processor): `lib/plugins/processor`
- [Post Processor](https://github.com/hexojs/hexo/blob/master/lib/plugins/processor/post.ts): `lib/plugins/processor/post.ts`
- [Post Model](https://github.com/hexojs/hexo/blob/master/lib/models/post.ts): `lib/models/post.ts`
- [Site Models](https://github.com/hexojs/hexo/tree/master/lib/models): `lib/models`
- [Page Generators](https://github.com/hexojs/hexo/tree/master/lib/plugins/generator): `lib/plugins/generator`

### Rendering and Themes

- [Render Service](https://github.com/hexojs/hexo/blob/master/lib/hexo/render.ts): `lib/hexo/render.ts`
- [Renderer Registry](https://github.com/hexojs/hexo/blob/master/lib/extend/renderer.ts): `lib/extend/renderer.ts`
- [Theme Views](https://github.com/hexojs/hexo/blob/master/lib/theme/view.ts): `lib/theme/view.ts`
- [Theme Processing](https://github.com/hexojs/hexo/tree/master/lib/theme): `lib/theme`
- [Template Helpers](https://github.com/hexojs/hexo/tree/master/lib/plugins/helper): `lib/plugins/helper`

### Commands and Extensions

- [Console Commands](https://github.com/hexojs/hexo/blob/master/lib/plugins/console/index.ts): `lib/plugins/console/index.ts`
- [Generate Command](https://github.com/hexojs/hexo/blob/master/lib/plugins/console/generate.ts): `lib/plugins/console/generate.ts`
- [Content Filters](https://github.com/hexojs/hexo/tree/master/lib/plugins/filter): `lib/plugins/filter`
- [Tag Extensions](https://github.com/hexojs/hexo/blob/master/lib/extend/tag.ts): `lib/extend/tag.ts`
- [Deployment Extension](https://github.com/hexojs/hexo/blob/master/lib/extend/deployer.ts): `lib/extend/deployer.ts`
- [Migration Extension](https://github.com/hexojs/hexo/blob/master/lib/extend/migrator.ts): `lib/extend/migrator.ts`

### Other components

- **Site Author**

## Connections

- Site Author → Console Commands: runs commands
- Site Author → Generate Command: requests generation
- Hexo Runtime → Console Commands: registers commands (evidence: `lib/hexo/index.ts`)
- Console Commands → Generate Command: registers (evidence: `lib/plugins/console/index.ts`)
- Hexo Runtime → Site Database: loads database (evidence: `lib/hexo/index.ts`)
- Hexo Runtime → File Processing: processes sources (evidence: `lib/hexo/index.ts`)
- File Processing → Post Processor: dispatches files (evidence: `lib/plugins/processor/post.ts`)
- Post Processor → Site Models: updates records
- Hexo Runtime → Page Generators: runs generators (evidence: `lib/hexo/index.ts`)
- Hexo Runtime → Generated Routes: stores routes (evidence: `lib/hexo/index.ts`)
- Hexo Runtime → Render Service: creates render service (evidence: `lib/hexo/index.ts`)
- Render Service → Renderer Registry: selects renderer (evidence: `lib/hexo/render.ts`)
- Theme Views → Render Service: renders through (evidence: `lib/theme/view.ts`)
- Hexo Runtime → Theme Processing: initializes theme (evidence: `lib/theme/index.ts`)
- Theme Processing → File Processing: processes theme files (evidence: `lib/theme/index.ts`)
- Hexo Runtime → Content Filters: loads filters (evidence: `lib/hexo/index.ts`)
- Hexo Runtime → Template Helpers: loads helpers (evidence: `lib/hexo/index.ts`)
- Theme Views → Template Helpers: exposes helpers (evidence: `lib/theme/view.ts`)
- Post Processor → Post Model: processes posts (evidence: `lib/plugins/processor/post.ts`)
- Hexo Runtime → Tag Extensions: registers extensions (evidence: `lib/hexo/index.ts`)
- Console Commands → Deployment Extension: offers deployment
- Console Commands → Migration Extension: offers migration
