MiniF1 is an ultra-simplified Formula 1 simulation engine.
Build your own F1 seasons, customize teams & drivers, and watch realistic qualifying and race simulations unfold in your browser – with full championship tracking, race replays, and point systems.
- Interactive Grand Prix setup (choose circuit, teams, drivers, and customize stats)
- Qualifying simulation with Q1, Q2, Q3 phases
- Race simulation with DRS, gaps, rain, and track evolution
- Full race data recording for instant replay
- Option to enable sprint race mode
- Configure multi-circuit championship seasons
- Point system tracking across all races
- Driver & team standings updated after each race
- Save and load championship progress
- Access qualifying and race data for every round
- Instant replay of any recorded race
- Revisit championship rounds with full metadata
- Rewatch qualifying sessions or races on demand
- Personalize team names and colors
- Adjust driver skill stats before races
- Modify circuit difficulty and weather conditions
- Entire simulation runs in your browser (no backend required)
- All data stored in
localStoragefor seamless offline play - Championships save automatically
You can:
- Run it directly from GitHub Pages
- Or clone the repository and open
index.htmllocally in your browser
From the home menu (index.html), select your mode:
- Select a circuit
- Customize teams (names, colors) and driver stats
- Launch the event
- Watch qualifying → then the race unfolds automatically
- Add multiple circuits to your season
- Start the championship
- Run each Grand Prix in sequence
- View live standings and championship progression
- Save your progress and continue later
- Select a previously recorded race
- Watch the full event unfold again
quali.html or race.html can run independently only if data has been initialized in localStorage.
- HTML / CSS / JavaScript (Vanilla, no framework)
localStoragefor all runtime data- Python scripts (in
script/) to generate JSON assets (circuits, drivers, etc.) from Excel files
👉 These are optional and not needed to run the simulation
This is a personal side project created for fun, learning, and family!
The idea is to have a simple F1 simulator accessible anywhere (via GitHub Pages), especially to let younger players (like my nephews) enjoy racing.
It's not meant to be professional but it is open to curious and kind people.
- Sprint race weekend configuration & simulation
- Combined qualifying + sprint + main race weekend format
- Multi-season career progression
- Evolving driver and team rosters
- Career statistics and historical records
- Advanced season customization
- Take control of one pilot
- Interactive mini-games to influence performance
- Player choices affecting race outcomes
- Competitive career progression system
To be defined – for now: personal and educational use encouraged.