# nangua-qwq/signgenerator architecture

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

## Overview

sign-generator is a browser-based road-sign editor: users manage sign designs in a workspace, choose a sign template, edit its data, and inspect a generated SVG preview. The principal runtime path runs from the editor through workspace state to the selected-sign preview and template renderer. Font loading and reusable SVG/text rendering support that path; saved workspace state and the completion page are separate product surfaces. The README is only a project title, so feature details beyond the sampled runtime are limited to source names and references.

Main entry points: [`src/app/generators/generator.tsx`](https://github.com/nangua-qwq/signgenerator/blob/main/src/app/generators/generator.tsx) (Template dispatcher), [`src/app/fonts/FontContext.tsx`](https://github.com/nangua-qwq/signgenerator/blob/main/src/app/fonts/FontContext.tsx) (Font context), [`src/app/generators/exit/two-lane-interchange-exit.tsx`](https://github.com/nangua-qwq/signgenerator/blob/main/src/app/generators/exit/two-lane-interchange-exit.tsx) (Exit signs), [`src/app/generators/interchange/entrance-preview-two-directions.tsx`](https://github.com/nangua-qwq/signgenerator/blob/main/src/app/generators/interchange/entrance-preview-two-directions.tsx) (Interchange signs)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_editing["Sign editing"]
  node_editor["Editor page<br/>[page.tsx]"]
  node_toolbar["Preview toolbar<br/>[index.tsx]"]
  node_created["Created page<br/>[page.tsx]"]
end

subgraph group_workspace["Workspace state"]
  node_store["Workspace actions"]
  node_storage[("Workspace persistence")]
  node_signmodel["Sign normalization<br/>[sign-model.ts]"]
end

subgraph group_rendering["SVG rendering"]
  node_preview["Sign preview<br/>[SignPreview.tsx]"]
  node_dispatcher["Template dispatcher<br/>[generator.tsx]"]
  node_exit["Exit signs"]
  node_interchange["Interchange signs"]
  node_fork["Road fork sign"]
  node_expressway["Expressway sign<br/>[expressway.tsx]"]
  node_ordinary["Ordinary road sign<br/>[ordinary_road.tsx]"]
  node_svg["Raw SVG wrapper<br/>[raw-svg.tsx]"]
  node_text["Outlined text<br/>[svg-text.tsx]"]
end

subgraph group_fonts["Font services"]
  node_fontsprovider["Font provider<br/>[FontsProvider.tsx]"]
  node_fontcontext["Font context<br/>[FontContext.tsx]"]
  node_fontbuffers["Font buffers<br/>[loadFontBuffers.ts]"]
  node_fontroute["Font route<br/>[route.ts]"]
end

node_user(("Sign editor"))

node_user -->|"edits signs"| node_editor
node_editor -->|"updates workspace"| node_store
node_toolbar -->|"reads workspace"| node_store
node_store -->|"persists state"| node_storage
node_storage -->|"restores signs"| node_signmodel
node_preview -->|"selects sign"| node_store
node_preview -->|"renders sign"| node_dispatcher
node_dispatcher -->|"dispatches template"| node_exit
node_dispatcher -->|"dispatches template"| node_interchange
node_dispatcher -->|"dispatches template"| node_fork
node_dispatcher -->|"dispatches template"| node_expressway
node_dispatcher -->|"dispatches template"| node_ordinary
node_exit -->|"wraps SVG"| node_svg
node_interchange -->|"wraps SVG"| node_svg
node_fork -->|"wraps SVG"| node_svg
node_exit -->|"renders route shields"| node_expressway
node_interchange -->|"renders route shields"| node_expressway
node_fork -->|"renders route shields"| node_expressway
node_exit -->|"renders labels"| node_text
node_interchange -->|"renders labels"| node_text
node_fork -->|"renders labels"| node_text
node_expressway -->|"lays out glyphs"| node_text
node_fontsprovider -->|"provides fonts"| node_fontcontext
node_fontcontext -->|"uses buffers"| node_fontbuffers
node_fontroute -->|"serves fonts"| node_fontbuffers
node_preview -->|"checks font readiness"| node_fontcontext
node_exit -->|"gets fonts"| node_fontcontext
node_interchange -->|"gets fonts"| node_fontcontext
node_fork -->|"gets fonts"| node_fontcontext

click node_editor "https://github.com/nangua-qwq/signgenerator/blob/main/src/app/page.tsx"
click node_toolbar "https://github.com/nangua-qwq/signgenerator/blob/main/src/app/PreviewToolbar/index.tsx"
click node_created "https://github.com/nangua-qwq/signgenerator/blob/main/src/app/created/page.tsx"
click node_store "https://github.com/nangua-qwq/signgenerator/blob/main/src/app/state/sign-workspace-store.ts"
click node_storage "https://github.com/nangua-qwq/signgenerator/blob/main/src/app/state/workspace-storage.ts"
click node_preview "https://github.com/nangua-qwq/signgenerator/blob/main/src/app/SignPreview.tsx"
click node_dispatcher "https://github.com/nangua-qwq/signgenerator/blob/main/src/app/generators/generator.tsx"
click node_exit "https://github.com/nangua-qwq/signgenerator/blob/main/src/app/generators/exit/two-lane-interchange-exit.tsx"
click node_interchange "https://github.com/nangua-qwq/signgenerator/blob/main/src/app/generators/interchange/entrance-preview-two-directions.tsx"
click node_fork "https://github.com/nangua-qwq/signgenerator/blob/main/src/app/generators/interchange/road-fork-preview.tsx"
click node_expressway "https://github.com/nangua-qwq/signgenerator/blob/main/src/app/generators/sign/expressway.tsx"
click node_ordinary "https://github.com/nangua-qwq/signgenerator/blob/main/src/app/generators/sign/ordinary_road.tsx"
click node_svg "https://github.com/nangua-qwq/signgenerator/blob/main/src/app/generators/raw-svg.tsx"
click node_text "https://github.com/nangua-qwq/signgenerator/blob/main/src/app/generators/svg-text.tsx"
click node_fontsprovider "https://github.com/nangua-qwq/signgenerator/blob/main/src/app/fonts/FontsProvider.tsx"
click node_fontcontext "https://github.com/nangua-qwq/signgenerator/blob/main/src/app/fonts/FontContext.tsx"
click node_fontbuffers "https://github.com/nangua-qwq/signgenerator/blob/main/src/app/fonts/loadFontBuffers.ts"
click node_fontroute "https://github.com/nangua-qwq/signgenerator/blob/main/src/app/fonts/%5Bfont%5D/route.ts"
click node_signmodel "https://github.com/nangua-qwq/signgenerator/blob/main/src/app/lib/sign-model.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_editor,node_toolbar,node_created toneBlue
class node_store,node_storage,node_signmodel toneAmber
class node_preview,node_dispatcher,node_exit,node_interchange,node_fork,node_expressway,node_ordinary,node_svg,node_text toneMint
class node_fontsprovider,node_fontcontext,node_fontbuffers,node_fontroute toneRose
class node_user toneIndigo
```

## Components

### Sign editing

- [Editor page](https://github.com/nangua-qwq/signgenerator/blob/main/src/app/page.tsx): `src/app/page.tsx`
- [Preview toolbar](https://github.com/nangua-qwq/signgenerator/blob/main/src/app/PreviewToolbar/index.tsx): `src/app/PreviewToolbar/index.tsx`
- [Created page](https://github.com/nangua-qwq/signgenerator/blob/main/src/app/created/page.tsx): `src/app/created/page.tsx`

### Workspace state

- [Workspace actions](https://github.com/nangua-qwq/signgenerator/blob/main/src/app/state/sign-workspace-store.ts): `src/app/state/sign-workspace-store.ts`
- [Workspace persistence](https://github.com/nangua-qwq/signgenerator/blob/main/src/app/state/workspace-storage.ts): `src/app/state/workspace-storage.ts`
- [Sign normalization](https://github.com/nangua-qwq/signgenerator/blob/main/src/app/lib/sign-model.ts): `src/app/lib/sign-model.ts`

### SVG rendering

- [Sign preview](https://github.com/nangua-qwq/signgenerator/blob/main/src/app/SignPreview.tsx): `src/app/SignPreview.tsx`
- [Template dispatcher](https://github.com/nangua-qwq/signgenerator/blob/main/src/app/generators/generator.tsx): `src/app/generators/generator.tsx`
- [Exit signs](https://github.com/nangua-qwq/signgenerator/blob/main/src/app/generators/exit/two-lane-interchange-exit.tsx): `src/app/generators/exit/two-lane-interchange-exit.tsx`
- [Interchange signs](https://github.com/nangua-qwq/signgenerator/blob/main/src/app/generators/interchange/entrance-preview-two-directions.tsx): `src/app/generators/interchange/entrance-preview-two-directions.tsx`
- [Road fork sign](https://github.com/nangua-qwq/signgenerator/blob/main/src/app/generators/interchange/road-fork-preview.tsx): `src/app/generators/interchange/road-fork-preview.tsx`
- [Expressway sign](https://github.com/nangua-qwq/signgenerator/blob/main/src/app/generators/sign/expressway.tsx): `src/app/generators/sign/expressway.tsx`
- [Ordinary road sign](https://github.com/nangua-qwq/signgenerator/blob/main/src/app/generators/sign/ordinary_road.tsx): `src/app/generators/sign/ordinary_road.tsx`
- [Raw SVG wrapper](https://github.com/nangua-qwq/signgenerator/blob/main/src/app/generators/raw-svg.tsx): `src/app/generators/raw-svg.tsx`
- [Outlined text](https://github.com/nangua-qwq/signgenerator/blob/main/src/app/generators/svg-text.tsx): `src/app/generators/svg-text.tsx`

### Font services

- [Font provider](https://github.com/nangua-qwq/signgenerator/blob/main/src/app/fonts/FontsProvider.tsx): `src/app/fonts/FontsProvider.tsx`
- [Font context](https://github.com/nangua-qwq/signgenerator/blob/main/src/app/fonts/FontContext.tsx): `src/app/fonts/FontContext.tsx`
- [Font buffers](https://github.com/nangua-qwq/signgenerator/blob/main/src/app/fonts/loadFontBuffers.ts): `src/app/fonts/loadFontBuffers.ts`
- [Font route](https://github.com/nangua-qwq/signgenerator/blob/main/src/app/fonts/%5Bfont%5D/route.ts): `src/app/fonts/[font]/route.ts`

### Other components

- **Sign editor**

## Connections

- Sign editor → Editor page: edits signs (evidence: `src/app/page.tsx`)
- Editor page → Workspace actions: updates workspace (evidence: `src/app/page.tsx`)
- Preview toolbar → Workspace actions: reads workspace (evidence: `src/app/PreviewToolbar/index.tsx`)
- Workspace actions → Workspace persistence: persists state (evidence: `src/app/state/sign-workspace-store.ts`)
- Workspace persistence → Sign normalization: restores signs (evidence: `src/app/state/workspace-storage.ts`)
- Sign preview → Workspace actions: selects sign (evidence: `src/app/SignPreview.tsx`)
- Sign preview → Template dispatcher: renders sign (evidence: `src/app/SignPreview.tsx`)
- Template dispatcher → Exit signs: dispatches template (evidence: `src/app/generators/generator.tsx`)
- Template dispatcher → Interchange signs: dispatches template (evidence: `src/app/generators/generator.tsx`)
- Template dispatcher → Road fork sign: dispatches template (evidence: `src/app/generators/generator.tsx`)
- Template dispatcher → Expressway sign: dispatches template (evidence: `src/app/generators/generator.tsx`)
- Template dispatcher → Ordinary road sign: dispatches template (evidence: `src/app/generators/generator.tsx`)
- Exit signs → Raw SVG wrapper: wraps SVG (evidence: `src/app/generators/exit/two-lane-interchange-exit.tsx`)
- Interchange signs → Raw SVG wrapper: wraps SVG (evidence: `src/app/generators/interchange/entrance-preview-two-directions.tsx`)
- Road fork sign → Raw SVG wrapper: wraps SVG (evidence: `src/app/generators/interchange/road-fork-preview.tsx`)
- Exit signs → Expressway sign: renders route shields (evidence: `src/app/generators/exit/two-lane-interchange-exit.tsx`)
- Interchange signs → Expressway sign: renders route shields (evidence: `src/app/generators/interchange/entrance-preview-two-directions.tsx`)
- Road fork sign → Expressway sign: renders route shields (evidence: `src/app/generators/interchange/road-fork-preview.tsx`)
- Exit signs → Outlined text: renders labels (evidence: `src/app/generators/exit/two-lane-interchange-exit.tsx`)
- Interchange signs → Outlined text: renders labels (evidence: `src/app/generators/interchange/entrance-preview-two-directions.tsx`)
- Road fork sign → Outlined text: renders labels (evidence: `src/app/generators/interchange/road-fork-preview.tsx`)
- Expressway sign → Outlined text: lays out glyphs (evidence: `src/app/generators/sign/expressway.tsx`)
- Font provider → Font context: provides fonts (evidence: `src/app/fonts/FontsProvider.tsx`)
- Font context → Font buffers: uses buffers (evidence: `src/app/fonts/FontContext.tsx`)
- Font route → Font buffers: serves fonts (evidence: `src/app/fonts/[font]/route.ts`)
- Sign preview → Font context: checks font readiness (evidence: `src/app/SignPreview.tsx`)
- Exit signs → Font context: gets fonts (evidence: `src/app/generators/exit/two-lane-interchange-exit.tsx`)
- Interchange signs → Font context: gets fonts (evidence: `src/app/generators/interchange/entrance-preview-two-directions.tsx`)
- Road fork sign → Font context: gets fonts (evidence: `src/app/generators/interchange/road-fork-preview.tsx`)
