SF Movie Club — Documentation

A living reference for the codebase. Each page is auto-populated from the current state of the project.

SF Movie Club is a private invite-only app for friends in San Francisco who want to coordinate seeing movies together at AMC Metreon 16 and AMC Kabuki 8. Members vote on what's currently playing, browse real AMC showtimes for the next ~21 days, RSVP to specific screenings, and log what they've watched.

In this docs center

Architecture

Tech stack, folder layout, frontend↔backend wiring, schema overview.

Components

Major components, where they're used, and their inputs.

Data flow

How data moves from input → UI → DB → realtime back to UI. Auth flow.

API

React Query hooks, Supabase tables, scrape endpoint.

Dependencies

Third-party services and libraries — what they do, what breaks without them.

Project at a glance

  • Stack: TanStack Start v1 + React 19 + Vite 7 + Tailwind v4
  • Backend: Lovable Cloud (Supabase) — Postgres, Auth, Realtime
  • Showtime data: Firecrawl-scraped AMC site, on-demand sync endpoint
  • Auth gates: sign in → invite code → onboarding → app