# khalidmuse45/colorstack-umn-website architecture

> Architecture diagram of the GitHub repository khalidmuse45/colorstack-umn-website, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/khalidmuse45/colorstack-umn-website
- Repository: https://github.com/khalidmuse45/colorstack-umn-website

## Overview

This repository contains two Next.js products: the ColorStack UMN chapter website, including a join-signup flow, and Wunderbar, a practice and mentoring workspace. The main site presents chapter information and routes prospective members to the signup form; Wunderbar provides workspace and practice interfaces backed by API routes and Supabase configuration. Several Wunderbar route implementations and most site sections were not excerpted, so relationships to them are omitted rather than inferred.

Main entry points: [`web/app/(site)/page.tsx`](https://github.com/khalidmuse45/colorstack-umn-website/blob/main/web/app/(site)/page.tsx) (Chapter homepage), [`wunderbar/lib/supabase/server.ts`](https://github.com/khalidmuse45/colorstack-umn-website/blob/main/wunderbar/lib/supabase/server.ts) (Server client), [`web/functions/api/join.ts`](https://github.com/khalidmuse45/colorstack-umn-website/blob/main/web/functions/api/join.ts) (Signup handler), [`wunderbar/components/practice-room.tsx`](https://github.com/khalidmuse45/colorstack-umn-website/blob/main/wunderbar/components/practice-room.tsx) (Practice room)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_site["ColorStack Website"]
  node_homepage["Chapter homepage<br/>[page.tsx]"]
  node_landing_data["Landing content<br/>[landing.ts]"]
  node_hero["Homepage hero<br/>[Hero.tsx]"]
  node_community["Community sections"]
  node_floating_cards["Photo cards<br/>[FloatingCards.tsx]"]
end

subgraph group_join["Signup Flow"]
  node_join_page["Join information<br/>[page.tsx]"]
  node_join_hero["Signup form<br/>[JoinHero.tsx]"]
  node_join_fn["Signup handler<br/>[join.ts]"]
  node_join_kv[("Signup records")]
end

subgraph group_wb_app["Wunderbar Experience"]
  node_wb_home["Wunderbar home<br/>[page.tsx]"]
  node_login["Login<br/>[page.tsx]"]
  node_practice_page["Practice page<br/>[page.tsx]"]
  node_workspace_ui["Workspace UI<br/>[workspace.tsx]"]
  node_practice_ui["Practice room<br/>[practice-room.tsx]"]
  node_forms["Workspace forms<br/>[forms.tsx]"]
end

subgraph group_wb_domain["Practice Domain"]
  node_questions["Practice questions<br/>[questions.ts]"]
  node_model["Workspace model<br/>[model.ts]"]
end

subgraph group_wb_backend["Wunderbar Backend"]
  node_workspace_api["Workspace API<br/>[route.ts]"]
  node_reminders_api["Reminder API<br/>[route.ts]"]
  node_auth_confirm["Auth confirmation<br/>[route.ts]"]
  node_server_client["Server client<br/>[server.ts]"]
  node_backend_config["Backend config<br/>[config.ts]"]
end

node_visitor(("Site visitor"))
node_resend["Resend email"]
node_wb_user(("Wunderbar user"))
node_supabase[("Supabase")]

node_visitor -.->|"visits"| node_homepage
node_homepage -->|"loads"| node_landing_data
node_homepage -->|"renders"| node_hero
node_homepage -->|"renders"| node_community
node_homepage -->|"renders"| node_floating_cards
node_join_page -->|"renders"| node_join_hero
node_join_hero -->|"posts signup"| node_join_fn
node_join_fn -->|"stores signup"| node_join_kv
node_join_fn -.->|"notifies"| node_resend
node_wb_user -.->|"visits"| node_wb_home
node_workspace_ui -->|"fetches"| node_workspace_api
node_practice_ui -->|"uses questions"| node_questions
node_practice_ui -->|"uses types"| node_model
node_forms -->|"uses question data"| node_questions
node_forms -->|"uses schemas"| node_model
node_server_client -->|"loads config"| node_backend_config
node_wb_home -.->|"renders"| node_workspace_ui
node_login -.->|"confirms auth"| node_auth_confirm
node_workspace_api -.->|"uses client"| node_server_client
node_reminders_api -.->|"uses client"| node_server_client
node_auth_confirm -.->|"uses client"| node_server_client
node_server_client -.->|"connects"| node_supabase

click node_homepage "https://github.com/khalidmuse45/colorstack-umn-website/blob/main/web/app/(site)/page.tsx"
click node_landing_data "https://github.com/khalidmuse45/colorstack-umn-website/blob/main/web/lib/landing.ts"
click node_hero "https://github.com/khalidmuse45/colorstack-umn-website/blob/main/web/components/hero/Hero.tsx"
click node_community "https://github.com/khalidmuse45/colorstack-umn-website/tree/main/web/components/sections"
click node_floating_cards "https://github.com/khalidmuse45/colorstack-umn-website/blob/main/web/components/whimsy/FloatingCards.tsx"
click node_join_page "https://github.com/khalidmuse45/colorstack-umn-website/blob/main/web/app/join-form/page.tsx"
click node_join_hero "https://github.com/khalidmuse45/colorstack-umn-website/blob/main/web/components/join/JoinHero.tsx"
click node_join_fn "https://github.com/khalidmuse45/colorstack-umn-website/blob/main/web/functions/api/join.ts"
click node_wb_home "https://github.com/khalidmuse45/colorstack-umn-website/blob/main/wunderbar/app/page.tsx"
click node_login "https://github.com/khalidmuse45/colorstack-umn-website/blob/main/wunderbar/app/login/page.tsx"
click node_practice_page "https://github.com/khalidmuse45/colorstack-umn-website/blob/main/wunderbar/app/practice/page.tsx"
click node_workspace_ui "https://github.com/khalidmuse45/colorstack-umn-website/blob/main/wunderbar/components/workspace.tsx"
click node_practice_ui "https://github.com/khalidmuse45/colorstack-umn-website/blob/main/wunderbar/components/practice-room.tsx"
click node_forms "https://github.com/khalidmuse45/colorstack-umn-website/blob/main/wunderbar/components/forms.tsx"
click node_questions "https://github.com/khalidmuse45/colorstack-umn-website/blob/main/wunderbar/content/questions.ts"
click node_model "https://github.com/khalidmuse45/colorstack-umn-website/blob/main/wunderbar/lib/model.ts"
click node_workspace_api "https://github.com/khalidmuse45/colorstack-umn-website/blob/main/wunderbar/app/api/workspace/route.ts"
click node_reminders_api "https://github.com/khalidmuse45/colorstack-umn-website/blob/main/wunderbar/app/api/reminders/route.ts"
click node_auth_confirm "https://github.com/khalidmuse45/colorstack-umn-website/blob/main/wunderbar/app/auth/confirm/route.ts"
click node_server_client "https://github.com/khalidmuse45/colorstack-umn-website/blob/main/wunderbar/lib/supabase/server.ts"
click node_backend_config "https://github.com/khalidmuse45/colorstack-umn-website/blob/main/wunderbar/lib/supabase/config.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_homepage,node_landing_data,node_hero,node_community,node_floating_cards,node_wb_user toneBlue
class node_join_page,node_join_hero,node_join_fn,node_join_kv,node_supabase toneAmber
class node_wb_home,node_login,node_practice_page,node_workspace_ui,node_practice_ui,node_forms toneMint
class node_questions,node_model toneRose
class node_workspace_api,node_reminders_api,node_auth_confirm,node_server_client,node_backend_config,node_visitor,node_resend toneIndigo
```

## Components

### ColorStack Website

- [Chapter homepage](https://github.com/khalidmuse45/colorstack-umn-website/blob/main/web/app/(site)/page.tsx): `web/app/(site)/page.tsx`
- [Landing content](https://github.com/khalidmuse45/colorstack-umn-website/blob/main/web/lib/landing.ts): `web/lib/landing.ts`
- [Homepage hero](https://github.com/khalidmuse45/colorstack-umn-website/blob/main/web/components/hero/Hero.tsx): `web/components/hero/Hero.tsx`
- [Community sections](https://github.com/khalidmuse45/colorstack-umn-website/tree/main/web/components/sections): `web/components/sections`
- [Photo cards](https://github.com/khalidmuse45/colorstack-umn-website/blob/main/web/components/whimsy/FloatingCards.tsx): `web/components/whimsy/FloatingCards.tsx`

### Signup Flow

- [Join information](https://github.com/khalidmuse45/colorstack-umn-website/blob/main/web/app/join-form/page.tsx): `web/app/join-form/page.tsx`
- [Signup form](https://github.com/khalidmuse45/colorstack-umn-website/blob/main/web/components/join/JoinHero.tsx): `web/components/join/JoinHero.tsx`
- [Signup handler](https://github.com/khalidmuse45/colorstack-umn-website/blob/main/web/functions/api/join.ts): `web/functions/api/join.ts`
- **Signup records**

### Wunderbar Experience

- [Wunderbar home](https://github.com/khalidmuse45/colorstack-umn-website/blob/main/wunderbar/app/page.tsx): `wunderbar/app/page.tsx`
- [Login](https://github.com/khalidmuse45/colorstack-umn-website/blob/main/wunderbar/app/login/page.tsx): `wunderbar/app/login/page.tsx`
- [Practice page](https://github.com/khalidmuse45/colorstack-umn-website/blob/main/wunderbar/app/practice/page.tsx): `wunderbar/app/practice/page.tsx`
- [Workspace UI](https://github.com/khalidmuse45/colorstack-umn-website/blob/main/wunderbar/components/workspace.tsx): `wunderbar/components/workspace.tsx`
- [Practice room](https://github.com/khalidmuse45/colorstack-umn-website/blob/main/wunderbar/components/practice-room.tsx): `wunderbar/components/practice-room.tsx`
- [Workspace forms](https://github.com/khalidmuse45/colorstack-umn-website/blob/main/wunderbar/components/forms.tsx): `wunderbar/components/forms.tsx`

### Practice Domain

- [Practice questions](https://github.com/khalidmuse45/colorstack-umn-website/blob/main/wunderbar/content/questions.ts): `wunderbar/content/questions.ts`
- [Workspace model](https://github.com/khalidmuse45/colorstack-umn-website/blob/main/wunderbar/lib/model.ts): `wunderbar/lib/model.ts`

### Wunderbar Backend

- [Workspace API](https://github.com/khalidmuse45/colorstack-umn-website/blob/main/wunderbar/app/api/workspace/route.ts): `wunderbar/app/api/workspace/route.ts`
- [Reminder API](https://github.com/khalidmuse45/colorstack-umn-website/blob/main/wunderbar/app/api/reminders/route.ts): `wunderbar/app/api/reminders/route.ts`
- [Auth confirmation](https://github.com/khalidmuse45/colorstack-umn-website/blob/main/wunderbar/app/auth/confirm/route.ts): `wunderbar/app/auth/confirm/route.ts`
- [Server client](https://github.com/khalidmuse45/colorstack-umn-website/blob/main/wunderbar/lib/supabase/server.ts): `wunderbar/lib/supabase/server.ts`
- [Backend config](https://github.com/khalidmuse45/colorstack-umn-website/blob/main/wunderbar/lib/supabase/config.ts): `wunderbar/lib/supabase/config.ts`

### Other components

- **Site visitor**
- **Resend email**
- **Wunderbar user**
- **Supabase**

## Connections

- Site visitor → Chapter homepage: visits
- Chapter homepage → Landing content: loads (evidence: `web/app/(site)/page.tsx`)
- Chapter homepage → Homepage hero: renders (evidence: `web/app/(site)/page.tsx`)
- Chapter homepage → Community sections: renders (evidence: `web/app/(site)/page.tsx`)
- Chapter homepage → Photo cards: renders (evidence: `web/app/(site)/page.tsx`)
- Join information → Signup form: renders (evidence: `web/app/join-form/page.tsx`)
- Signup form → Signup handler: posts signup (evidence: `README.md`)
- Signup handler → Signup records: stores signup (evidence: `README.md`)
- Signup handler → Resend email: notifies (evidence: `README.md`)
- Wunderbar user → Wunderbar home: visits
- Workspace UI → Workspace API: fetches (evidence: `wunderbar/components/workspace.tsx`)
- Practice room → Practice questions: uses questions (evidence: `wunderbar/components/practice-room.tsx`)
- Practice room → Workspace model: uses types (evidence: `wunderbar/components/practice-room.tsx`)
- Workspace forms → Practice questions: uses question data (evidence: `wunderbar/components/forms.tsx`)
- Workspace forms → Workspace model: uses schemas (evidence: `wunderbar/components/forms.tsx`)
- Server client → Backend config: loads config (evidence: `wunderbar/lib/supabase/server.ts`)
- Wunderbar home → Workspace UI: renders
- Login → Auth confirmation: confirms auth
- Workspace API → Server client: uses client
- Reminder API → Server client: uses client
- Auth confirmation → Server client: uses client
- Server client → Supabase: connects
