# yesuaaa/nexus architecture

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

- Interactive diagram: https://gitdiagram.com/yesuaaa/nexus
- Repository: https://github.com/yesuaaa/nexus

## Overview

Nexus Starter is a two-app foundation rather than a domain-specific product. The main user workflow is opening the web UI and checking API and database availability: the home page sends HTTP requests to Express, whose database check obtains Prisma and queries PostgreSQL. The web app also provides routed home, about, and not-found pages. README documents Supabase-backed Prisma modeling and migrations as the intended extension path. Source excerpts establish the health-check path and database-check calls; deployment routing is documented, while unsampled schema details are not expanded.

Main entry points: [`apps/web/src/pages/home.tsx`](https://github.com/yesuaaa/nexus/blob/main/apps/web/src/pages/home.tsx) (Status dashboard), [`apps/web/src/App.tsx`](https://github.com/yesuaaa/nexus/blob/main/apps/web/src/App.tsx) (Route shell), [`apps/api/src/index.ts`](https://github.com/yesuaaa/nexus/blob/main/apps/api/src/index.ts) (Express endpoints), [`apps/web/src/main.tsx`](https://github.com/yesuaaa/nexus/blob/main/apps/web/src/main.tsx) (Web bootstrap)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_web_entry["Web bootstrap<br/>[main.tsx]"]
  node_router_pages["Route shell<br/>[App.tsx]"]
  node_home["Status dashboard<br/>[home.tsx]"]
  node_not_found["Not found page<br/>[not-found.tsx]"]
  node_button["Button UI<br/>[button.tsx]"]
  node_class_utils["Class utilities<br/>[utils.ts]"]
  node_web_proxy["Development API proxy<br/>[vite.config.ts]"]
end

subgraph group_api["API service"]
  node_api_server["Express endpoints<br/>[index.ts]"]
end

subgraph group_data["Persistence"]
  node_prisma_client["Prisma connection<br/>[db.ts]"]
  node_prisma_schema["Example data model<br/>[schema.prisma]"]
  node_postgres[("Supabase PostgreSQL")]
end

node_user(("Browser user"))
node_api_origin(("API host"))

node_user -->|"opens"| node_web_entry
node_web_entry -->|"renders"| node_router_pages
node_router_pages -->|"routes to"| node_home
node_router_pages -->|"routes to"| node_not_found
node_home -->|"renders"| node_button
node_button -->|"uses"| node_class_utils
node_home -->|"checks via HTTP"| node_api_server
node_home -->|"requests API"| node_api_origin
node_web_proxy -.->|"forwards /api"| node_api_server
node_api_server -->|"gets client"| node_prisma_client
node_prisma_client -.->|"queries"| node_postgres
node_prisma_schema -.->|"models data"| node_postgres

click node_web_entry "https://github.com/yesuaaa/nexus/blob/main/apps/web/src/main.tsx"
click node_router_pages "https://github.com/yesuaaa/nexus/blob/main/apps/web/src/App.tsx"
click node_home "https://github.com/yesuaaa/nexus/blob/main/apps/web/src/pages/home.tsx"
click node_not_found "https://github.com/yesuaaa/nexus/blob/main/apps/web/src/pages/not-found.tsx"
click node_button "https://github.com/yesuaaa/nexus/blob/main/apps/web/src/components/ui/button.tsx"
click node_class_utils "https://github.com/yesuaaa/nexus/blob/main/apps/web/src/lib/utils.ts"
click node_web_proxy "https://github.com/yesuaaa/nexus/blob/main/apps/web/vite.config.ts"
click node_api_server "https://github.com/yesuaaa/nexus/blob/main/apps/api/src/index.ts"
click node_prisma_client "https://github.com/yesuaaa/nexus/blob/main/apps/api/src/db.ts"
click node_prisma_schema "https://github.com/yesuaaa/nexus/blob/main/apps/api/prisma/schema.prisma"

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_web_entry,node_router_pages,node_home,node_not_found,node_button,node_class_utils,node_web_proxy,node_user toneBlue
class node_api_server toneAmber
class node_prisma_client,node_prisma_schema,node_postgres,node_api_origin toneMint
```

## Components

### Web application

- [Web bootstrap](https://github.com/yesuaaa/nexus/blob/main/apps/web/src/main.tsx): `apps/web/src/main.tsx`
- [Route shell](https://github.com/yesuaaa/nexus/blob/main/apps/web/src/App.tsx): `apps/web/src/App.tsx`
- [Status dashboard](https://github.com/yesuaaa/nexus/blob/main/apps/web/src/pages/home.tsx): `apps/web/src/pages/home.tsx`
- [Not found page](https://github.com/yesuaaa/nexus/blob/main/apps/web/src/pages/not-found.tsx): `apps/web/src/pages/not-found.tsx`
- [Button UI](https://github.com/yesuaaa/nexus/blob/main/apps/web/src/components/ui/button.tsx): `apps/web/src/components/ui/button.tsx`
- [Class utilities](https://github.com/yesuaaa/nexus/blob/main/apps/web/src/lib/utils.ts): `apps/web/src/lib/utils.ts`
- [Development API proxy](https://github.com/yesuaaa/nexus/blob/main/apps/web/vite.config.ts): `apps/web/vite.config.ts`

### API service

- [Express endpoints](https://github.com/yesuaaa/nexus/blob/main/apps/api/src/index.ts): `apps/api/src/index.ts`

### Persistence

- [Prisma connection](https://github.com/yesuaaa/nexus/blob/main/apps/api/src/db.ts): `apps/api/src/db.ts`
- [Example data model](https://github.com/yesuaaa/nexus/blob/main/apps/api/prisma/schema.prisma): `apps/api/prisma/schema.prisma`
- **Supabase PostgreSQL**

### Other components

- **Browser user**
- **API host**

## Connections

- Browser user → Web bootstrap: opens (evidence: `README.md`)
- Web bootstrap → Route shell: renders (evidence: `apps/web/src/main.tsx`)
- Route shell → Status dashboard: routes to (evidence: `apps/web/src/App.tsx`)
- Route shell → Not found page: routes to (evidence: `apps/web/src/App.tsx`)
- Status dashboard → Button UI: renders (evidence: `apps/web/src/pages/home.tsx`)
- Button UI → Class utilities: uses (evidence: `apps/web/src/components/ui/button.tsx`)
- Status dashboard → Express endpoints: checks via HTTP (evidence: `apps/web/src/pages/home.tsx`)
- Status dashboard → API host: requests API (evidence: `README.md`)
- Development API proxy → Express endpoints: forwards /api (evidence: `README.md`)
- Express endpoints → Prisma connection: gets client (evidence: `apps/api/src/index.ts`)
- Prisma connection → Supabase PostgreSQL: queries
- Example data model → Supabase PostgreSQL: models data (evidence: `README.md`)
