mirror of
https://github.com/AmanTahiliani/box-box.git
synced 2026-08-07 11:54:59 -04:00
AmanTahiliani
888378e210
The tyre deg panel expanded by default during races and rendered a placeholder row per driver until enough clean laps existed to fit a degradation model. For the first third of a race that was ~525px of 'warming up' rows above the Timing Tower, pushing the tower — the thing the page exists for — off the fold entirely. The panel now opens when it has something to say rather than because the session is a race, and says 'collecting clean laps' while it waits. A reader who toggles it keeps their choice. Also: - Hoist degradationModel into a memo shared by the readiness check and the rows. It is O(laps) per driver and previously re-ran on every render at feed rate. - Order the side rail most-synthesized to most-raw, so a reader arriving mid-session gets 'what just happened' before the regulatory log. - Fade the trailing edge of the nav below 560px. It scrolls with a hidden scrollbar, so the cut-off item read as a clipping bug rather than as scrollable. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
box-box
"Box, box. Box, box." Every F1 race engineer, ever.
box-box is an unofficial F1 race-weekend command center: live timing, Race Hub analytics, championship context, paddock briefing feeds, and local historical data in one Go + React app, with a preserved Bubble Tea TUI.
Live demo: box-box.amantahiliani.com
What It Does
- Command Center: current race-weekend home with GP identity, live status, schedule, championship leaders, and direct analysis links.
- Race Hub: session workspace for overview, race story, strategy, laps, weather, race control, and dataset coverage.
- Live Timing: official F1 SignalR feed bridged through the Go server to the browser via SSE.
- Championship View: standings, form, teammate context, cumulative points, and a simulator.
- Paddock Briefing: RSS/Atom news ingestion for a local race-weekend briefing surface.
- Local-first history: OpenF1 data ingested into a SQLite domain database for fast historical browsing.
- Terminal Mode: Bubble Tea TUI with standings, calendar, driver profiles, live timing, track map, battles, pit window, and replay.
Quickstart
git clone https://github.com/AmanTahiliani/box-box.git
cd box-box
npm install
npm install --prefix frontend
npm run build --prefix frontend
go run ./cmd/main.go --web
# http://localhost:8080
For a local frontend development loop with seeded data, see docs/getting-started.md.
Project Shape
| Area | What lives there |
|---|---|
cmd/main.go |
Entry point for TUI, web server, and ingestion CLI |
internal/web/ |
Go REST API, SSE live bridge, SPA serving |
internal/live/ |
Official F1 SignalR client shared by Web and TUI |
internal/store/, internal/ingest/, internal/query/ |
Local SQLite domain database, ingestion, and read models |
internal/ui/ |
Bubble Tea TUI |
frontend/ |
React + Vite + TypeScript web app |
tests/ |
Playwright e2e and visual coverage |
The Web UI is local-first and should call the Go APIs under /api/v1/...; it should not read OpenF1 directly.
Documentation
- Getting Started: install, build, run modes, TUI keybindings, and web routes.
- Data and Operations: ingestion, environment variables, local files, and live timing notes.
- Testing: Go, frontend, e2e, and visual regression commands.
- Architecture Notes: deeper design rationale, data-source decisions, and phase history.
Status
Pre-beta and actively developed. The Web UI is the primary surface; the TUI is preserved and still useful for terminal workflows. Live timing depends on F1 broadcasting timing data, so it is only fully active during live sessions.
License
MIT © Aman Tahiliani
Unofficial project; not associated with Formula 1 or the FIA.