# notionnext-org/notionnext architecture

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

- Interactive diagram: https://gitdiagram.com/notionnext-org/notionnext
- Repository: https://github.com/notionnext-org/notionnext

## Overview

NotionNext turns content maintained in Notion into a configurable Next.js website for blogs, portfolios, documentation, navigation, and product pages. The main journey is authoring in Notion, loading and processing site content, selecting a theme to render pages, then distributing them with search, SEO, feeds, comments, and analytics. The tree and README establish the product capabilities; sampled source confirms selected configuration, rendering, search, and comment behavior. Several subsystems are documented but not sampled, so their internal call relationships are not inferred.

Main entry points: [`themes`](https://github.com/notionnext-org/notionnext/tree/main/themes) (Theme renderer), [`lib/site/site.service.ts`](https://github.com/notionnext-org/notionnext/blob/main/lib/site/site.service.ts) (Site data service), [`components/AlgoliaSearchModal.js`](https://github.com/notionnext-org/notionnext/blob/main/components/AlgoliaSearchModal.js) (Algolia search), [`lib/site/adapters/notion`](https://github.com/notionnext-org/notionnext/tree/main/lib/site/adapters/notion) (Notion adapter)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_content["Content pipeline"]
  node_site["Site data service<br/>[site.service.ts]"]
  node_notionadapter["Notion adapter"]
  node_processors["Content processors"]
  node_config["Site configuration<br/>[config.js]"]
end

subgraph group_web["Site experience"]
  node_routes["Page routes"]
  node_themes["Theme renderer"]
  node_notionpage["Notion page view<br/>[NotionPage.js]"]
  node_dashboard["User dashboard<br/>[DashboardBody.js]"]
end

subgraph group_engagement["Discovery and engagement"]
  node_search["Algolia search"]
  node_comments["Comments<br/>[Comment.js]"]
  node_share["Sharing<br/>[ShareBar.js]"]
  node_publishing["SEO and feeds<br/>[sitemap.js]"]
end

subgraph group_platform["Operations and integrations"]
  node_ai["AI chat endpoints<br/>[ai-chat.ts]"]
  node_integrations["Site integrations"]
end

node_author(("Site author"))
node_notion[("Notion workspace")]
node_algolia[("Algolia")]
node_commentproviders["Comment providers"]
node_visitors(("Site visitors"))

node_author -->|"authors content"| node_notion
node_notion -->|"supplies content"| node_site
node_site -.->|"uses adapter"| node_notionadapter
node_notionadapter -.->|"fetches content"| node_notion
node_site -.->|"processes content"| node_processors
node_routes -.->|"renders theme"| node_themes
node_themes -->|"renders content"| node_notionpage
node_config -.->|"configures theme"| node_themes
node_visitors -.->|"requests pages"| node_routes
node_visitors -.->|"searches site"| node_search
node_search -->|"queries index"| node_algolia
node_search -->|"reads settings"| node_config
node_themes -->|"uses comments"| node_comments
node_comments -->|"loads providers"| node_commentproviders
node_themes -->|"uses sharing"| node_share
node_visitors -.->|"accesses published pages"| node_publishing
node_visitors -.->|"opens dashboard"| node_dashboard
node_visitors -.->|"requests AI chat"| node_ai
node_themes -.->|"uses site features"| node_integrations

click node_site "https://github.com/notionnext-org/notionnext/blob/main/lib/site/site.service.ts"
click node_notionadapter "https://github.com/notionnext-org/notionnext/tree/main/lib/site/adapters/notion"
click node_processors "https://github.com/notionnext-org/notionnext/tree/main/lib/site/processors"
click node_config "https://github.com/notionnext-org/notionnext/blob/main/lib/config.js"
click node_routes "https://github.com/notionnext-org/notionnext/tree/main/pages"
click node_themes "https://github.com/notionnext-org/notionnext/tree/main/themes"
click node_notionpage "https://github.com/notionnext-org/notionnext/blob/main/components/NotionPage.js"
click node_dashboard "https://github.com/notionnext-org/notionnext/blob/main/components/ui/dashboard/DashboardBody.js"
click node_search "https://github.com/notionnext-org/notionnext/blob/main/components/AlgoliaSearchModal.js"
click node_comments "https://github.com/notionnext-org/notionnext/blob/main/components/Comment.js"
click node_share "https://github.com/notionnext-org/notionnext/blob/main/components/ShareBar.js"
click node_publishing "https://github.com/notionnext-org/notionnext/blob/main/lib/utils/sitemap.js"
click node_ai "https://github.com/notionnext-org/notionnext/blob/main/functions/api/ai-chat.ts"
click node_integrations "https://github.com/notionnext-org/notionnext/tree/main/components"

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_site,node_notionadapter,node_processors,node_config toneBlue
class node_routes,node_themes,node_notionpage,node_dashboard,node_notion,node_algolia toneAmber
class node_search,node_comments,node_share,node_publishing toneMint
class node_ai,node_integrations toneRose
class node_author,node_commentproviders,node_visitors toneIndigo
```

## Components

### Content pipeline

- [Site data service](https://github.com/notionnext-org/notionnext/blob/main/lib/site/site.service.ts): `lib/site/site.service.ts`
- [Notion adapter](https://github.com/notionnext-org/notionnext/tree/main/lib/site/adapters/notion): `lib/site/adapters/notion`
- [Content processors](https://github.com/notionnext-org/notionnext/tree/main/lib/site/processors): `lib/site/processors`
- [Site configuration](https://github.com/notionnext-org/notionnext/blob/main/lib/config.js): `lib/config.js`

### Site experience

- [Page routes](https://github.com/notionnext-org/notionnext/tree/main/pages): `pages`
- [Theme renderer](https://github.com/notionnext-org/notionnext/tree/main/themes): `themes`
- [Notion page view](https://github.com/notionnext-org/notionnext/blob/main/components/NotionPage.js): `components/NotionPage.js`
- [User dashboard](https://github.com/notionnext-org/notionnext/blob/main/components/ui/dashboard/DashboardBody.js): `components/ui/dashboard/DashboardBody.js`

### Discovery and engagement

- [Algolia search](https://github.com/notionnext-org/notionnext/blob/main/components/AlgoliaSearchModal.js): `components/AlgoliaSearchModal.js`
- [Comments](https://github.com/notionnext-org/notionnext/blob/main/components/Comment.js): `components/Comment.js`
- [Sharing](https://github.com/notionnext-org/notionnext/blob/main/components/ShareBar.js): `components/ShareBar.js`
- [SEO and feeds](https://github.com/notionnext-org/notionnext/blob/main/lib/utils/sitemap.js): `lib/utils/sitemap.js`

### Operations and integrations

- [AI chat endpoints](https://github.com/notionnext-org/notionnext/blob/main/functions/api/ai-chat.ts): `functions/api/ai-chat.ts`
- [Site integrations](https://github.com/notionnext-org/notionnext/tree/main/components): `components`

### Other components

- **Site author**
- **Notion workspace**
- **Algolia**
- **Comment providers**
- **Site visitors**

## Connections

- Site author → Notion workspace: authors content (evidence: `README.md`)
- Notion workspace → Site data service: supplies content (evidence: `README.md`)
- Site data service → Notion adapter: uses adapter
- Notion adapter → Notion workspace: fetches content
- Site data service → Content processors: processes content
- Page routes → Theme renderer: renders theme
- Theme renderer → Notion page view: renders content (evidence: `themes/gitbook/index.js`)
- Site configuration → Theme renderer: configures theme (evidence: `themes/opc/index.js`)
- Site visitors → Page routes: requests pages
- Site visitors → Algolia search: searches site
- Algolia search → Algolia: queries index (evidence: `components/AlgoliaSearchModal.js`)
- Algolia search → Site configuration: reads settings (evidence: `components/AlgoliaSearchModal.js`)
- Theme renderer → Comments: uses comments (evidence: `themes/gitbook/index.js`)
- Comments → Comment providers: loads providers (evidence: `components/Comment.js`)
- Theme renderer → Sharing: uses sharing (evidence: `themes/gitbook/index.js`)
- Site visitors → SEO and feeds: accesses published pages
- Site visitors → User dashboard: opens dashboard
- Site visitors → AI chat endpoints: requests AI chat
- Theme renderer → Site integrations: uses site features (evidence: `themes/opc/index.js`)
