How vinayakbhat19/signals works
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: live-store.ts Live feed and fallback · client.ts Supabase client · hunt/page.tsx Stamp hunt · app/page.tsx Home feed
Components 21
Festival guide
- Home feed
app/page.tsx - Event listings
app/events/page.tsx - Event details
app/event/page.tsx - Schedule and venues
app/schedule/page.tsx - Results and archive
app/results/page.tsx - Announcements
app/announcements/page.tsx - Live feed and fallback
lib/live-store.ts
Games and voting
- Audience voting
app/vote/page.tsx - Stamp hunt
app/hunt/page.tsx - QR scanning
components/qr-scanner-client.tsx - Hunt leaderboard
app/hunt/leaderboard/page.tsx
Festival operations
- Host event tools
app/host/event/page.tsx - Participant management
app/host/participants/page.tsx - Admin operations
app/admin/page.tsx - Staff account worker
workers/staff/index.js
Identity and data
- Auth and roles
lib/use-auth.ts - Supabase client
lib/supabase/client.ts
Signals board
- Signals board
app/signals/page.tsx
Other components
- Festival visitors
- Organisers and hosts
- Supabase data services
Connections 23
- Festival visitors → Home feed: opens
app/page.tsx - Home feed → Live feed and fallback: loads feed
app/page.tsx - Festival visitors → Event listings: browses
app/events/page.tsx - Event listings → Live feed and fallback: loads feed
app/events/page.tsx - Festival visitors → Event details: opens event
- Event details → Live feed and fallback: reads feed
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
lib/live-store.ts - Supabase client → Supabase data services: connects
lib/supabase/client.ts - Festival visitors → Audience voting: votes
README.md - Festival visitors → Stamp hunt: plays
app/hunt/page.tsx - Stamp hunt → Supabase client: reads and writes
app/hunt/page.tsx - Stamp hunt → QR scanning: links to scanner
app/hunt/page.tsx - Stamp hunt → Hunt leaderboard: links to leaderboard
app/hunt/page.tsx - Organisers and hosts → Host event tools: updates events
README.md - Organisers and hosts → Participant management: manages entrants
README.md - Organisers and hosts → Admin operations: manages festival
- Admin operations → Staff account worker: creates staff accounts
README.md - Host event tools → Supabase client: uses data service
app/host/event/page.tsx - Auth and roles → Supabase client: creates client
lib/use-auth.ts - Festival visitors → Signals board: uses board