# vinayakbhat19/signals architecture

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

## Overview

Fest Live is a mobile-oriented live festival guide, with event schedules, announcements, results, audience voting and an optional QR stamp hunt; the repository also includes the Signals community board. Students browse live event information and participate in activities, while hosts and organisers manage event details and festival operations. The sampled code shows the home and event feed reading through a resilient live store, and the hunt page accessing Supabase directly. Other capabilities are represented from the README and route tree; their internal wiring was not sampled, so those links are omitted.

Main entry points: [`lib/live-store.ts`](https://github.com/vinayakbhat19/signals/blob/main/lib/live-store.ts) (Live feed and fallback), [`lib/supabase/client.ts`](https://github.com/vinayakbhat19/signals/blob/main/lib/supabase/client.ts) (Supabase client), [`app/hunt/page.tsx`](https://github.com/vinayakbhat19/signals/blob/main/app/hunt/page.tsx) (Stamp hunt), [`app/page.tsx`](https://github.com/vinayakbhat19/signals/blob/main/app/page.tsx) (Home feed)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_guide["Festival guide"]
  node_home["Home feed<br/>[page.tsx]"]
  node_events["Event listings<br/>[page.tsx]"]
  node_event_detail["Event details<br/>[page.tsx]"]
  node_schedule["Schedule and venues<br/>[page.tsx]"]
  node_results["Results and archive<br/>[page.tsx]"]
  node_announcements["Announcements<br/>[page.tsx]"]
  node_live_store["Live feed and fallback<br/>[live-store.ts]"]
end

subgraph group_participation["Games and voting"]
  node_voting["Audience voting<br/>[page.tsx]"]
  node_hunt["Stamp hunt<br/>[page.tsx]"]
  node_qr_scan["QR scanning"]
  node_hunt_board["Hunt leaderboard<br/>[page.tsx]"]
end

subgraph group_operations["Festival operations"]
  node_host_tools["Host event tools<br/>[page.tsx]"]
  node_participants["Participant management<br/>[page.tsx]"]
  node_admin["Admin operations<br/>[page.tsx]"]
  node_staff_worker["Staff account worker<br/>[index.js]"]
end

subgraph group_identity["Identity and data"]
  node_auth["Auth and roles<br/>[use-auth.ts]"]
  node_supabase_client["Supabase client<br/>[client.ts]"]
end

subgraph group_signals["Signals board"]
  node_signals["Signals board<br/>[page.tsx]"]
end

node_students(("Festival visitors"))
node_organisers(("Organisers and hosts"))
node_supabase[("Supabase data services")]

node_students -->|"opens"| node_home
node_home -->|"loads feed"| node_live_store
node_students -->|"browses"| node_events
node_events -->|"loads feed"| node_live_store
node_students -->|"opens event"| node_event_detail
node_event_detail -->|"reads feed"| node_live_store
node_schedule -->|"reads feed"| node_live_store
node_results -->|"reads feed"| node_live_store
node_announcements -->|"reads feed"| node_live_store
node_live_store -->|"queries"| node_supabase_client
node_supabase_client -->|"connects"| node_supabase
node_students -->|"votes"| node_voting
node_students -->|"plays"| node_hunt
node_hunt -->|"reads and writes"| node_supabase_client
node_hunt -->|"links to scanner"| node_qr_scan
node_hunt -->|"links to leaderboard"| node_hunt_board
node_organisers -->|"updates events"| node_host_tools
node_organisers -->|"manages entrants"| node_participants
node_organisers -.->|"manages festival"| node_admin
node_admin -.->|"creates staff accounts"| node_staff_worker
node_host_tools -->|"uses data service"| node_supabase_client
node_auth -->|"creates client"| node_supabase_client
node_students -.->|"uses board"| node_signals

click node_home "https://github.com/vinayakbhat19/signals/blob/main/app/page.tsx"
click node_events "https://github.com/vinayakbhat19/signals/blob/main/app/events/page.tsx"
click node_event_detail "https://github.com/vinayakbhat19/signals/blob/main/app/event/page.tsx"
click node_schedule "https://github.com/vinayakbhat19/signals/blob/main/app/schedule/page.tsx"
click node_results "https://github.com/vinayakbhat19/signals/blob/main/app/results/page.tsx"
click node_announcements "https://github.com/vinayakbhat19/signals/blob/main/app/announcements/page.tsx"
click node_live_store "https://github.com/vinayakbhat19/signals/blob/main/lib/live-store.ts"
click node_voting "https://github.com/vinayakbhat19/signals/blob/main/app/vote/page.tsx"
click node_hunt "https://github.com/vinayakbhat19/signals/blob/main/app/hunt/page.tsx"
click node_qr_scan "https://github.com/vinayakbhat19/signals/blob/main/components/qr-scanner-client.tsx"
click node_hunt_board "https://github.com/vinayakbhat19/signals/blob/main/app/hunt/leaderboard/page.tsx"
click node_host_tools "https://github.com/vinayakbhat19/signals/blob/main/app/host/event/page.tsx"
click node_participants "https://github.com/vinayakbhat19/signals/blob/main/app/host/participants/page.tsx"
click node_admin "https://github.com/vinayakbhat19/signals/blob/main/app/admin/page.tsx"
click node_staff_worker "https://github.com/vinayakbhat19/signals/blob/main/workers/staff/index.js"
click node_auth "https://github.com/vinayakbhat19/signals/blob/main/lib/use-auth.ts"
click node_supabase_client "https://github.com/vinayakbhat19/signals/blob/main/lib/supabase/client.ts"
click node_signals "https://github.com/vinayakbhat19/signals/blob/main/app/signals/page.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_home,node_events,node_event_detail,node_schedule,node_results,node_announcements,node_live_store toneBlue
class node_voting,node_hunt,node_qr_scan,node_hunt_board,node_supabase toneAmber
class node_host_tools,node_participants,node_admin,node_staff_worker toneMint
class node_auth,node_supabase_client toneRose
class node_signals,node_students,node_organisers toneIndigo
```

## Components

### Festival guide

- [Home feed](https://github.com/vinayakbhat19/signals/blob/main/app/page.tsx): `app/page.tsx`
- [Event listings](https://github.com/vinayakbhat19/signals/blob/main/app/events/page.tsx): `app/events/page.tsx`
- [Event details](https://github.com/vinayakbhat19/signals/blob/main/app/event/page.tsx): `app/event/page.tsx`
- [Schedule and venues](https://github.com/vinayakbhat19/signals/blob/main/app/schedule/page.tsx): `app/schedule/page.tsx`
- [Results and archive](https://github.com/vinayakbhat19/signals/blob/main/app/results/page.tsx): `app/results/page.tsx`
- [Announcements](https://github.com/vinayakbhat19/signals/blob/main/app/announcements/page.tsx): `app/announcements/page.tsx`
- [Live feed and fallback](https://github.com/vinayakbhat19/signals/blob/main/lib/live-store.ts): `lib/live-store.ts`

### Games and voting

- [Audience voting](https://github.com/vinayakbhat19/signals/blob/main/app/vote/page.tsx): `app/vote/page.tsx`
- [Stamp hunt](https://github.com/vinayakbhat19/signals/blob/main/app/hunt/page.tsx): `app/hunt/page.tsx`
- [QR scanning](https://github.com/vinayakbhat19/signals/blob/main/components/qr-scanner-client.tsx): `components/qr-scanner-client.tsx`
- [Hunt leaderboard](https://github.com/vinayakbhat19/signals/blob/main/app/hunt/leaderboard/page.tsx): `app/hunt/leaderboard/page.tsx`

### Festival operations

- [Host event tools](https://github.com/vinayakbhat19/signals/blob/main/app/host/event/page.tsx): `app/host/event/page.tsx`
- [Participant management](https://github.com/vinayakbhat19/signals/blob/main/app/host/participants/page.tsx): `app/host/participants/page.tsx`
- [Admin operations](https://github.com/vinayakbhat19/signals/blob/main/app/admin/page.tsx): `app/admin/page.tsx`
- [Staff account worker](https://github.com/vinayakbhat19/signals/blob/main/workers/staff/index.js): `workers/staff/index.js`

### Identity and data

- [Auth and roles](https://github.com/vinayakbhat19/signals/blob/main/lib/use-auth.ts): `lib/use-auth.ts`
- [Supabase client](https://github.com/vinayakbhat19/signals/blob/main/lib/supabase/client.ts): `lib/supabase/client.ts`

### Signals board

- [Signals board](https://github.com/vinayakbhat19/signals/blob/main/app/signals/page.tsx): `app/signals/page.tsx`

### Other components

- **Festival visitors**
- **Organisers and hosts**
- **Supabase data services**

## Connections

- Festival visitors → Home feed: opens (evidence: `app/page.tsx`)
- Home feed → Live feed and fallback: loads feed (evidence: `app/page.tsx`)
- Festival visitors → Event listings: browses (evidence: `app/events/page.tsx`)
- Event listings → Live feed and fallback: loads feed (evidence: `app/events/page.tsx`)
- Festival visitors → Event details: opens event
- Event details → Live feed and fallback: reads feed (evidence: `app/event/page.tsx`)
- Schedule and venues → Live feed and fallback: reads feed
- Results and archive → Live feed and fallback: reads feed
- Announcements → Live feed and fallback: reads feed
- Live feed and fallback → Supabase client: queries (evidence: `lib/live-store.ts`)
- Supabase client → Supabase data services: connects (evidence: `lib/supabase/client.ts`)
- Festival visitors → Audience voting: votes (evidence: `README.md`)
- Festival visitors → Stamp hunt: plays (evidence: `app/hunt/page.tsx`)
- Stamp hunt → Supabase client: reads and writes (evidence: `app/hunt/page.tsx`)
- Stamp hunt → QR scanning: links to scanner (evidence: `app/hunt/page.tsx`)
- Stamp hunt → Hunt leaderboard: links to leaderboard (evidence: `app/hunt/page.tsx`)
- Organisers and hosts → Host event tools: updates events (evidence: `README.md`)
- Organisers and hosts → Participant management: manages entrants (evidence: `README.md`)
- Organisers and hosts → Admin operations: manages festival
- Admin operations → Staff account worker: creates staff accounts (evidence: `README.md`)
- Host event tools → Supabase client: uses data service (evidence: `app/host/event/page.tsx`)
- Auth and roles → Supabase client: creates client (evidence: `lib/use-auth.ts`)
- Festival visitors → Signals board: uses board
