Time Tracker

A small personal progress tracker.

Features

• Tracks percent complete, days left, weeks left, and days done
• Custom event name, dates, and accent color
• Simple todo list for goals to finish before the event ends

Run Locally

Install dependencies:

npm install

Start the local dev server:

npm run dev

Open:

http://localhost:5173/

Build

Create a production build:

npm run build

Preview the production build:

npm run preview

Open:

http://localhost:4173/

Docker

Build and run:

mkdir -p data
docker build -t time-tracker .
docker run --rm -p 4173:4173 -v ./data:/app/data -e PREVIEW_ALLOWED_HOSTS=your.domain.example -e TIME_TRACKER_PASSWORD=change-me time-tracker

Or use the compose example:

PREVIEW_ALLOWED_HOSTS=your.domain.example docker compose -f docker-compose.example.yml up --build

Server state is stored in data/state.json and persisted with the local ./data bind mount.

Set PREVIEW_ALLOWED_HOSTS to the hostname you use to access the app. For multiple hostnames, use a comma-separated list.

Set TIME_TRACKER_PASSWORD to require a password before editing settings or todos. Leave it unset or empty to keep the app read/write by default.

API

The app includes a small read-only JSON API.

See API.md.