# krehantgajjar10/colorforge architecture

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

- Interactive diagram: https://gitdiagram.com/krehantgajjar10/colorforge
- Repository: https://github.com/krehantgajjar10/colorforge

## Overview

ColorForge is a browser-based theme and palette customization workspace. Users enter through the landing page, open the editor, choose or customize a palette, inspect it in live interface previews, and save, share, or export the result. Appearance, typography, and global radius settings are also configurable and preserved in browser storage. The README documents these capabilities and routes; most implementation files were not excerpted, so links between those subsystems are based on that documentation rather than inspected call sites.

Main entry points: [`colorforge/src/pages/HomePage.tsx`](https://github.com/krehantgajjar10/colorforge/blob/main/colorforge/src/pages/HomePage.tsx) (Editor workspace), [`colorforge/src/App.tsx`](https://github.com/krehantgajjar10/colorforge/blob/main/colorforge/src/App.tsx) (React app and routes), [`colorforge/src/components/palette/PalettePreview.tsx`](https://github.com/krehantgajjar10/colorforge/blob/main/colorforge/src/components/palette/PalettePreview.tsx) (Palette preview), [`colorforge/src/context/useTheme.ts`](https://github.com/krehantgajjar10/colorforge/blob/main/colorforge/src/context/useTheme.ts) (Theme state)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application"]
  node_app["React app and routes<br/>[App.tsx]"]
  node_landing["Landing page<br/>[LandingPage.tsx]"]
  node_workspace["Editor workspace<br/>[HomePage.tsx]"]
end

subgraph group_palette["Palette Workflow"]
  node_palette_gallery["Palette gallery<br/>[PaletteGallery.tsx]"]
  node_palette_editor["Palette editor<br/>[PaletteEditor.tsx]"]
  node_palette_preview["Palette preview<br/>[PalettePreview.tsx]"]
end

subgraph group_design["Theme Design"]
  node_theme_state["Theme state<br/>[useTheme.ts]"]
  node_theme_tokens["Theme token definitions<br/>[themeTokens.ts]"]
  node_previews["Interface previews"]
  node_typography["Typography settings"]
  node_design_settings["Global design settings<br/>[OtherSettings.tsx]"]
end

subgraph group_persistence["Persistence and Export"]
  node_saved_gallery["Saved palettes"]
  node_save_dialog["Save palette dialog"]
  node_share_link["Palette sharing"]
  node_json_export["Palette JSON export<br/>[exportPalette.ts]"]
  node_css_export["CSS theme export"]
  node_browser_storage[("Browser local storage")]
end

node_user(("Browser user"))

node_user -->|"opens"| node_app
node_app -->|"routes to"| node_landing
node_app -->|"routes to"| node_workspace
node_workspace -->|"offers palettes"| node_palette_gallery
node_workspace -->|"customizes"| node_palette_editor
node_workspace -->|"previews palette"| node_palette_preview
node_workspace -->|"shows layouts"| node_previews
node_workspace -->|"configures fonts"| node_typography
node_workspace -->|"configures radius"| node_design_settings
node_palette_editor -.->|"updates theme"| node_theme_state
node_palette_preview -->|"reads definitions"| node_theme_tokens
node_palette_preview -->|"reads mode"| node_theme_state
node_workspace -->|"saves palette"| node_save_dialog
node_save_dialog -->|"persists palette"| node_browser_storage
node_workspace -->|"reuses palettes"| node_saved_gallery
node_saved_gallery -->|"loads palettes"| node_browser_storage
node_workspace -->|"creates share links"| node_share_link
node_user -->|"opens shared link"| node_share_link
node_workspace -->|"exports palette"| node_json_export
node_workspace -->|"exports CSS"| node_css_export
node_theme_state -->|"preserves preferences"| node_browser_storage
node_typography -->|"preserves font"| node_browser_storage
node_design_settings -->|"preserves radius"| node_browser_storage

click node_app "https://github.com/krehantgajjar10/colorforge/blob/main/colorforge/src/App.tsx"
click node_landing "https://github.com/krehantgajjar10/colorforge/blob/main/colorforge/src/pages/LandingPage.tsx"
click node_workspace "https://github.com/krehantgajjar10/colorforge/blob/main/colorforge/src/pages/HomePage.tsx"
click node_palette_gallery "https://github.com/krehantgajjar10/colorforge/blob/main/colorforge/src/components/palette/PaletteGallery.tsx"
click node_palette_editor "https://github.com/krehantgajjar10/colorforge/blob/main/colorforge/src/components/palette/PaletteEditor.tsx"
click node_palette_preview "https://github.com/krehantgajjar10/colorforge/blob/main/colorforge/src/components/palette/PalettePreview.tsx"
click node_saved_gallery "https://github.com/krehantgajjar10/colorforge/blob/main/colorforge/src/components/palette/SavedPaletteGallery.tsx"
click node_save_dialog "https://github.com/krehantgajjar10/colorforge/blob/main/colorforge/src/components/palette/SavePaletteDialog.tsx"
click node_share_link "https://github.com/krehantgajjar10/colorforge/blob/main/colorforge/src/utils/createPaletteShareUrl.ts"
click node_json_export "https://github.com/krehantgajjar10/colorforge/blob/main/colorforge/src/utils/exportPalette.ts"
click node_css_export "https://github.com/krehantgajjar10/colorforge/blob/main/colorforge/src/components/palette/ExportCssDialog.tsx"
click node_theme_state "https://github.com/krehantgajjar10/colorforge/blob/main/colorforge/src/context/useTheme.ts"
click node_theme_tokens "https://github.com/krehantgajjar10/colorforge/blob/main/colorforge/src/data/themeTokens.ts"
click node_previews "https://github.com/krehantgajjar10/colorforge/tree/main/colorforge/src/features/editor/components"
click node_typography "https://github.com/krehantgajjar10/colorforge/blob/main/colorforge/src/features/editor/components/TypographySettings.tsx"
click node_design_settings "https://github.com/krehantgajjar10/colorforge/blob/main/colorforge/src/features/editor/components/OtherSettings.tsx"

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_landing,node_workspace,node_user toneBlue
class node_palette_gallery,node_palette_editor,node_palette_preview toneAmber
class node_theme_state,node_theme_tokens,node_previews,node_typography,node_design_settings toneMint
class node_saved_gallery,node_save_dialog,node_share_link,node_json_export,node_css_export,node_browser_storage toneRose
```

## Components

### Application

- [React app and routes](https://github.com/krehantgajjar10/colorforge/blob/main/colorforge/src/App.tsx): `colorforge/src/App.tsx`
- [Landing page](https://github.com/krehantgajjar10/colorforge/blob/main/colorforge/src/pages/LandingPage.tsx): `colorforge/src/pages/LandingPage.tsx`
- [Editor workspace](https://github.com/krehantgajjar10/colorforge/blob/main/colorforge/src/pages/HomePage.tsx): `colorforge/src/pages/HomePage.tsx`

### Palette Workflow

- [Palette gallery](https://github.com/krehantgajjar10/colorforge/blob/main/colorforge/src/components/palette/PaletteGallery.tsx): `colorforge/src/components/palette/PaletteGallery.tsx`
- [Palette editor](https://github.com/krehantgajjar10/colorforge/blob/main/colorforge/src/components/palette/PaletteEditor.tsx): `colorforge/src/components/palette/PaletteEditor.tsx`
- [Palette preview](https://github.com/krehantgajjar10/colorforge/blob/main/colorforge/src/components/palette/PalettePreview.tsx): `colorforge/src/components/palette/PalettePreview.tsx`

### Theme Design

- [Theme state](https://github.com/krehantgajjar10/colorforge/blob/main/colorforge/src/context/useTheme.ts): `colorforge/src/context/useTheme.ts`
- [Theme token definitions](https://github.com/krehantgajjar10/colorforge/blob/main/colorforge/src/data/themeTokens.ts): `colorforge/src/data/themeTokens.ts`
- [Interface previews](https://github.com/krehantgajjar10/colorforge/tree/main/colorforge/src/features/editor/components): `colorforge/src/features/editor/components`
- [Typography settings](https://github.com/krehantgajjar10/colorforge/blob/main/colorforge/src/features/editor/components/TypographySettings.tsx): `colorforge/src/features/editor/components/TypographySettings.tsx`
- [Global design settings](https://github.com/krehantgajjar10/colorforge/blob/main/colorforge/src/features/editor/components/OtherSettings.tsx): `colorforge/src/features/editor/components/OtherSettings.tsx`

### Persistence and Export

- [Saved palettes](https://github.com/krehantgajjar10/colorforge/blob/main/colorforge/src/components/palette/SavedPaletteGallery.tsx): `colorforge/src/components/palette/SavedPaletteGallery.tsx`
- [Save palette dialog](https://github.com/krehantgajjar10/colorforge/blob/main/colorforge/src/components/palette/SavePaletteDialog.tsx): `colorforge/src/components/palette/SavePaletteDialog.tsx`
- [Palette sharing](https://github.com/krehantgajjar10/colorforge/blob/main/colorforge/src/utils/createPaletteShareUrl.ts): `colorforge/src/utils/createPaletteShareUrl.ts`
- [Palette JSON export](https://github.com/krehantgajjar10/colorforge/blob/main/colorforge/src/utils/exportPalette.ts): `colorforge/src/utils/exportPalette.ts`
- [CSS theme export](https://github.com/krehantgajjar10/colorforge/blob/main/colorforge/src/components/palette/ExportCssDialog.tsx): `colorforge/src/components/palette/ExportCssDialog.tsx`
- **Browser local storage**

### Other components

- **Browser user**

## Connections

- Browser user → React app and routes: opens (evidence: `README.md`)
- React app and routes → Landing page: routes to (evidence: `README.md`)
- React app and routes → Editor workspace: routes to (evidence: `README.md`)
- Editor workspace → Palette gallery: offers palettes (evidence: `README.md`)
- Editor workspace → Palette editor: customizes (evidence: `README.md`)
- Editor workspace → Palette preview: previews palette (evidence: `README.md`)
- Editor workspace → Interface previews: shows layouts (evidence: `README.md`)
- Editor workspace → Typography settings: configures fonts (evidence: `README.md`)
- Editor workspace → Global design settings: configures radius (evidence: `README.md`)
- Palette editor → Theme state: updates theme
- Palette preview → Theme token definitions: reads definitions (evidence: `colorforge/src/components/palette/PalettePreview.tsx`)
- Palette preview → Theme state: reads mode (evidence: `colorforge/src/components/palette/PalettePreview.tsx`)
- Editor workspace → Save palette dialog: saves palette (evidence: `README.md`)
- Save palette dialog → Browser local storage: persists palette (evidence: `README.md`)
- Editor workspace → Saved palettes: reuses palettes (evidence: `README.md`)
- Saved palettes → Browser local storage: loads palettes (evidence: `README.md`)
- Editor workspace → Palette sharing: creates share links (evidence: `README.md`)
- Browser user → Palette sharing: opens shared link (evidence: `README.md`)
- Editor workspace → Palette JSON export: exports palette (evidence: `README.md`)
- Editor workspace → CSS theme export: exports CSS (evidence: `README.md`)
- Theme state → Browser local storage: preserves preferences (evidence: `README.md`)
- Typography settings → Browser local storage: preserves font (evidence: `README.md`)
- Global design settings → Browser local storage: preserves radius (evidence: `README.md`)
