https://github.com/yeftakun/ac-lapboard

Assetto Corsa laptime page based on personalbest.ini
https://github.com/yeftakun/ac-lapboard

archive assetto-corsa github-pages third-party

Last synced: 5 months ago
JSON representation

Assetto Corsa laptime page based on personalbest.ini

• Host: GitHub
• URL: https://github.com/yeftakun/ac-lapboard
• Owner: yeftakun
• License: mit
• Created: 2026-01-05T03:26:46.000Z (5 months ago)
• Default Branch: master
• Last Pushed: 2026-01-12T01:07:49.000Z (5 months ago)
• Last Synced: 2026-01-12T16:35:25.864Z (5 months ago)
• Topics: archive, assetto-corsa, github-pages, third-party
• Language: Astro
• Homepage: https://yeftakun.github.io/ac-lapboard/
• Size: 202 KB
• Stars: 1
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Assetto Corsa Lap Board

## What is this?

A lightweight Astro + React template that converts `personalbest.ini` into JSON at build time, so the published page always serves the latest lap data without any runtime fetch.

## Use it as a template

**Requirements:**

- git & github account

- (optional) github cli

- An `personalbest.ini` file from Assetto Corsa. You can find it in `user/Documents/Assetto Corsa/personalbest.ini`, this file will be updated after you record new lap times.

1. **Clone this repo**

```

git clone https://github.com/yeftakun/ac-lapboard

```

2. **Drop your data.** Copy `personalbest.ini` into `data/` and edit `src/data/config.json` based on your preferences.

> Found the file at `C:\User\\Documents\Assetto Corsa\personalbest.ini`

> Gear options: `gamepad`, `wheel-pedal`, `keyboard-mouse`.

3. **Save change.**

```

git add .

git commit -m "update lap"

```

4. **Remove the remote**

```

git remote remove origin

```

5. **Push to your github** If you have github cli installed, run `gh repo create  --public --source=. --remote=origin --push`. Otherwise, create a new repo on github.com and push manually.

6. **Match the workflow branch.** Ensure the branch listed in [`main.yml`](.github/workflows/main.yml) under `on: push: branches:` matches your repo’s default branch (e.g., `master` or `main`).

7. **Enable github pages** Go to your repo settings → Pages → Select **GitHub Actions** as source.

8. **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://.github.io//`.

> 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.

## Get the latest updates

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](https://github.com/yeftakun/ac-lapboard/releases/download/1.0.0/update-from-template.bat ) and place it in the repository root.

## Update your lap data

	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.

	


## Preview on local

**Requirements:**

- Node.js v18+

1. `npm install` to install dependencies.

2. `npm run build` to convert INI and build the site.

3. `npm run dev` to start at `http://localhost:4321/`.

### Quick reference

- `npm run laps:convert` → convert INI without building.

- Update fonts/colors in `src/styles/globals.css` if you want a different vibe.

---

## Video

YouTube video already dropped!

[Assetto Corsa Web Laptime Archive | GitHub Pages Deploy](https://youtu.be/we6h3rqKdto?si=Dr0Gce8JuYq5cX8V)

[Lap Updater for Assetto Corsa Lap Archive | No Yap](https://youtu.be/x_tdR8pqQYU?si=Tb59H6niutRXcftF)

---

## FAQ

	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 your personalbest.ini, so any track or car you drive will show up automatically.

	Q: How do I update my lap times?

	A: Just replace the personalbest.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.