# inkonchain/docs architecture

> Architecture diagram of the GitHub repository inkonchain/docs, 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/inkonchain/docs
- Repository: https://github.com/inkonchain/docs

## Overview

InkChain Documentation App is a Next.js Pages Router documentation site using Nextra. Readers enter through the home page or navigation, find documentation through search and section links, read topic pages, and can copy or view rendered content as Markdown. The repository also contains network and ecosystem content wrappers, interactive branding, and shared documentation chrome. The graph follows the documented app setup and sampled imports/calls; most content routes and several wrappers were not sampled, so their internal behavior and links are not inferred.

Main entry points: [`theme.config.tsx`](https://github.com/inkonchain/docs/blob/main/theme.config.tsx) (Nextra theme config), [`src/pages/_app.tsx`](https://github.com/inkonchain/docs/blob/main/src/pages/_app.tsx) (Pages app shell), [`src/components/Home/HomeSections.tsx`](https://github.com/inkonchain/docs/blob/main/src/components/Home/HomeSections.tsx) (Home sections), [`src/pages`](https://github.com/inkonchain/docs/tree/main/src/pages) (Documentation pages)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_site["Site runtime"]
  node_app["Pages app shell<br/>[_app.tsx]"]
  node_theme["Nextra theme config<br/>[theme.config.tsx]"]
end

subgraph group_content["Documentation content"]
  node_home["Home sections<br/>[HomeSections.tsx]"]
  node_docs["Documentation pages"]
  node_homeicons["Home card icons<br/>[icons.tsx]"]
  node_network["Network information<br/>[networks.ts]"]
  node_contentwrappers["Ecosystem content wrappers"]
end

subgraph group_reader["Reader features"]
  node_search["Documentation search<br/>[SearchBar.tsx]"]
  node_pageactions["Page actions<br/>[PageActions.tsx]"]
  node_markdown["Rendered-page Markdown"]
  node_copytoast["Copy confirmation<br/>[CopyToast.tsx]"]
  node_inkhero["Interactive Ink hero"]
  node_ascii["Interactive ASCII art"]
end

subgraph group_chrome["Shared presentation"]
  node_chrome["Page chrome"]
  node_footer["Site footer<br/>[Footer.tsx]"]
  node_navbar["Navbar actions<br/>[NavbarActions.tsx]"]
  node_themecontrol["Theme toggle<br/>[ThemeToggle.tsx]"]
  node_toc["Table of contents<br/>[Toc.tsx]"]
  node_pagepresentation["Page title and layout<br/>[PageMain.tsx]"]
  node_typewriter["Typewriter display<br/>[Typewriter.tsx]"]
  node_inkmark["Ink brand mark<br/>[InkMark.tsx]"]
  node_urls["Site link constants<br/>[urls.ts]"]
end

node_reader(("Documentation reader"))

node_reader -->|"opens site"| node_app
node_app -->|"renders"| node_search
node_app -->|"renders"| node_copytoast
node_app -->|"uses theme setup"| node_theme
node_theme -->|"configures footer"| node_footer
node_theme -->|"configures navbar"| node_navbar
node_theme -->|"configures TOC"| node_toc
node_theme -->|"configures layout"| node_pagepresentation
node_theme -->|"renders banner text"| node_typewriter
node_theme -->|"sets repository link"| node_urls
node_navbar -->|"renders toggle"| node_themecontrol
node_footer -->|"renders mark"| node_inkmark
node_footer -->|"uses links"| node_urls
node_home -->|"renders card icons"| node_homeicons
node_home -->|"renders heading"| node_typewriter
node_home -->|"loads interactive art"| node_ascii
node_home -->|"links to topics"| node_docs
node_search -.->|"searches documentation"| node_docs
node_pageactions -->|"converts page DOM"| node_markdown
node_pageactions -->|"notifies on copy"| node_copytoast
node_app -->|"applies stored tune"| node_inkhero
node_contentwrappers -.->|"supplies page content"| node_docs
node_network -.->|"supports network topics"| node_docs

click node_app "https://github.com/inkonchain/docs/blob/main/src/pages/_app.tsx"
click node_theme "https://github.com/inkonchain/docs/blob/main/theme.config.tsx"
click node_home "https://github.com/inkonchain/docs/blob/main/src/components/Home/HomeSections.tsx"
click node_docs "https://github.com/inkonchain/docs/tree/main/src/pages"
click node_homeicons "https://github.com/inkonchain/docs/blob/main/src/components/Home/icons.tsx"
click node_network "https://github.com/inkonchain/docs/blob/main/src/utils/networks.ts"
click node_contentwrappers "https://github.com/inkonchain/docs/tree/main/src/components"
click node_search "https://github.com/inkonchain/docs/blob/main/src/components/SearchBar.tsx"
click node_pageactions "https://github.com/inkonchain/docs/blob/main/src/components/PageActions.tsx"
click node_markdown "https://github.com/inkonchain/docs/blob/main/src/utils/page-to-markdown.ts"
click node_copytoast "https://github.com/inkonchain/docs/blob/main/src/components/CopyToast.tsx"
click node_inkhero "https://github.com/inkonchain/docs/tree/main/src/components/InkHero"
click node_ascii "https://github.com/inkonchain/docs/blob/main/src/components/NotFound/interactive-ascii.ts"
click node_chrome "https://github.com/inkonchain/docs/tree/main/src/components"
click node_footer "https://github.com/inkonchain/docs/blob/main/src/components/Footer.tsx"
click node_navbar "https://github.com/inkonchain/docs/blob/main/src/components/NavbarActions.tsx"
click node_themecontrol "https://github.com/inkonchain/docs/blob/main/src/components/ThemeToggle.tsx"
click node_toc "https://github.com/inkonchain/docs/blob/main/src/components/Toc.tsx"
click node_pagepresentation "https://github.com/inkonchain/docs/blob/main/src/components/PageMain.tsx"
click node_typewriter "https://github.com/inkonchain/docs/blob/main/src/components/Typewriter.tsx"
click node_inkmark "https://github.com/inkonchain/docs/blob/main/src/icons/InkMark.tsx"
click node_urls "https://github.com/inkonchain/docs/blob/main/src/utils/urls.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_app,node_theme toneBlue
class node_home,node_docs,node_homeicons,node_network,node_contentwrappers toneAmber
class node_search,node_pageactions,node_markdown,node_copytoast,node_inkhero,node_ascii toneMint
class node_chrome,node_footer,node_navbar,node_themecontrol,node_toc,node_pagepresentation,node_typewriter,node_inkmark,node_urls toneRose
class node_reader toneIndigo
```

## Components

### Site runtime

- [Pages app shell](https://github.com/inkonchain/docs/blob/main/src/pages/_app.tsx): `src/pages/_app.tsx`
- [Nextra theme config](https://github.com/inkonchain/docs/blob/main/theme.config.tsx): `theme.config.tsx`

### Documentation content

- [Home sections](https://github.com/inkonchain/docs/blob/main/src/components/Home/HomeSections.tsx): `src/components/Home/HomeSections.tsx`
- [Documentation pages](https://github.com/inkonchain/docs/tree/main/src/pages): `src/pages`
- [Home card icons](https://github.com/inkonchain/docs/blob/main/src/components/Home/icons.tsx): `src/components/Home/icons.tsx`
- [Network information](https://github.com/inkonchain/docs/blob/main/src/utils/networks.ts): `src/utils/networks.ts`
- [Ecosystem content wrappers](https://github.com/inkonchain/docs/tree/main/src/components): `src/components`

### Reader features

- [Documentation search](https://github.com/inkonchain/docs/blob/main/src/components/SearchBar.tsx): `src/components/SearchBar.tsx`
- [Page actions](https://github.com/inkonchain/docs/blob/main/src/components/PageActions.tsx): `src/components/PageActions.tsx`
- [Rendered-page Markdown](https://github.com/inkonchain/docs/blob/main/src/utils/page-to-markdown.ts): `src/utils/page-to-markdown.ts`
- [Copy confirmation](https://github.com/inkonchain/docs/blob/main/src/components/CopyToast.tsx): `src/components/CopyToast.tsx`
- [Interactive Ink hero](https://github.com/inkonchain/docs/tree/main/src/components/InkHero): `src/components/InkHero`
- [Interactive ASCII art](https://github.com/inkonchain/docs/blob/main/src/components/NotFound/interactive-ascii.ts): `src/components/NotFound/interactive-ascii.ts`

### Shared presentation

- [Page chrome](https://github.com/inkonchain/docs/tree/main/src/components): `src/components`
- [Site footer](https://github.com/inkonchain/docs/blob/main/src/components/Footer.tsx): `src/components/Footer.tsx`
- [Navbar actions](https://github.com/inkonchain/docs/blob/main/src/components/NavbarActions.tsx): `src/components/NavbarActions.tsx`
- [Theme toggle](https://github.com/inkonchain/docs/blob/main/src/components/ThemeToggle.tsx): `src/components/ThemeToggle.tsx`
- [Table of contents](https://github.com/inkonchain/docs/blob/main/src/components/Toc.tsx): `src/components/Toc.tsx`
- [Page title and layout](https://github.com/inkonchain/docs/blob/main/src/components/PageMain.tsx): `src/components/PageMain.tsx`
- [Typewriter display](https://github.com/inkonchain/docs/blob/main/src/components/Typewriter.tsx): `src/components/Typewriter.tsx`
- [Ink brand mark](https://github.com/inkonchain/docs/blob/main/src/icons/InkMark.tsx): `src/icons/InkMark.tsx`
- [Site link constants](https://github.com/inkonchain/docs/blob/main/src/utils/urls.ts): `src/utils/urls.ts`

### Other components

- **Documentation reader**

## Connections

- Documentation reader → Pages app shell: opens site (evidence: `README.md`)
- Pages app shell → Documentation search: renders (evidence: `src/pages/_app.tsx`)
- Pages app shell → Copy confirmation: renders (evidence: `src/pages/_app.tsx`)
- Pages app shell → Nextra theme config: uses theme setup (evidence: `README.md`)
- Nextra theme config → Site footer: configures footer (evidence: `theme.config.tsx`)
- Nextra theme config → Navbar actions: configures navbar (evidence: `theme.config.tsx`)
- Nextra theme config → Table of contents: configures TOC (evidence: `theme.config.tsx`)
- Nextra theme config → Page title and layout: configures layout (evidence: `theme.config.tsx`)
- Nextra theme config → Typewriter display: renders banner text (evidence: `theme.config.tsx`)
- Nextra theme config → Site link constants: sets repository link (evidence: `theme.config.tsx`)
- Navbar actions → Theme toggle: renders toggle (evidence: `src/components/NavbarActions.tsx`)
- Site footer → Ink brand mark: renders mark (evidence: `src/components/Footer.tsx`)
- Site footer → Site link constants: uses links (evidence: `src/components/Footer.tsx`)
- Home sections → Home card icons: renders card icons (evidence: `src/components/Home/HomeSections.tsx`)
- Home sections → Typewriter display: renders heading (evidence: `src/components/Home/HomeSections.tsx`)
- Home sections → Interactive ASCII art: loads interactive art (evidence: `src/components/Home/HomeSections.tsx`)
- Home sections → Documentation pages: links to topics (evidence: `src/components/Home/HomeSections.tsx`)
- Documentation search → Documentation pages: searches documentation (evidence: `src/pages/_app.tsx`)
- Page actions → Rendered-page Markdown: converts page DOM (evidence: `src/components/PageActions.tsx`)
- Page actions → Copy confirmation: notifies on copy (evidence: `src/components/PageActions.tsx`)
- Pages app shell → Interactive Ink hero: applies stored tune (evidence: `src/pages/_app.tsx`)
- Ecosystem content wrappers → Documentation pages: supplies page content (evidence: `src/pages/_app.tsx`)
- Network information → Documentation pages: supports network topics
