# Project pack: LubeLogger @ 63fa5cd

Facts about **LubeLogger** for an AI following the [BespokeAI handover guide](https://handoff.bespokeai.software/guide/v4.md). Pinned to one version; never changes after publication.

> LubeLogger is a self-hosted vehicle maintenance and fuel mileage tracker. You record services, repairs, upgrades, fuel, taxes and odometer readings for each vehicle, set reminders for upcoming work, and see costs and fuel economy over time. It is simple to run and keeps your records in your hands.

## Setup path (checked 2026-11-03)
- **Start here, no Docker:** Download the prebuilt program for your system and run it. No Docker.
- Offer Docker only if the person asks or this path fails. The commands further down may use Docker; they are not the starting point.
- Verdict source: https://raw.githubusercontent.com/hargata/lubelog/HEAD/README.md
- You may be unable to download source archives or run commands in this session. The person downloads and runs things; if you cannot fetch something, give any changed file in full in chat with its path.

## Version and source
- Repository: https://github.com/hargata/lubelog
- Pinned commit: `63fa5cd267497ba01c29f4888c65efbbdd4b94bf`. Use exactly this version.
- Zip the person can download in a browser: https://github.com/hargata/lubelog/archive/63fa5cd267497ba01c29f4888c65efbbdd4b94bf.zip
- Fresh checkout (only if you have a shell and git): use the commands below in an empty folder. If this exact source is already checked out, keep your branch and use the development command; do not clone again or reset local changes.
- Official docs: https://docs.lubelogger.com
- Live demo: https://github.com/hargata/lubelog?tab=readme-ov-file#demo. See the project README for the demo link and sign-in.
- Licence: **MIT**. Free to use, change and share, even commercially. Keep the original copyright notice.

## Commands from the pinned source
- Developer commands (they may use Docker):

  ```sh
  git clone https://github.com/hargata/lubelog bespoke-lubelogger
  cd bespoke-lubelogger
  git checkout --detach 63fa5cd267497ba01c29f4888c65efbbdd4b94bf
  # Prepare development requirements and local configuration first.
  dotnet restore
  dotnet run
  ```

- Separate trial of the current upstream release (not your changes; sample data and a separate data directory only):

  ```sh
  docker run -d --name lubelogger -p 8080:8080 -v lubelogger-data:/App/data -v lubelogger-keys:/root/.aspnet/DataProtection-Keys ghcr.io/hargata/lubelogger:latest
  # then open http://localhost:8080
  ```
- Tools these commands use: Docker for a trial, .NET 8 SDK for development
- Develop: `dotnet run`
- Build: `dotnet build`
- Stack: csharp, javascript (ASP.NET Core MVC, Razor, Bootstrap). Difficulty for a non-developer with an AI: **easy**. A compact ASP.NET MVC app with straightforward controllers and views. Records, reminders and reports are good places to extend.
Personal data: **yes**. Stored in: A local database file and attachments under /App/data. Secrets are entered by the person, never in chat.

---
Later, only when a step needs it: [reference.md](https://handoff.bespokeai.software/p/lubelogger/63fa5cd/r3/reference.md) (customisation points, must-keep-working, data and costs, coding conventions) · [hosting.md](https://handoff.bespokeai.software/p/lubelogger/63fa5cd/r3/hosting.md) (long-term hosting; hosts are paid third parties) · [bespoke.yaml](https://handoff.bespokeai.software/p/lubelogger/63fa5cd/r3/bespoke.yaml) · [SKILL.md](https://handoff.bespokeai.software/p/lubelogger/63fa5cd/r3/SKILL.md)