# breeze-sn/atria architecture

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

## Overview

Atria is a client-rendered design-system studio: users enter through the site, explore an overview, then customise foundations and tokens or inspect reusable component examples. A separate Studio builder and documentation hub broaden the product. The sampled code supports the app entry and token persistence links; other page capabilities and foundation persistence are documented in the README. The health server is only a scaffold, and the Prisma schema is not connected to runtime features.

Main entry points: [`src/layouts/DashboardLayout.jsx`](https://github.com/breeze-sn/atria/blob/main/src/layouts/DashboardLayout.jsx) (Explore workspace), [`src/main.jsx`](https://github.com/breeze-sn/atria/blob/main/src/main.jsx) (Client entry), [`src/App.jsx`](https://github.com/breeze-sn/atria/blob/main/src/App.jsx) (Landing site), [`src/pages/Foundations.jsx`](https://github.com/breeze-sn/atria/blob/main/src/pages/Foundations.jsx) (Foundations library)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Entry and navigation"]
  node_entrypoint["Client entry<br/>[main.jsx]"]
  node_site["Landing site<br/>[App.jsx]"]
  node_workspace["Explore workspace"]
  node_overview["Workspace overview<br/>[Overview.jsx]"]
end

subgraph group_design["Design resources"]
  node_foundations["Foundations library<br/>[Foundations.jsx]"]
  node_tokens["Token collection<br/>[Tokens.jsx]"]
  node_components["Component patterns<br/>[Components.jsx]"]
  node_resource_data["Starter data and persistence<br/>[studioStore.js]"]
end

subgraph group_builder["Studio builder"]
  node_studio["Visual builder<br/>[Studio.jsx]"]
  node_studio_styles["Builder styles<br/>[studio.css]"]
end

subgraph group_support["Documentation and service"]
  node_docs["Documentation hub<br/>[Docs.jsx]"]
  node_server["Health server<br/>[index.js]"]
  node_health["Health endpoint<br/>[health.js]"]
end

node_user(("Designer or developer"))
node_browser(("Browser"))
node_local_storage[("Browser local storage")]

node_user -->|"uses"| node_browser
node_browser -->|"loads"| node_entrypoint
node_entrypoint -->|"renders"| node_site
node_entrypoint -->|"renders at docs path"| node_docs
node_user -->|"explores"| node_site
node_site -.->|"enters studio"| node_workspace
node_workspace -.->|"routes to"| node_overview
node_workspace -.->|"routes to"| node_foundations
node_workspace -.->|"routes to"| node_tokens
node_workspace -.->|"routes to"| node_components
node_workspace -.->|"routes to"| node_studio
node_user -->|"customises"| node_foundations
node_foundations -->|"persists edits"| node_local_storage
node_user -->|"edits and exports"| node_tokens
node_tokens -->|"reads and saves"| node_resource_data
node_resource_data -->|"reads and writes"| node_local_storage
node_user -->|"views examples"| node_components
node_user -->|"builds systems"| node_studio
node_studio -->|"imports styles"| node_studio_styles
node_user -->|"reads guidance"| node_docs
node_server -->|"mounts route"| node_health

click node_entrypoint "https://github.com/breeze-sn/atria/blob/main/src/main.jsx"
click node_site "https://github.com/breeze-sn/atria/blob/main/src/App.jsx"
click node_workspace "https://github.com/breeze-sn/atria/blob/main/src/layouts/DashboardLayout.jsx"
click node_overview "https://github.com/breeze-sn/atria/blob/main/src/pages/Overview.jsx"
click node_foundations "https://github.com/breeze-sn/atria/blob/main/src/pages/Foundations.jsx"
click node_tokens "https://github.com/breeze-sn/atria/blob/main/src/pages/Tokens.jsx"
click node_components "https://github.com/breeze-sn/atria/blob/main/src/pages/Components.jsx"
click node_resource_data "https://github.com/breeze-sn/atria/blob/main/src/data/studioStore.js"
click node_studio "https://github.com/breeze-sn/atria/blob/main/src/pages/Studio.jsx"
click node_studio_styles "https://github.com/breeze-sn/atria/blob/main/src/pages/studio.css"
click node_docs "https://github.com/breeze-sn/atria/blob/main/src/Docs.jsx"
click node_server "https://github.com/breeze-sn/atria/blob/main/server/index.js"
click node_health "https://github.com/breeze-sn/atria/blob/main/server/routes/health.js"

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_entrypoint,node_site,node_workspace,node_overview,node_browser toneBlue
class node_foundations,node_tokens,node_components,node_resource_data,node_local_storage toneAmber
class node_studio,node_studio_styles toneMint
class node_docs,node_server,node_health toneRose
class node_user toneIndigo
```

## Components

### Entry and navigation

- [Client entry](https://github.com/breeze-sn/atria/blob/main/src/main.jsx): `src/main.jsx`
- [Landing site](https://github.com/breeze-sn/atria/blob/main/src/App.jsx): `src/App.jsx`
- [Explore workspace](https://github.com/breeze-sn/atria/blob/main/src/layouts/DashboardLayout.jsx): `src/layouts/DashboardLayout.jsx`
- [Workspace overview](https://github.com/breeze-sn/atria/blob/main/src/pages/Overview.jsx): `src/pages/Overview.jsx`

### Design resources

- [Foundations library](https://github.com/breeze-sn/atria/blob/main/src/pages/Foundations.jsx): `src/pages/Foundations.jsx`
- [Token collection](https://github.com/breeze-sn/atria/blob/main/src/pages/Tokens.jsx): `src/pages/Tokens.jsx`
- [Component patterns](https://github.com/breeze-sn/atria/blob/main/src/pages/Components.jsx): `src/pages/Components.jsx`
- [Starter data and persistence](https://github.com/breeze-sn/atria/blob/main/src/data/studioStore.js): `src/data/studioStore.js`

### Studio builder

- [Visual builder](https://github.com/breeze-sn/atria/blob/main/src/pages/Studio.jsx): `src/pages/Studio.jsx`
- [Builder styles](https://github.com/breeze-sn/atria/blob/main/src/pages/studio.css): `src/pages/studio.css`

### Documentation and service

- [Documentation hub](https://github.com/breeze-sn/atria/blob/main/src/Docs.jsx): `src/Docs.jsx`
- [Health server](https://github.com/breeze-sn/atria/blob/main/server/index.js): `server/index.js`
- [Health endpoint](https://github.com/breeze-sn/atria/blob/main/server/routes/health.js): `server/routes/health.js`

### Other components

- **Designer or developer**
- **Browser**
- **Browser local storage**

## Connections

- Designer or developer → Browser: uses (evidence: `README.md`)
- Browser → Client entry: loads (evidence: `README.md`)
- Client entry → Landing site: renders (evidence: `src/main.jsx`)
- Client entry → Documentation hub: renders at docs path (evidence: `src/main.jsx`)
- Designer or developer → Landing site: explores (evidence: `README.md`)
- Landing site → Explore workspace: enters studio (evidence: `src/App.jsx`)
- Explore workspace → Workspace overview: routes to
- Explore workspace → Foundations library: routes to
- Explore workspace → Token collection: routes to
- Explore workspace → Component patterns: routes to
- Explore workspace → Visual builder: routes to
- Designer or developer → Foundations library: customises (evidence: `README.md`)
- Foundations library → Browser local storage: persists edits (evidence: `README.md`)
- Designer or developer → Token collection: edits and exports (evidence: `README.md`)
- Token collection → Starter data and persistence: reads and saves (evidence: `src/pages/Tokens.jsx`)
- Starter data and persistence → Browser local storage: reads and writes (evidence: `src/data/studioStore.js`)
- Designer or developer → Component patterns: views examples (evidence: `README.md`)
- Designer or developer → Visual builder: builds systems (evidence: `src/pages/Studio.jsx`)
- Visual builder → Builder styles: imports styles (evidence: `src/pages/Studio.jsx`)
- Designer or developer → Documentation hub: reads guidance (evidence: `src/Docs.jsx`)
- Health server → Health endpoint: mounts route (evidence: `server/index.js`)
