No description
  • Rust 48.3%
  • Vue 38.4%
  • TypeScript 9.4%
  • Python 1.7%
  • Shell 0.6%
  • Other 1.5%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Antoine Letouzey 220b6bd3c5
Some checks failed
Rust / build (push) Has been cancelled
Add project map and agent rules for durable context.
Document features and design decisions in one source of truth, and keep agents from coauthoring commits.
2026-07-29 21:56:41 +02:00
.cursor/rules Add project map and agent rules for durable context. 2026-07-29 21:56:41 +02:00
.github/workflows Setup SQLX offline mode for CI pipeline build 2025-11-17 21:26:04 +01:00
assets add car improvment for cash 2026-01-08 21:02:41 +01:00
bruno/tinyracingapi bruno API tool, Pause/resume button on the race UI, python preprocessing tool cleanup 2025-11-06 19:47:46 +01:00
docs Add project map and agent rules for durable context. 2026-07-29 21:56:41 +02:00
imgs Vue.js based web client 2025-05-17 23:43:06 +02:00
nginx Docker runtime setup, with makefile to run everything 2025-12-09 23:04:46 +01:00
server adding a watchdog service to auto-start races 2026-01-12 23:26:41 +01:00
tiny-racing-vue do not include e2e tests in the docker build 2026-01-16 00:09:11 +01:00
track_preprocessor bruno API tool, Pause/resume button on the race UI, python preprocessing tool cleanup 2025-11-06 19:47:46 +01:00
.dockerignore do not include e2e tests in the docker build 2026-01-16 00:09:11 +01:00
.env.sample Docker runtime setup, with makefile to run everything 2025-12-09 23:04:46 +01:00
.gitignore flags and avatar for drivers 2025-12-07 20:01:42 +01:00
AGENTS.md Add project map and agent rules for durable context. 2026-07-29 21:56:41 +02:00
api_documentation.md code refactoring and early API implementation 2025-05-18 20:16:22 +02:00
docker-compose.test.yml adding e2e testing, most of them pass :D 2026-01-12 22:02:30 +01:00
docker-compose.yml automatic restart a race once it's done, for demo purposes only 2025-12-10 01:28:58 +01:00
DOCKER.md Docker runtime setup, with makefile to run everything 2025-12-09 23:04:46 +01:00
LICENSE Add LICENSE 2025-05-17 10:54:33 +02:00
Makefile Manually start a custom race 2025-12-10 20:37:16 +01:00
nginx-proxy-example.conf Docker runtime setup, with makefile to run everything 2025-12-09 23:04:46 +01:00
Readme.md simple UI change for the race result table, added awards and removed car number 2025-12-30 19:47:56 +01:00

Tiny Racing

A text-based Formula 1 race simulation game written in Rust.

Features

  • Real-time race simulation with multiple drivers
  • Driver attributes including skill level, stamina, weather tolerance, etc.
  • Car and team management
  • Tire wear and fuel consumption simulation
  • Pit stop strategy
  • Text-based UI using ncurses
  • WebSocket support for external clients

Getting Started

Prerequisites

  • Rust toolchain

Installation

  1. Clone the repository
  2. Build the simulation app. cd server && cargo build --release
  3. Install the web client dependencies. cd tiny-racing-vue && npm install

Running

  1. Run the simulation locally. cd server && cargo run -- track.json
  2. (optional) Run the simple http server for json and svg assets. python tiny-racing-vue/server.py
  3. (optional) Run the Vue.js web client. cd tiny-racing-vue && npm run dev

Screenshots

Ncurses

NCurses UI

Web client

Web UI

Credits