PITWALL
A Formula 1 companion built around a server-owned live data gateway, an honest replay fallback and one real-geometry circuit pipeline.
- Role
- Full-stack Developer
- Year
- 2026
- Status
- Completed
- Field
- Full-stack / real-time systems

System brief.
PITWALL combines a React and Capacitor client with a Node.js gateway that keeps upstream credentials and connections on the server. It presents live timing when available and clearly labelled historical replay when a live session is not active.
- Server-owned OAuth and live data connection
- Bounded WebSocket delivery to the client
- Canonical real circuit geometry pipeline
- Historical replay with explicit status labelling
Stack.
- 01React
- 02Vite
- 03Capacitor
- 04Node.js
- 05OpenF1
A narrow client boundary
The frontend receives only configured backend HTTP and WebSocket endpoints. OpenF1 credentials, access tokens and upstream live URLs remain inside the Node.js gateway.
The gateway normalizes and deduplicates incoming records before broadcasting a bounded live snapshot to the React and Capacitor client.
One source of track truth
Circuit cards, maps, outlines and live or replay markers are derived from one canonical GeoJSON pipeline. Coordinates are converted into local metres and projected without changing the source aspect ratio.
Replay without pretending to be live
When credentials are unavailable or a live session is inactive, the gateway can load a bounded historical session. The interface labels that state as replay and retains an unavailable state when no real data can be loaded.
PITWALL is unofficial and is not associated with Formula 1.