How dance-engine/the-engine works
Dance Engine is an event and membership platform with branded public client sites, an authenticated administration app, and operational tools. The principal workflow is: an attendee discovers an event, views its details or media, joins or purchases a bundle, and reaches a success state; administrators configure events, customers, tickets, media, and organisations. Scanner and survey tools provide operational follow-up. The tree supports these route-level capabilities, while many backend persistence and Lambda implementations are not sampled.
Main entry points: ProtectedLayout.tsx Admin Shell · [ksuid]/page.tsx Event Detail · route.ts Checkout API · app/page.tsx Scanner UI
Components 31
Public Experiences
- Client Site
apps/clients/solo/app/page.tsx - Event Catalog
apps/clients/solo/app/events/page.tsx - Event Detail
apps/clients/solo/app/events/[ksuid]/page.tsx - Cart State
apps/clients/solo/contexts/CartContext.tsx - Checkout API
apps/clients/solo/app/api/stripe/checkout_session/route.ts - Checkout Success
apps/clients/solo/app/checkout/success/page.tsx - Media Gallery
apps/clients/solo/app/events/[ksuid]/media/page.tsx - Membership Join
apps/clients/solo/app/join/page.tsx
Admin Platform
- Admin Shell
apps/core/app/ProtectedLayout.tsx - Event Management
apps/core/app/events/page.tsx - Customer Management
apps/core/app/customers/page.tsx - Ticket Management
apps/core/app/events/[ksuid]/tickets/page.tsx - Media Management
apps/core/app/media/page.tsx - Organisation Setup
apps/core/app/admin/onboarding/start/page.tsx
Field Tools
- Scanner UI
apps/tools/scanner/app/page.tsx - Scanner Check
apps/tools/scanner/app/api/mock/scanner/check/route.ts - Ticket Marking
apps/tools/scanner/app/api/mock/scanner/mark-used/route.ts - Survey Form
apps/tools/survey/app/page.tsx - Survey API
apps/tools/survey/app/api/survey/route.ts - Survey Results
apps/tools/survey/app/api/survey/results/route.ts - Results Dashboard
apps/tools/survey/app/results/ResultsDashboard.tsx
Content Integrations
- Sanity Rendering
apps/clients/solo/components/content/SanityPage.tsx - Sanity Content
apps/clients/solo/lib/sanity/content.ts - Sanity Studio
apps/core/app/content/[[...index]]/Studio.tsx
Other components
- Attendee
- Administrator
- Scanner Operator
- Survey Respondent
- Stripe
- Sanity CMS
- Clerk Auth
Connections 27
- Attendee → Client Site: visits
- Client Site → Event Catalog: shows events
- Event Catalog → Event Detail: opens event
- Event Detail → Cart State: adds items
- Cart State → Checkout API: submits cart
- Checkout API → Stripe: creates checkout
- Checkout API → Checkout Success: redirects result
- Event Detail → Media Gallery: opens media
- Attendee → Membership Join: joins
- Membership Join → Sanity Content: loads content
- Administrator → Admin Shell: opens console
- Admin Shell → Clerk Auth: authenticates
- Admin Shell → Event Management: dispatches events
- Admin Shell → Customer Management: dispatches customers
- Admin Shell → Ticket Management: dispatches tickets
- Admin Shell → Media Management: dispatches media
- Administrator → Organisation Setup: starts onboarding
- Scanner Operator → Scanner UI: scans tickets
- Scanner UI → Scanner Check: checks ticket
- Scanner UI → Ticket Marking: marks used
- Survey Respondent → Survey Form: answers survey
- Survey Form → Survey API: submits answers
- Survey Results → Results Dashboard: provides results
- Sanity Rendering → Sanity Content: loads pages
- Sanity Content → Sanity CMS: reads content
- Administrator → Sanity Studio: edits content
- Sanity Studio → Sanity CMS: publishes content