How palcchi/passflow works
PassFlow is a multi-event platform for organizers to configure events and attendees to register, claim a shared wristband/digital-pass credential, and use it at scanner stations. Its operational path runs from public event registration through credential claim to server-side scan validation and logging. Organizer tools cover event management, attendee exports, wristband printing, and Figma-based design exports; authentication and event-scoped data underpin these workflows. The README documents additional operational areas such as activity monitoring and access rules, but their implementation wiring is not shown in the sampled source.
Main entry points: session.ts Session And Membership · page.tsx Organizer Dashboard · figma/route.ts Figma Design Export · scan/route.ts Scan Validation API
Components 27
Identity
- Sign In And Account
app/login/page.tsx - Auth Actions
app/auth/actions.ts - Auth Callbacks
app/auth/callback/route.ts - Session And Membership
lib/auth/session.ts
Organizer Tools
- Organizer Dashboard
app/admin/page.tsx - Event Management
app/admin/events/[eventId]/page.tsx - Event Settings
app/admin/events/[eventId]/settings/page.tsx - Event Appearance
app/admin/events/[eventId]/appearance/page.tsx - Pass Design
app/admin/events/[eventId]/design/page.tsx - Attendee Management
app/admin/events/[eventId]/people/page.tsx - Attendee Export
app/admin/events/[eventId]/export/attendees/route.ts - Figma Design Export
app/admin/events/[eventId]/export/figma/route.ts - Wristband Printing
app/admin/events/[eventId]/wristbands/print/page.tsx - Activity And Logs
app/admin/events/[eventId]
Attendee Access
- Public Event Page
app/e/[slug]/page.tsx - Event Registration
app/event-actions.ts - Pass Claim
app/e/[slug]/claim/page.tsx - Scanner Station
app/scan/[stationId]/page.tsx - Scan Validation API
app/api/scan/route.ts
Data And Integrations
- Supabase
- Figma
- Event Data Access
lib/events.ts - Figma Connection
app/api/figma/connect/route.ts - Figma Callback
app/api/figma/callback/route.ts
Other components
- Organizer
- Attendee
- Scanner Staff
Connections 30
- Attendee → Sign In And Account: signs in
- Sign In And Account → Auth Actions: submits credentials
- Auth Actions → Supabase: authenticates
- Auth Callbacks → Supabase: verifies session
- Session And Membership → Supabase: checks session
- Organizer → Organizer Dashboard: opens dashboard
- Organizer Dashboard → Session And Membership: requires membership
- Organizer Dashboard → Event Data Access: loads events
- Event Data Access → Supabase: reads events
- Organizer → Event Management: manages event
- Event Management → Session And Membership: requires membership
- Organizer → Event Appearance: edits branding
- Organizer → Pass Design: edits pass design
- Organizer → Attendee Management: manages attendees
- Attendee Management → Attendee Export: exports attendees
- Attendee Export → Supabase: reads attendee data
- Pass Design → Figma Design Export: exports pass design
- Figma Design Export → Supabase: reads design and credentials
- Figma Design Export → Figma: fetches design assets
- Organizer → Wristband Printing: prints wristbands
- Attendee → Public Event Page: views event
- Public Event Page → Event Data Access: loads event
- Attendee → Event Registration: registers
- Event Registration → Supabase: creates attendee
- Attendee → Pass Claim: claims credential
- Pass Claim → Supabase: claims pass
- Scanner Staff → Scanner Station: scans credential
- Scanner Station → Scan Validation API: submits scan
- Scan Validation API → Session And Membership: checks session
- Scan Validation API → Supabase: validates and logs