🏎️ box-box

"Box, box. Box, box." — Every F1 Race Engineer, ever.

⚠️ Disclaimer: This project is currently in a pre-beta state. Features may be incomplete, and you might encounter bugs as we fine-tune the engine.

box-box is a high-performance Formula 1 Terminal User Interface (TUI) built for fans who live in the command line. Get real-time standings, race calendars, and deep-dive driver stats without ever leaving your terminal.

✨ Features

🏆 Live Standings: Keep track of the Driver and Constructor Championships.
📅 Race Calendar: The full 2025 schedule at your fingertips.
🏎️ Race Details: Deep dive into session results, starting grids, and lap data.
👤 Driver Profiles: Detailed stats for every driver on the grid.
🔌 Offline-ish: Fast, lightweight, and powered by the wonderful OpenF1 API.

🚀 Quick Start

Prerequisites

Go 1.21 or higher.

Installation

# Clone the repository
git clone https://github.com/AmanTahiliani/box-box.git
cd box-box

# Build and run
go run cmd/main.go

🎮 Controls

Key	Action
`1`	Switch to Standings
`2`	Switch to Calendar
`3`	Switch to Race Details
`4`	Switch to Drivers
`j`/`↓`	Navigate down
`k`/`↑`	Navigate up
`enter`	Select/Inspect item
`b`	Go back
`q` / `ctrl+c`	Exit

🛠️ Tech Stack

Bubble Tea: The TUI engine.
Lipgloss: For that sleek F1 styling.
Bubbles: Common TUI components.
OpenF1 API: The data source (Free, no API key needed).

🚥 Development

Want to tinker under the hood?

# Run tests
go test ./...

# View API integration tests (requires internet)
go test -v ./internal/api

📜 License

Disclaimer: This project is unofficial and not associated with Formula 1 or the FIA in any way.

2.4 KiB Raw Blame History