Production ReadyPersonalv1.0.0
BK

Book Tracker

Three shelves, honest progress bars, one yearly goal.

Try it right here

01Reading now

Progress bars that keep you honest.

02The shelves

To read, reading, finished.

03The goal

Books this year against your target.

Overview

Book Tracker is a private reading log without the social network attached. Books move across three shelves — to read, reading, finished — with page-level progress bars while you read, five-star ratings when you finish, and a yearly goal with a completion bar computed from actual finish dates. Pages read, average rating, and this-year counts all derive from the log. A clean base for adding series tracking, quotes, or an import from your reading history.

Next.jsReactTypeScriptLocal-first

Features

  • Three shelves: to read, reading, finished
  • Page-level progress bars
  • Five-star ratings on finish
  • Yearly reading goal with honest completion math
  • Pages-read and average-rating stats from the log

Make it yours in three steps

1

Download it

One click, one zip, the whole project. Free, MIT licensed, yours to keep.

Download Book Tracker
2

Run it

Unzip it, then run this in the folder. It works immediately — no database, no accounts, no configuration.

$ npm install
$ npm run dev
3

Hand it to your coding agent

The download ships with CLAUDE.md, AGENTS.md, and Cursor rules, so your agent understands the project the moment it opens the folder.

$ cd book-tracker
$ claude

Claude Code reads the included CLAUDE.md automatically — it already knows the project.

A good first prompt:

Give me a quick tour of this project, then help me make it mine.

Agent-ready information

Ships with CLAUDE.md, AGENTS.md, Cursor rules, and a full agent handbook — project map, safety rules, recipes, tests, and deploy notes.

Claude CodeCursorCodex
/agent/START_HERE.md/agent/PROJECT_MAP.md/agent/RULES.md/agent/RECIPES.md/agent/TESTS.md/agent/DEPLOY.md/agent/agent.json

Changelog

v1.0.0Jul 4, 2026
  • Initial release — live demo and downloadable, runnable foundation.

Related foundations

Explore nearby starting points before you commit to a fork.

Browse all