afiche

Cartelera curada de Buenos Aires

afiche pulls the weekly programming of Buenos Aires' independent and repertory cinemas into one clean, editorial-feel cartelera — one screen for the whole indie circuit, built for people who already know the difference between a Saturday at Lugones and a Saturday at Hoyts. Live at afiche.ar — Next.js on Vercel, libSQL on Turso.

What it does

• One row per film, scoped to a time window. The homepage groups every screening by film (not showtime) for a relative window — Hoy (default), Este finde, Esta semana, Próximamente — switchable via ?ventana=hoy|finde|semana|prox (shareable; an unknown value falls back to hoy). A single-showtime film renders an inline time · venue; a multi-showtime film collapses to a {n} funciones · {venue} summary that taps open. Prod data earns the layout: 64% of films have one showtime all week and 95% play a single venue, so the common row is one clean line.
• A curated "Destacados" band. Above the film grid sits a full-bleed row of 0–4 hand-picked poster cards. Curation is visible, not buried behind a toggle.
• An exhaustive day-by-day view at /cartelera. One tap from the homepage ("Ver todo →"): a 14-day rolling window of full cards grouped by day, a sticky date strip, and a Próximamente text index for the longer tail.
• Per-film pages with cross-venue discovery. /pelicula/<slug> gives each film a title block, an optional 16:9 editorial still, poster, synopsis, top-billed cast — and the killer feature: every upcoming screening of that film across BA, in one list. It answers "when else can I catch this?", which no single venue's own site can.
• Rich, deduplicated film cards. Each film is enriched from TMDB (poster, backdrop, director, runtime, country, original title, Spanish synopsis, genres, cast). The same film surfacing with title drift across cinemas collapses to one entry, and a title-ambiguity guard keeps the three Nosferatus apart.

What it doesn't do (yet)

• No on-site search or filters — the cartelera is the index. Title + director search exists in the data layer and is exposed over MCP, but it has no UI on the site yet; that's queued behind /pelicula/ usage data.
• No per-cinema programming pages, and no /programa/<slug> pages for curated cycles (Lugones Olivera-Aries, MALBA Cineclub Nocturna). Cycles are denormalized text on screenings for now.
• No chains. afiche covers the indie / repertory circuit only; Cinépolis and the multiplexes are intentionally out. This is the indie-circuit cartelera, not all of BA cinema.
• No dark mode — the editorial cream + carmine palette is the brand.

Cinemas covered

Cinema	Neighborhood	Type	Source
Sala Leopoldo Lugones	San Nicolás	indie / repertory	complejoteatral.gob.ar
MALBA	Palermo	indie / museum	malba.org.ar
Cine Lorca	San Nicolás	indie / repertory	cinelorca.wixsite.com (VLM-extracted poster)
Cine Cosmos	Balvanera	indie / repertory	cinecosmos.uba.ar
Cine York	Olivos	indie / repertory	lumiton.ar
Centro Cultural Munro	Munro	indie / community	lumiton.ar
Lumiton	Munro	indie / museum	lumiton.ar
Cine Gaumont	San Nicolás	indie / repertory (INCAA)	cinegaumont.ar (Cinexo ticketing JSON API)
CineArte Cacodelphia	San Nicolás	indie / repertory	cineartecacodelphia.com.ar (adro.studio JSON API)
Centro Cultural Borges	San Nicolás	indie / cultural center	centroculturalborges.gob.ar
Cineclub Lucero	Palermo	indie / cineclub	eventbrite.com (organizer feed)
Cinta	Palermo	indie / open-air terrace	passline.com (producer page)
El Cairo	Rosario	indie / public cinema (Santa Fe province)	elcairocinepublico.gob.ar (The Events Calendar REST API)

Architecture

graph LR
  V["12 venue sites<br/>lugones · malba · gaumont<br/>lorca · cosmos · york · …"]

  subgraph pipeline["Scrape pipeline · scrape-prod.sh (residential IP)"]
    R["run.ts<br/>orchestrator"]
    P["Provider.fetch() x12<br/>→ ScrapedScreening[]"]
    I["ingest()<br/>upsert films · replace future<br/>screenings · enrich"]
  end

  TMDB["TMDB API<br/>match (similarity) + enrich"]
  D[("Turso / SQLite · Drizzle<br/>cinemas · films · screenings<br/>providers · scrapeRuns<br/>tmdbOverrides · healRuns")]

  subgraph web["Next.js 16 · RSC on Vercel"]
    Q["queries.ts"]
    PAGES["/ · /cartelera<br/>/pelicula/[slug] · /sala/[id]"]
    ADMIN["/admin<br/>signed-cookie auth<br/>manual TMDB match"]
    REV["/api/revalidate"]
  end

  U(("visitor"))

  V -->|HTML / JSON| P
  R -->|drives| P
  P -->|screenings| I
  I <-->|lookup + enrich| TMDB
  I -->|upsert| D
  R -.->|POST when done| REV
  REV -.->|revalidate ISR| PAGES
  D --> Q --> PAGES
  ADMIN <-->|read / fix| D
  U --> PAGES

This is the beginning of the README. Read the rest at the original. Read the full README ↗