How rohini258/spott works
Spot is an event-discovery and management application. Attendees browse events, inspect details, register, and access tickets; organizers create events and manage attendance, including QR check-in. Convex provides the application data/functions, while client hooks wrap its queries and mutations. The graph also retains the documented-by-tree exploration, search, onboarding, AI-assisted creation, and seed-data branches. Several backend and page implementations are unsampled, so their relationships are included only where excerpts or the source index show them.
Main entry points: [eventId]/page.jsx Event dashboard · create-event/page.jsx Create event · [slug]/page.jsx Event details · use-onboarding.jsx Onboarding state
Components 28
Attendee discovery
- Explore events
spot/app/(public)/explore/page.jsx - Event cards
spot/components/event-card.jsx - Explore detail
spot/app/(public)/explore/[slug]/page.jsx - Event details
spot/app/(public)/events/[slug]/page.jsx - Registration flow
spot/app/(public)/events/[slug]/components/register-modal.jsx - My tickets
spot/app/(main)/my-tickets/page.jsx - Onboarding
spot/components/onboarding-modal.jsx
Organizer tools
- Create event
spot/app/(main)/create-event/page.jsx - AI event creator
spot/app/(main)/create-event/_components/ai-event-creator.jsx - Event generation API
spot/app/api/generate-event/route.js - Organizer events
spot/app/(main)/my-events/page.jsx - Event dashboard
spot/app/(main)/my-events/[eventId]/page.jsx - Attendee record
spot/app/(main)/my-events/[eventId]/_components/attendee-card.jsx - QR check-in
spot/app/(main)/my-events/[eventId]/_components/qr-scanner-modal.jsx
Application platform
- Onboarding state
spot/hooks/use-onboarding.jsx - Convex query hooks
spot/hooks/use-convex-query.js - User sync
spot/hooks/use-store-user.js - Convex client
spot/app/ConvexClientProvider.jsx
Convex data
- Event search
spot/convex/search.js - Event functions
spot/convex/events.js - Explore functions
spot/convex/explore.js - Registration functions
spot/convex/registrations.js - Dashboard functions
spot/convex/dashboard.js - User functions
spot/convex/users.js - Data schema
spot/convex/schema.js - Sample event seeding
spot/convex/seed.js
Other components
- Attendee
- Organizer
Connections 29
- Attendee → Explore events: browses
- Explore events → Event search: searches
- Explore events → Event cards: renders
- Attendee → Event details: opens event
- Event details → Event functions: queries event
spot/app/(public)/events/[slug]/page.jsx - Event details → Registration functions: checks registration
spot/app/(public)/events/[slug]/page.jsx - Event details → Registration flow: opens modal
spot/app/(public)/events/[slug]/page.jsx - Attendee → My tickets: views tickets
- Attendee → Onboarding state: starts onboarding
- Onboarding state → Convex query hooks: queries user
spot/hooks/use-onboarding.jsx - Onboarding state → User functions: reads user
spot/hooks/use-onboarding.jsx - Onboarding state → Onboarding: shows
- Organizer → Create event: creates event
- Create event → AI event creator: renders
spot/app/(main)/create-event/page.jsx - AI event creator → Event generation API: requests generation
- Create event → Convex query hooks: uses mutations
spot/app/(main)/create-event/page.jsx - Create event → User functions: queries user
spot/app/(main)/create-event/page.jsx - Create event → Event functions: creates event
spot/app/(main)/create-event/page.jsx - Organizer → Organizer events: manages events
- Organizer events → Event dashboard: opens event
- Event dashboard → Convex query hooks: uses queries
spot/app/(main)/my-events/[eventId]/page.jsx - Event dashboard → Registration functions: loads attendees
spot/app/(main)/my-events/[eventId]/page.jsx - Event dashboard → Dashboard functions: deletes event
spot/app/(main)/my-events/[eventId]/page.jsx - Event dashboard → Attendee record: renders
spot/app/(main)/my-events/[eventId]/page.jsx - Event dashboard → QR check-in: opens scanner
spot/app/(main)/my-events/[eventId]/page.jsx - User sync → User functions: stores user
spot/hooks/use-store-user.js - Convex client → Convex query hooks: provides client
- Event search → Data schema: queries events
spot/convex/search.js - Sample event seeding → Data schema: writes records
spot/convex/seed.js