# flessan/rekaluna-dev architecture

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

- Interactive diagram: https://gitdiagram.com/flessan/rekaluna-dev
- Repository: https://github.com/flessan/rekaluna-dev

## Overview

Rekaluna is a local-first browser workspace for print-shop operators. The main workflow enters through the workspace shell, then branches into Quick Print for arranging and printing images, Price Desk for service totals and cash/change checks, or Resources for finding and managing tools. Settings, favorites, history, and preferences persist on-device; localization and command search support navigation across the workspace. The graph reflects README capabilities and indexed imports, while unsampled implementation details and unverified runtime links are omitted.

Main entry points: [`src/components/AppShell.tsx`](https://github.com/flessan/rekaluna-dev/blob/main/src/components/AppShell.tsx) (App Shell), [`src/lib/storage.ts`](https://github.com/flessan/rekaluna-dev/blob/main/src/lib/storage.ts) (Local Data Layer), [`src/lib/storage-hooks.ts`](https://github.com/flessan/rekaluna-dev/blob/main/src/lib/storage-hooks.ts) (Storage Hooks), [`src/components/SettingsModal.tsx`](https://github.com/flessan/rekaluna-dev/blob/main/src/components/SettingsModal.tsx) (Settings)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Workspace Navigation"]
  node_shell["App Shell<br/>[AppShell.tsx]"]
  node_workspace["Workspace<br/>[Workspace.tsx]"]
  node_commands["Command Palette<br/>[commands.tsx]"]
  node_mobile["Mobile Sheets<br/>[MobileSheets.tsx]"]
end

subgraph group_tools["Print Shop Tools"]
  node_quickprint["Quick Print<br/>[QuickPrintPage.tsx]"]
  node_pricedesk["Price Desk<br/>[PriceDeskPage.tsx]"]
end

subgraph group_content["Resources and Pages"]
  node_resources["Resource Center<br/>[Resources.tsx]"]
  node_support["Support<br/>[Support.tsx]"]
  node_about["About<br/>[About.tsx]"]
  node_donate["Donate Page<br/>[index.html]"]
end

subgraph group_core["Shared App Services"]
  node_settings["Settings<br/>[SettingsModal.tsx]"]
  node_modal["Modal<br/>[Modal.tsx]"]
  node_locale["Localization<br/>[i18n.tsx]"]
  node_theme["Theme<br/>[theme.ts]"]
  node_storagehooks["Storage Hooks<br/>[storage-hooks.ts]"]
  node_storage["Local Data Layer<br/>[storage.ts]"]
  node_icons["Icon Map<br/>[icons.tsx]"]
  node_toast["Toast Feedback<br/>[toast.tsx]"]
end

node_operator(("Print Operator"))
node_runtime(("Browser"))
node_browserstore[("Browser Storage")]

node_operator -->|"opens workspace"| node_shell
node_shell -->|"routes to"| node_workspace
node_shell -->|"routes to"| node_quickprint
node_shell -->|"routes to"| node_pricedesk
node_shell -->|"routes to"| node_resources
node_shell -->|"routes to"| node_support
node_shell -->|"routes to"| node_about
node_shell -->|"opens"| node_settings
node_shell -->|"provides"| node_commands
node_shell -->|"uses"| node_mobile
node_commands -->|"offers resource commands"| node_resources
node_quickprint -->|"prints sheet"| node_runtime
node_quickprint -->|"reads preferences"| node_storagehooks
node_quickprint -->|"reads print settings"| node_storage
node_pricedesk -->|"reads saved data"| node_storagehooks
node_pricedesk -->|"uses services"| node_storage
node_resources -->|"reads saved data"| node_storagehooks
node_resources -->|"uses resource data"| node_storage
node_settings -->|"renders"| node_modal
node_settings -->|"updates preferences"| node_storage
node_settings -->|"applies theme"| node_theme
node_storagehooks -->|"delegates to"| node_storage
node_storage -->|"reads and writes"| node_browserstore
node_commands -->|"reads resources"| node_storagehooks
node_commands -->|"uses saved data"| node_storage
node_commands -->|"gets labels"| node_locale
node_theme -->|"reads preference"| node_storage
node_support -->|"shows feedback"| node_toast
node_pricedesk -->|"shows feedback"| node_toast
node_shell -->|"uses translations"| node_locale
node_workspace -->|"reads workspace data"| node_storagehooks
node_workspace -->|"uses saved data"| node_storage
node_settings -->|"reads preferences"| node_storagehooks
node_settings -->|"shows feedback"| node_toast
node_mobile -->|"uses"| node_modal
node_quickprint -->|"uses translations"| node_locale
node_pricedesk -->|"uses translations"| node_locale
node_resources -->|"uses translations"| node_locale
node_shell -->|"renders icons"| node_icons
node_toast -->|"renders icons"| node_icons
node_operator -->|"opens directly"| node_donate

click node_shell "https://github.com/flessan/rekaluna-dev/blob/main/src/components/AppShell.tsx"
click node_workspace "https://github.com/flessan/rekaluna-dev/blob/main/src/pages/Workspace.tsx"
click node_commands "https://github.com/flessan/rekaluna-dev/blob/main/src/lib/commands.tsx"
click node_mobile "https://github.com/flessan/rekaluna-dev/blob/main/src/components/MobileSheets.tsx"
click node_quickprint "https://github.com/flessan/rekaluna-dev/blob/main/src/features/quickprint/QuickPrintPage.tsx"
click node_pricedesk "https://github.com/flessan/rekaluna-dev/blob/main/src/features/pricedesk/PriceDeskPage.tsx"
click node_resources "https://github.com/flessan/rekaluna-dev/blob/main/src/pages/Resources.tsx"
click node_support "https://github.com/flessan/rekaluna-dev/blob/main/src/pages/Support.tsx"
click node_about "https://github.com/flessan/rekaluna-dev/blob/main/src/pages/About.tsx"
click node_donate "https://github.com/flessan/rekaluna-dev/blob/main/public/donate/index.html"
click node_settings "https://github.com/flessan/rekaluna-dev/blob/main/src/components/SettingsModal.tsx"
click node_modal "https://github.com/flessan/rekaluna-dev/blob/main/src/components/Modal.tsx"
click node_locale "https://github.com/flessan/rekaluna-dev/blob/main/src/lib/i18n.tsx"
click node_theme "https://github.com/flessan/rekaluna-dev/blob/main/src/lib/theme.ts"
click node_storagehooks "https://github.com/flessan/rekaluna-dev/blob/main/src/lib/storage-hooks.ts"
click node_storage "https://github.com/flessan/rekaluna-dev/blob/main/src/lib/storage.ts"
click node_icons "https://github.com/flessan/rekaluna-dev/blob/main/src/lib/icons.tsx"
click node_toast "https://github.com/flessan/rekaluna-dev/blob/main/src/lib/toast.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_shell,node_workspace,node_commands,node_mobile,node_runtime toneBlue
class node_quickprint,node_pricedesk,node_browserstore toneAmber
class node_resources,node_support,node_about,node_donate toneMint
class node_settings,node_modal,node_locale,node_theme,node_storagehooks,node_storage,node_icons,node_toast toneRose
class node_operator toneIndigo
```

## Components

### Workspace Navigation

- [App Shell](https://github.com/flessan/rekaluna-dev/blob/main/src/components/AppShell.tsx): `src/components/AppShell.tsx`
- [Workspace](https://github.com/flessan/rekaluna-dev/blob/main/src/pages/Workspace.tsx): `src/pages/Workspace.tsx`
- [Command Palette](https://github.com/flessan/rekaluna-dev/blob/main/src/lib/commands.tsx): `src/lib/commands.tsx`
- [Mobile Sheets](https://github.com/flessan/rekaluna-dev/blob/main/src/components/MobileSheets.tsx): `src/components/MobileSheets.tsx`

### Print Shop Tools

- [Quick Print](https://github.com/flessan/rekaluna-dev/blob/main/src/features/quickprint/QuickPrintPage.tsx): `src/features/quickprint/QuickPrintPage.tsx`
- [Price Desk](https://github.com/flessan/rekaluna-dev/blob/main/src/features/pricedesk/PriceDeskPage.tsx): `src/features/pricedesk/PriceDeskPage.tsx`

### Resources and Pages

- [Resource Center](https://github.com/flessan/rekaluna-dev/blob/main/src/pages/Resources.tsx): `src/pages/Resources.tsx`
- [Support](https://github.com/flessan/rekaluna-dev/blob/main/src/pages/Support.tsx): `src/pages/Support.tsx`
- [About](https://github.com/flessan/rekaluna-dev/blob/main/src/pages/About.tsx): `src/pages/About.tsx`
- [Donate Page](https://github.com/flessan/rekaluna-dev/blob/main/public/donate/index.html): `public/donate/index.html`

### Shared App Services

- [Settings](https://github.com/flessan/rekaluna-dev/blob/main/src/components/SettingsModal.tsx): `src/components/SettingsModal.tsx`
- [Modal](https://github.com/flessan/rekaluna-dev/blob/main/src/components/Modal.tsx): `src/components/Modal.tsx`
- [Localization](https://github.com/flessan/rekaluna-dev/blob/main/src/lib/i18n.tsx): `src/lib/i18n.tsx`
- [Theme](https://github.com/flessan/rekaluna-dev/blob/main/src/lib/theme.ts): `src/lib/theme.ts`
- [Storage Hooks](https://github.com/flessan/rekaluna-dev/blob/main/src/lib/storage-hooks.ts): `src/lib/storage-hooks.ts`
- [Local Data Layer](https://github.com/flessan/rekaluna-dev/blob/main/src/lib/storage.ts): `src/lib/storage.ts`
- [Icon Map](https://github.com/flessan/rekaluna-dev/blob/main/src/lib/icons.tsx): `src/lib/icons.tsx`
- [Toast Feedback](https://github.com/flessan/rekaluna-dev/blob/main/src/lib/toast.tsx): `src/lib/toast.tsx`

### Other components

- **Print Operator**
- **Browser**
- **Browser Storage**

## Connections

- Print Operator → App Shell: opens workspace (evidence: `README.md`)
- App Shell → Workspace: routes to (evidence: `src/main.tsx`)
- App Shell → Quick Print: routes to (evidence: `src/main.tsx`)
- App Shell → Price Desk: routes to (evidence: `src/main.tsx`)
- App Shell → Resource Center: routes to (evidence: `src/main.tsx`)
- App Shell → Support: routes to (evidence: `src/main.tsx`)
- App Shell → About: routes to (evidence: `src/main.tsx`)
- App Shell → Settings: opens (evidence: `src/main.tsx`)
- App Shell → Command Palette: provides (evidence: `src/components/AppShell.tsx`)
- App Shell → Mobile Sheets: uses (evidence: `src/components/MobileSheets.tsx`)
- Command Palette → Resource Center: offers resource commands (evidence: `src/lib/commands.tsx`)
- Quick Print → Browser: prints sheet (evidence: `README.md`)
- Quick Print → Storage Hooks: reads preferences (evidence: `src/features/quickprint/QuickPrintPage.tsx`)
- Quick Print → Local Data Layer: reads print settings (evidence: `src/features/quickprint/QuickPrintPage.tsx`)
- Price Desk → Storage Hooks: reads saved data (evidence: `src/features/pricedesk/PriceDeskPage.tsx`)
- Price Desk → Local Data Layer: uses services (evidence: `src/features/pricedesk/PriceDeskPage.tsx`)
- Resource Center → Storage Hooks: reads saved data (evidence: `src/pages/Resources.tsx`)
- Resource Center → Local Data Layer: uses resource data (evidence: `src/pages/Resources.tsx`)
- Settings → Modal: renders (evidence: `src/components/SettingsModal.tsx`)
- Settings → Local Data Layer: updates preferences (evidence: `src/components/SettingsModal.tsx`)
- Settings → Theme: applies theme (evidence: `src/components/SettingsModal.tsx`)
- Storage Hooks → Local Data Layer: delegates to (evidence: `src/lib/storage-hooks.ts`)
- Local Data Layer → Browser Storage: reads and writes (evidence: `src/lib/storage.ts`)
- Command Palette → Storage Hooks: reads resources (evidence: `src/lib/commands.tsx`)
- Command Palette → Local Data Layer: uses saved data (evidence: `src/lib/commands.tsx`)
- Command Palette → Localization: gets labels (evidence: `src/lib/commands.tsx`)
- Theme → Local Data Layer: reads preference (evidence: `src/lib/theme.ts`)
- Support → Toast Feedback: shows feedback (evidence: `src/pages/Support.tsx`)
- Price Desk → Toast Feedback: shows feedback (evidence: `src/features/pricedesk/PriceDeskPage.tsx`)
- App Shell → Localization: uses translations (evidence: `src/components/AppShell.tsx`)
- Workspace → Storage Hooks: reads workspace data (evidence: `src/pages/Workspace.tsx`)
- Workspace → Local Data Layer: uses saved data (evidence: `src/pages/Workspace.tsx`)
- Settings → Storage Hooks: reads preferences (evidence: `src/components/SettingsModal.tsx`)
- Settings → Toast Feedback: shows feedback (evidence: `src/components/SettingsModal.tsx`)
- Mobile Sheets → Modal: uses (evidence: `src/components/MobileSheets.tsx`)
- Quick Print → Localization: uses translations (evidence: `src/features/quickprint/QuickPrintPage.tsx`)
- Price Desk → Localization: uses translations (evidence: `src/features/pricedesk/PriceDeskPage.tsx`)
- Resource Center → Localization: uses translations (evidence: `src/pages/Resources.tsx`)
- App Shell → Icon Map: renders icons (evidence: `src/components/AppShell.tsx`)
- Toast Feedback → Icon Map: renders icons (evidence: `src/lib/toast.tsx`)
- Print Operator → Donate Page: opens directly (evidence: `README.md`)
