A public lap archive site for Assetto Corsa that reads straight from personalbest.ini. Just drive and break records, then use the included LapUpdater tool to push the changes. GitHub Actions will automatically process the data and update your site instantly
Requirements:
- git & github account
- (optional) github cli
- An
personalbest.inifile from Assetto Corsa. You can find it inuser/Documents/Assetto Corsa/personalbest.ini, this file will be updated after you record new lap times.
- Clone this repo
git clone https://github.com/yeftakun/ac-lapboard
- Drop your data. Copy
personalbest.iniintodata/and editsrc/data/config.jsonbased on your preferences.
Found the file at
C:\User\<you>\Documents\Assetto Corsa\personalbest.ini
Gear options:
gamepad,wheel-pedal,keyboard-mouse.
- Save change.
git add .
git commit -m "update lap"
- Remove the remote
git remote remove origin
- Push to your github If you have github cli installed, run
gh repo create <your-repo-name> --public --source=. --remote=origin --push. Otherwise, create a new repo on github.com and push manually. - Match the workflow branch. Ensure the branch listed in
main.ymlunderon: push: branches:matches your repo’s default branch (e.g.,masterormain). - Enable github pages Go to your repo settings → Pages → Select GitHub Actions as source.
- Wait for the first deployment. After pushing, go to the Actions tab and wait for the workflow to finish. Your site should be live at
https://<your-github-username>.github.io/<your-repo-name>/.
Note: Once you switch the Pages source to GitHub Actions, the site usually goes live but the dashboard may still show an error. You can ignore it—after the next workflow run (another push/commit or a manual run) the error status will clear.
To pull in the latest updates from this template repo run update-from-template.bat. This script fetches and merges changes from the original repo.
This updater script was added after the initial release. If you cloned the template before it existed, download the script and place it in the repository root.
Update manualy
- Replace `data/personalbest.ini` with your latest lap data.
- Commit and push the changes.
- GitHub Actions will automatically rebuild and deploy your site.
Lap Updater (New)
- Requires: .NET 8
- Download app
- Run and follow the instruction on the app.
Requirements:
- Node.js v18+
npm installto install dependencies.npm run buildto convert INI and build the site.npm run devto start athttp://localhost:4321/.
npm run laps:convert→ convert INI without building.- Update fonts/colors in
src/styles/globals.cssif you want a different vibe.
YouTube video already dropped!
Assetto Corsa Web Laptime Archive | GitHub Pages Deploy
Lap Updater for Assetto Corsa Lap Archive | No Yap
Q: Is this free?
A: Yep! The template is 100% free and open-source.Q: Do I need to know how to code?
A: Nope. You just need to follow the steps in the tutorial. No coding skills required.Q: Do I need to pay for hosting or tools?
A: Not at all. Everything used here is free, and GitHub Pages hosts your site for $0. Just make sure your repo is not private.Q: Why use this over other apps?
A:- Full Control: You own your data.
- Lightweight: No background apps running while you race.
- Customizable: Since you have the code, you can tweak the look however you like.
Q: Does it work with Mod tracks/cars?
A: Yes! It reads directly from yourpersonalbest.ini, so any track or car you drive will show up automatically.
Q: How do I update my lap times?
A: Just replace thepersonalbest.ini file in your repository and commit the changes. The site updates itself automatically.
Q: Is the data validated / any anti-cheat?
A: Nope. Since it reads from a simple text file, the numbers can be easily manipulated. But I trust you guys to keep it real... right? ...Right?That’s it — swap the data, tweak config, and you’ve got a self-hosted Assetto Corsa lap archive.