tally-counter
A self-hosted tally counter web app. Create counters, organise them into groups, track history, and view stats.
Features
- Create, edit, and delete counters with optional photos
- Organise counters into groups with drag-and-drop reordering
- Per-counter history modal — streak stats, 90-day chart, activity calendar
- Global stats page with top counters and 12-month calendar
- Counters can't go below 0
- Hover-to-prefetch on history modal for instant opens
- Fully persistent via SQLite (better-sqlite3, WAL mode)
Tech stack
- Next.js 16 — App Router, TypeScript, standalone output
- Tailwind CSS v4 — Catppuccin Mocha theme
- better-sqlite3 — embedded SQLite, no external database needed
- @dnd-kit — drag-and-drop for counters and groups
Running locally
npm install
npm run dev
Open http://localhost:3000.
Data is stored in .data/ (SQLite DB + uploaded images).
Docker
docker build -t tally-counter .
docker run -p 3000:3000 -v tally_data:/data tally-counter
The /data volume holds both the database and uploaded images. Mount it to persist data across container restarts.
Environment variables
| Variable | Default | Description |
|---|---|---|
DATA_DIR |
.data (dev) / /data (Docker) |
Directory for SQLite DB and uploads |
PORT |
3000 |
HTTP port |