How baronparedes/wc-event-registration works
WelcomeHub is a React/Supabase event-registration platform. Members register for events through public routes, while authenticated administrators manage events, registrations, members, and attendance; the tree also shows forms, chat, and service-volunteer operations. The router dispatches users into page modules, and domain hooks provide data access. Sampled hooks confirm direct Supabase queries and an attendee cache that combines local storage with realtime updates. The excerpts do not establish every page-to-hook connection, so those links are omitted; the Supabase backend is shown as one external service.
Main entry points: supabase.ts Supabase client · router.tsx Route dispatcher · useAttendeesLocalCacheQuery.ts Attendee cache · App.tsx App shell
Components 22
Application
- App shell
src/App.tsx - Route dispatcher
src/app/router.tsx
Events and Registration
- Public event registration
src/pages - Event administration
src/pages/admin/events - Form administration
src/pages/admin/forms
Community Operations
- Member administration
src/hooks/domain/members - Event attendance
src/pages/admin/events/[id]/attendance - Service attendance
src/hooks/domain/services - Admin chat
src/pages/admin/chat
Data Access
- Event queries
src/hooks/domain/events - Registration operations
src/hooks/domain/registrations - Public registration
src/hooks/domain/public-registrations - Form queries
src/hooks/domain/forms - Attendance operations
src/hooks/domain/attendance - Attendee cache
src/hooks/domain/attendance/queries/useAttendeesLocalCacheQuery.ts - Admin authentication
src/hooks/domain/auth - Supabase client
src/lib/infrastructure/supabase.ts
Other components
- Visitor
- Administrator
- Browser storage
- Supabase realtime
- Supabase backend
Connections 19
- Visitor → Route dispatcher: opens public routes
- Administrator → Route dispatcher: opens admin routes
- App shell → Route dispatcher: mounts routes
- Route dispatcher → Public event registration: dispatches
- Route dispatcher → Event administration: dispatches
- Route dispatcher → Form administration: dispatches
- Route dispatcher → Event attendance: dispatches
- Route dispatcher → Admin chat: dispatches
- Event queries → Supabase client: queries
- Registration operations → Supabase client: queries
- Public registration → Supabase client: queries
- Member administration → Supabase client: queries
- Service attendance → Supabase client: queries
- Attendance operations → Supabase client: queries
- Form queries → Supabase client: queries
- Admin authentication → Supabase client: auth access
- Supabase client → Supabase backend: accesses
- Attendee cache → Browser storage: reads and writes
- Attendee cache → Supabase realtime: subscribes