🎪 FunFirst

Overview

Liveredwave extracted to own repo (2026-09-03)

battleloco.com wrestleloco.com comedyloco.com headcaseai.com

App features

• Multi-brand hosting — one Next.js app; host rewrites in middleware.ts + vercel.json map each branded domain to its route, with clean URLs (battleloco.com/performance?id=…) and 308 redirects from legacy slug routes.
• Performance console — setlist mode (segments, Begin Segment) and competition mode (rounds, teams, scoring, Win/Rotation); cue board whose game buttons play designed scenes matching the cue (Game Instructions, Vote, Winner…); scoreboard, box score, soundtrack/SFX library, camera feed.
• Overlay HUD — shared overlays.tsx renders Game Instructions (round/game/now-playing), Vote (team vs team), Winner, Score variants, Introductions — composited in the player and on the preview wall alike.
• Show Designer — layouts/screens/panels, shows + ordered scenes + per-scene effect libraries (video loops and stills), display profiles.
• All-screens preview — /preview wall of every screen plus a scene strip; paints only live shows, infers overlay cues from scene titles, with a text-scene fallback card for text-only scenes.
• Audience phone bits — HeadCase phone-vote games (Burn Roulette, True or Cap, Will It Land, Caption Fight, Channel Surf) on the existing vote pipeline; four canned options, zero typing.
• Idempotent seeders — per-show seeders keyed by sourceKey (battlelocoLuxor, wrestlelocoLuxor, comedylocoLuxor, weddingShows, headcaseBits) — re-runs insert 0.
• AI-generated assets — branded stills and video loops under public/<brand>/effects/.

Flow

Request

1. Browser hits a brand domain → Vercel vercel.json host rewrite (/ → /battle-loco etc.); middleware handles the rest per host.
2. Marketing pages are static-ish routes; console/preview/player are client components over Convex React queries (game.get, designer.getShowScenes, designer.getSceneEffects, designer.getLayout).
3. Cueing a scene mutates the live show; the wall, player, and phone overlays react via Convex subscriptions.

Deploy

Vercel git integration: push to main → funfirst-web auto-deploys (root apps/funfirst-web, build cd ../.. && pnpm --filter funfirst-web build). Same pattern for surroundshow-web and the separate redwave repo. Convex functions deploy manually per deployment: npx convex deploy --env-file packages/backend/.env.<deployment> — funfirst and surroundshow each have their own data.

Seeding

seeder module (e.g. comedylocoLuxor.ts)  —  SCENES / EFFECTS specs + FX assets
        │  match by sourceKey (cl-luxor:scene:NN, wed-cer:effect:…)
        ▼
upsert shows (status live) · scenes · effects · displayProfiles
        │
        ▼
performance row bound to show  →  console + preview + phones

Tech

apps/funfirst-web/
  app/battle-loco · wrestle-loco · comedy-loco · head-case   # brand routes
  app/preview · screens · designer · player · venue · camera # engine routes
  middleware.ts · vercel.json                                # host mapping
packages/backend/convex/
  schema.ts · game.ts · designer.ts · shows.ts               # engine
  battlelocoLuxor.ts · wrestlelocoLuxor.ts · comedylocoLuxor.ts
  weddingShows.ts · headcaseBits.ts · seed.ts                # seeders
  .env.funfirst · .env.surroundshow                          # deploy keys (gitignored)

🗂️ Roadmap

• ☐ #56 Phone voting for Comedy Loco / Battle Loco / Wrestle Loco (phone-vote pipeline is HeadCase-only today).
• ☐ #57 Clean up ~865 CSV-imported HeadCase sketch shows cluttering the show picker.
• ☐ #58 game.create still seeds legacy SHARED_TRACKS performanceTracks on new Battle performances (locos.ts).
• ☐ #59 redwaveplan.com still needs its DNS flipped to Vercel (demhistory.org / primaryplan.org already live).
• ☐ #60 status.sh board script regression (curl file-read errors) needs a fix.

Live roadmap, managed as GitHub issues (linkall issues). Add or close items on GitHub — ☑ = done, close as “not planned” to remove.

Test results

2026-09-04 — preview + data fixes

• Preview wall now composites the overlay HUD for live cue scenes (PR #39; shared overlays.tsx, player call sites unchanged).
• Wedding Ceremony/Reception shows promoted draft → live on surroundshow; preview walls verified painting (PR #40).
• HeadCase Bits Night wall seeded (Head layout + profile + still/text effects); camera layer transparent until a WebRTC track arrives; text-scene fallback cards added. Typecheck + funfirst-web build green.

2026-09-03 — cleanup + extraction

• Old Comedy Loco soundtrack cues removed from Battle Loco; crazyball renamed to Comedy Loco everywhere (PRs #37/#38; full-text scan: 0 crazyball hits across 23 tables).
• Redwave extracted to microspaces/redwave; demhistory.org + primaryplan.org live with recreated LinkAll8 pages.

Seeded shows (verified live) — Battle Loco Luxor Oct 17 (22 scenes), Wrestle Loco Luxor Night 1 (28), Comedy Loco Luxor Night 1 (28), Wedding Ceremony (22) / Reception (26), HeadCase Bits Night.

🧪 Pair test plan

Loco pair test plans — projects/funfirst-test-plan.html (index: shared protocol, brand matrix, cross-brand isolation) with one plan per brand: Battle · Wrestle · Comedy · Bar · Wedding — the live two-tester walkthroughs we execute together: Show Designer (shows, scenes, effects, screens, profiles), the performance console (rounds, scoring, cues, setlist segments), the preview wall and players, brand isolation, and hardening probes — with the results-and-issue log filled in as we go.