How luciferakj/f1 works
F1 Race Replay lets a user choose a season, event, and session, then inspect a synchronized race replay and its telemetry and derived race intelligence. The frontend combines REST metadata/frame requests with WebSocket playback; the FastAPI backend loads FastF1 sessions and produces cached, interpolated replay frames. The graph retains documented analytics, timing, bookmarks, and interaction features. Some frontend wiring and several backend modules are unsampled, so edges for those are limited to README statements or omitted.
Main entry points: MainDashboard.tsx Replay dashboard · replay.py Replay endpoints · pipeline.py Replay data pipeline · sessions.py Session endpoints
Components 32
Replay frontend
- Season selector
frontend/app/page.tsx - Replay route
frontend/app/replay/[year]/[event]/[session]/page.tsx - Replay dashboard
frontend/components/layout/MainDashboard.tsx - API client
frontend/lib/apiClient.ts - Playback controls
frontend/hooks/useReplayWebSocket.ts - Replay state
frontend/store/replayStore.ts - Timing tower
frontend/components/leaderboard/LeaderboardPanel.tsx - Telemetry dashboard
frontend/components/telemetry
Backend API
- FastAPI application
backend/main.py - Session endpoints
backend/api/sessions.py - Replay endpoints
backend/api/replay.py - Playback WebSocket
backend/api/ws_replay.py - API response models
backend/models/schemas.py
Session and telemetry data
- FastF1 session service
backend/services/fastf1_service.py - Session overview
backend/services/session_overview_service.py - Replay data pipeline
backend/telemetry/pipeline.py - Raw telemetry loader
backend/telemetry/loader.py - Frame processor
backend/telemetry/processor.py - Frame queries
backend/telemetry/query.py - Processed replay cache
backend/telemetry/cache.py - Replay data models
backend/telemetry/models.py
Track rendering
- Replay canvas
frontend/components/track/ReplayCanvas.tsx - Pixi replay engine
frontend/lib/pixi/PixiReplayEngine.ts - Track layer
frontend/lib/pixi/TrackLayer.ts - Car sprites
frontend/lib/pixi/CarSprite.ts - Camera controller
frontend/lib/pixi/CameraController.ts
Analytics and intelligence
- Telemetry analytics
frontend/components/analytics - Race intelligence
frontend/components/timeline - Race insights
frontend/components/insights - Replay bookmarks
frontend/hooks/useBookmarks.ts
Other components
- Race viewer
- FastF1 data source
Connections 43
- Race viewer → Season selector: chooses session
- Season selector → Session endpoints: requests events
- Race viewer → Replay route: opens replay
- Replay route → Replay dashboard: shows replay
- Replay dashboard → API client: requests replay data
- API client → Session endpoints: fetches schedule
- API client → Replay endpoints: fetches REST data
- Playback controls → Playback WebSocket: streams playback
- Replay dashboard → Playback controls: controls playback
- Replay dashboard → Replay state: uses replay state
- Replay dashboard → Timing tower: shows timing
- Replay dashboard → Telemetry dashboard: shows telemetry
- Replay dashboard → Telemetry analytics: shows analytics
- Replay dashboard → Race intelligence: shows intelligence
- Replay dashboard → Race insights: shows insights
- Replay dashboard → Replay bookmarks: offers bookmarks
- Replay dashboard → Replay canvas: renders replay
- Replay canvas → Pixi replay engine: mounts engine
- Pixi replay engine → Track layer: creates layer
frontend/lib/pixi/PixiReplayEngine.ts - Pixi replay engine → Car sprites: creates sprites
frontend/lib/pixi/PixiReplayEngine.ts - Pixi replay engine → Camera controller: creates controller
frontend/lib/pixi/PixiReplayEngine.ts - FastAPI application → Session endpoints: registers router
backend/main.py - FastAPI application → Replay endpoints: registers router
backend/main.py - FastAPI application → Playback WebSocket: registers router
backend/main.py - Session endpoints → FastF1 session service: loads schedule/session
backend/api/sessions.py - Session endpoints → Session overview: builds overview
backend/api/sessions.py - Session overview → API response models: creates response models
backend/services/session_overview_service.py - Replay endpoints → FastF1 session service: loads session
backend/api/replay.py - Replay endpoints → Session overview: builds overview
backend/api/replay.py - Replay endpoints → Replay data pipeline: gets replay data
backend/api/replay.py - Replay endpoints → Frame queries: filters and looks up frames
backend/api/replay.py - Replay endpoints → Frame processor: reads frame interval
backend/api/replay.py - Replay endpoints → API response models: returns API models
backend/api/replay.py - Playback WebSocket → Replay data pipeline: gets replay data
backend/api/ws_replay.py - Playback WebSocket → Frame queries: queries frames
backend/api/ws_replay.py - Replay data pipeline → Processed replay cache: reads and writes
backend/telemetry/pipeline.py - Replay data pipeline → FastF1 session service: loads session
backend/telemetry/pipeline.py - Replay data pipeline → Raw telemetry loader: extracts telemetry
backend/telemetry/pipeline.py - Replay data pipeline → Frame processor: builds frames
backend/telemetry/pipeline.py - Replay data pipeline → Replay data models: returns replay data
backend/telemetry/pipeline.py - Frame processor → Replay data models: creates frames
backend/telemetry/processor.py - Frame queries → Replay data models: filters frames
backend/telemetry/query.py - FastF1 session service → FastF1 data source: loads session data
backend/services/fastf1_service.py