Build Log
ForgeHome — Handoff Game + Voice Capture
June 19, 2026
forgehomehandoffgame-mechanicsvoiceai-parse
1
New DB table (handoff_games)
2
New pages (/handoff redesign + /handoff/game)
1
New API route (/api/capture/parse)
4
Server actions (generate, markPlay, submitGame, refOverride)
0
Type errors at commit
Timeline
Start
Designed the mechanic before writing code
Three rounds of product questions: confirm/passive/ref mechanic, prize vs punishment, scope. Built in the right direction.
20 min
handoff_games schema + db:push
Plays (JSON), completions, score, grade, AI suggestion (prize+punishment), ref overrides, ref grade, ref note, status enum
45 min
generateHandoffGame action
AI generates announcer summary, play list with point values, prize and punishment in one pass
1h
Courtney's handoff page + ref panel
Generate button, play status view, score reveal, full ref override UI with per-play rulings, grade override, trash talk note
1.5h
Zeb's /handoff/game page
Tap-to-toggle checklist, live scoreboard, submit card, score reveal with TD/fumble/first-down result + prize or punishment
1.75h
Season stats card
Games, TDs, fumbles, avg score, streak tracker (TD streak vs fumble streak), game log
2h
Voice capture for route items
Mic button on /capture, Web Speech API, /api/capture/parse extracts title+type+priority+date, pre-fills form
End
Commit + push + retro
11 files, 1291 insertions
“Voice in the car should land you on a form that's ready to confirm — not ready to type. The confirm tap is the UI. Everything else is invisible.”