# jawi-lab/ai-coding-starter-kit architecture

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

- Interactive diagram: https://gitdiagram.com/jawi-lab/ai-coding-starter-kit
- Repository: https://github.com/jawi-lab/ai-coding-starter-kit

## Overview

Mellon is a mobile-first app for friend groups, delivered as a web app and through Capacitor. The main user journey is authentication and onboarding, joining or creating a group, then proposing ideas, planning activities on a Kanban board, finding dates, and keeping memories. The group-detail shell selects the proposal, planning, and date tabs; profile, notifications, badges, and personal archives provide supporting capabilities. The excerpts show the Supabase-backed auth setup and selected UI wiring; several feature implementations are indexed but unsampled, so their internal calls are not asserted.

Main entry points: [`src/app/groups/view/page.tsx`](https://github.com/jawi-lab/ai-coding-starter-kit/blob/main/src/app/groups/view/page.tsx) (Group shell), [`src/app/groups/page.tsx`](https://github.com/jawi-lab/ai-coding-starter-kit/blob/main/src/app/groups/page.tsx) (Group home), [`src/contexts/AuthContext.tsx`](https://github.com/jawi-lab/ai-coding-starter-kit/blob/main/src/contexts/AuthContext.tsx) (Auth state), [`src/lib/supabase.ts`](https://github.com/jawi-lab/ai-coding-starter-kit/blob/main/src/lib/supabase.ts) (Supabase client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Entry and identity"]
  node_auth_pages["Login and signup<br/>[page.tsx]"]
  node_auth_context["Auth state<br/>[AuthContext.tsx]"]
  node_auth_guard["Route guard<br/>[AuthGuard.tsx]"]
  node_onboarding["Onboarding"]
end

subgraph group_groups["Groups and planning"]
  node_group_list["Group home<br/>[page.tsx]"]
  node_group_detail["Group shell<br/>[page.tsx]"]
  node_group_routes["Group navigation<br/>[group-routes.ts]"]
  node_proposals["Idea proposals<br/>[VorschlaegeTab.tsx]"]
  node_activity_detail["Activity collaboration"]
  node_planning["Kanban planning<br/>[PlanungTab.tsx]"]
  node_date_finding["Date finding<br/>[TermineTab.tsx]"]
end

subgraph group_engagement["Reminders and memories"]
  node_profile["Profile and archive<br/>[ProfileSheet.tsx]"]
  node_notifications["Notifications"]
  node_memories["Memory cards"]
  node_wrapped["Group recap"]
end

subgraph group_platform["Data and native platform"]
  node_supabase_client["Supabase client<br/>[supabase.ts]"]
  node_db_types["Database model<br/>[database.types.ts]"]
  node_storage["Media storage<br/>[storage.ts]"]
  node_availability_fn["Availability function<br/>[index.ts]"]
  node_push_fn["Push function<br/>[index.ts]"]
  node_native_shell["Capacitor app"]
end

node_user(("Group member"))
node_supabase_service[("Supabase services")]

node_user -->|"signs in"| node_auth_pages
node_auth_pages -->|"uses auth"| node_auth_context
node_auth_context -->|"loads session"| node_supabase_client
node_auth_context -->|"reads profile"| node_supabase_service
node_auth_guard -->|"checks identity"| node_auth_context
node_user -->|"creates or joins"| node_onboarding
node_group_list -->|"protects page"| node_auth_guard
node_group_list -->|"navigates groups"| node_group_routes
node_group_list -->|"opens onboarding"| node_onboarding
node_group_list -->|"shows bell"| node_notifications
node_group_list -->|"shows tasks"| node_profile
node_group_routes -->|"routes to shell"| node_group_detail
node_group_detail -->|"protects page"| node_auth_guard
node_group_detail -->|"renders tab"| node_proposals
node_group_detail -->|"renders tab"| node_planning
node_group_detail -->|"renders tab"| node_date_finding
node_user -->|"suggests and votes"| node_proposals
node_user -->|"plans activities"| node_planning
node_user -->|"finds dates"| node_date_finding
node_user -->|"revisits memories"| node_memories
node_group_detail -->|"renders reveal"| node_memories
node_group_detail -->|"renders recap"| node_wrapped
node_notifications -->|"loads notifications"| node_supabase_client
node_profile -.->|"loads profile data"| node_supabase_client
node_storage -->|"signs media URLs"| node_supabase_service
node_supabase_client -->|"types client"| node_db_types
node_availability_fn -.->|"queries availability"| node_supabase_service
node_push_fn -.->|"dispatches pushes"| node_supabase_service
node_native_shell -->|"hosts mobile app"| node_user

click node_auth_pages "https://github.com/jawi-lab/ai-coding-starter-kit/blob/main/src/app/login/page.tsx"
click node_auth_context "https://github.com/jawi-lab/ai-coding-starter-kit/blob/main/src/contexts/AuthContext.tsx"
click node_auth_guard "https://github.com/jawi-lab/ai-coding-starter-kit/blob/main/src/components/auth/AuthGuard.tsx"
click node_onboarding "https://github.com/jawi-lab/ai-coding-starter-kit/blob/main/src/components/groups/OnboardingScreen.tsx"
click node_group_list "https://github.com/jawi-lab/ai-coding-starter-kit/blob/main/src/app/groups/page.tsx"
click node_group_detail "https://github.com/jawi-lab/ai-coding-starter-kit/blob/main/src/app/groups/view/page.tsx"
click node_group_routes "https://github.com/jawi-lab/ai-coding-starter-kit/blob/main/src/lib/group-routes.ts"
click node_proposals "https://github.com/jawi-lab/ai-coding-starter-kit/blob/main/src/components/groups/tabs/VorschlaegeTab.tsx"
click node_activity_detail "https://github.com/jawi-lab/ai-coding-starter-kit/blob/main/src/components/groups/ActivityDetailSheet.tsx"
click node_planning "https://github.com/jawi-lab/ai-coding-starter-kit/blob/main/src/components/groups/tabs/PlanungTab.tsx"
click node_date_finding "https://github.com/jawi-lab/ai-coding-starter-kit/blob/main/src/components/groups/tabs/TermineTab.tsx"
click node_profile "https://github.com/jawi-lab/ai-coding-starter-kit/blob/main/src/components/profile/ProfileSheet.tsx"
click node_notifications "https://github.com/jawi-lab/ai-coding-starter-kit/blob/main/src/components/notifications/NotificationBell.tsx"
click node_memories "https://github.com/jawi-lab/ai-coding-starter-kit/blob/main/src/components/memory/MemoryCardReveal.tsx"
click node_wrapped "https://github.com/jawi-lab/ai-coding-starter-kit/blob/main/src/components/wrapped/WrappedStoryViewer.tsx"
click node_supabase_client "https://github.com/jawi-lab/ai-coding-starter-kit/blob/main/src/lib/supabase.ts"
click node_db_types "https://github.com/jawi-lab/ai-coding-starter-kit/blob/main/src/lib/database.types.ts"
click node_storage "https://github.com/jawi-lab/ai-coding-starter-kit/blob/main/src/lib/storage.ts"
click node_availability_fn "https://github.com/jawi-lab/ai-coding-starter-kit/blob/main/supabase/functions/get-group-availability/index.ts"
click node_push_fn "https://github.com/jawi-lab/ai-coding-starter-kit/blob/main/supabase/functions/send-push/index.ts"
click node_native_shell "https://github.com/jawi-lab/ai-coding-starter-kit/blob/main/capacitor.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_auth_pages,node_auth_context,node_auth_guard,node_onboarding toneBlue
class node_group_list,node_group_detail,node_group_routes,node_proposals,node_activity_detail,node_planning,node_date_finding,node_supabase_service toneAmber
class node_profile,node_notifications,node_memories,node_wrapped toneMint
class node_supabase_client,node_db_types,node_storage,node_availability_fn,node_push_fn,node_native_shell toneRose
class node_user toneIndigo
```

## Components

### Entry and identity

- [Login and signup](https://github.com/jawi-lab/ai-coding-starter-kit/blob/main/src/app/login/page.tsx): `src/app/login/page.tsx`
- [Auth state](https://github.com/jawi-lab/ai-coding-starter-kit/blob/main/src/contexts/AuthContext.tsx): `src/contexts/AuthContext.tsx`
- [Route guard](https://github.com/jawi-lab/ai-coding-starter-kit/blob/main/src/components/auth/AuthGuard.tsx): `src/components/auth/AuthGuard.tsx`
- [Onboarding](https://github.com/jawi-lab/ai-coding-starter-kit/blob/main/src/components/groups/OnboardingScreen.tsx): `src/components/groups/OnboardingScreen.tsx`

### Groups and planning

- [Group home](https://github.com/jawi-lab/ai-coding-starter-kit/blob/main/src/app/groups/page.tsx): `src/app/groups/page.tsx`
- [Group shell](https://github.com/jawi-lab/ai-coding-starter-kit/blob/main/src/app/groups/view/page.tsx): `src/app/groups/view/page.tsx`
- [Group navigation](https://github.com/jawi-lab/ai-coding-starter-kit/blob/main/src/lib/group-routes.ts): `src/lib/group-routes.ts`
- [Idea proposals](https://github.com/jawi-lab/ai-coding-starter-kit/blob/main/src/components/groups/tabs/VorschlaegeTab.tsx): `src/components/groups/tabs/VorschlaegeTab.tsx`
- [Activity collaboration](https://github.com/jawi-lab/ai-coding-starter-kit/blob/main/src/components/groups/ActivityDetailSheet.tsx): `src/components/groups/ActivityDetailSheet.tsx`
- [Kanban planning](https://github.com/jawi-lab/ai-coding-starter-kit/blob/main/src/components/groups/tabs/PlanungTab.tsx): `src/components/groups/tabs/PlanungTab.tsx`
- [Date finding](https://github.com/jawi-lab/ai-coding-starter-kit/blob/main/src/components/groups/tabs/TermineTab.tsx): `src/components/groups/tabs/TermineTab.tsx`

### Reminders and memories

- [Profile and archive](https://github.com/jawi-lab/ai-coding-starter-kit/blob/main/src/components/profile/ProfileSheet.tsx): `src/components/profile/ProfileSheet.tsx`
- [Notifications](https://github.com/jawi-lab/ai-coding-starter-kit/blob/main/src/components/notifications/NotificationBell.tsx): `src/components/notifications/NotificationBell.tsx`
- [Memory cards](https://github.com/jawi-lab/ai-coding-starter-kit/blob/main/src/components/memory/MemoryCardReveal.tsx): `src/components/memory/MemoryCardReveal.tsx`
- [Group recap](https://github.com/jawi-lab/ai-coding-starter-kit/blob/main/src/components/wrapped/WrappedStoryViewer.tsx): `src/components/wrapped/WrappedStoryViewer.tsx`

### Data and native platform

- [Supabase client](https://github.com/jawi-lab/ai-coding-starter-kit/blob/main/src/lib/supabase.ts): `src/lib/supabase.ts`
- [Database model](https://github.com/jawi-lab/ai-coding-starter-kit/blob/main/src/lib/database.types.ts): `src/lib/database.types.ts`
- [Media storage](https://github.com/jawi-lab/ai-coding-starter-kit/blob/main/src/lib/storage.ts): `src/lib/storage.ts`
- [Availability function](https://github.com/jawi-lab/ai-coding-starter-kit/blob/main/supabase/functions/get-group-availability/index.ts): `supabase/functions/get-group-availability/index.ts`
- [Push function](https://github.com/jawi-lab/ai-coding-starter-kit/blob/main/supabase/functions/send-push/index.ts): `supabase/functions/send-push/index.ts`
- [Capacitor app](https://github.com/jawi-lab/ai-coding-starter-kit/blob/main/capacitor.config.ts): `capacitor.config.ts`

### Other components

- **Group member**
- **Supabase services**

## Connections

- Group member → Login and signup: signs in (evidence: `src/app/login/page.tsx`)
- Login and signup → Auth state: uses auth (evidence: `src/app/login/page.tsx`)
- Auth state → Supabase client: loads session (evidence: `src/contexts/AuthContext.tsx`)
- Auth state → Supabase services: reads profile (evidence: `src/contexts/AuthContext.tsx`)
- Route guard → Auth state: checks identity (evidence: `src/components/auth/AuthGuard.tsx`)
- Group member → Onboarding: creates or joins (evidence: `README.md`)
- Group home → Route guard: protects page (evidence: `src/app/groups/page.tsx`)
- Group home → Group navigation: navigates groups (evidence: `src/app/groups/page.tsx`)
- Group home → Onboarding: opens onboarding (evidence: `src/app/groups/page.tsx`)
- Group home → Notifications: shows bell (evidence: `src/app/groups/page.tsx`)
- Group home → Profile and archive: shows tasks (evidence: `src/app/groups/page.tsx`)
- Group navigation → Group shell: routes to shell (evidence: `src/lib/group-routes.ts`)
- Group shell → Route guard: protects page (evidence: `src/app/groups/view/page.tsx`)
- Group shell → Idea proposals: renders tab (evidence: `src/app/groups/view/page.tsx`)
- Group shell → Kanban planning: renders tab (evidence: `src/app/groups/view/page.tsx`)
- Group shell → Date finding: renders tab (evidence: `src/app/groups/view/page.tsx`)
- Group member → Idea proposals: suggests and votes (evidence: `README.md`)
- Group member → Kanban planning: plans activities (evidence: `README.md`)
- Group member → Date finding: finds dates (evidence: `README.md`)
- Group member → Memory cards: revisits memories (evidence: `README.md`)
- Group shell → Memory cards: renders reveal (evidence: `src/app/groups/view/page.tsx`)
- Group shell → Group recap: renders recap (evidence: `src/app/groups/view/page.tsx`)
- Notifications → Supabase client: loads notifications
- Profile and archive → Supabase client: loads profile data
- Media storage → Supabase services: signs media URLs (evidence: `src/lib/storage.ts`)
- Supabase client → Database model: types client (evidence: `src/lib/supabase.ts`)
- Availability function → Supabase services: queries availability
- Push function → Supabase services: dispatches pushes
- Capacitor app → Group member: hosts mobile app (evidence: `README.md`)
