A self-hosted web app for managing your own book collection. It stores each book's photo, title, author, and your notes/rating. Clone it from GitHub, install, and run — your database stays on your own machine. You can also reach it from your phone on the same network to add or edit books.
Every install is single-user: whoever runs the project sees only their own database. The architecture is designed so that multi-user and sharing can be added later without a rewrite (see ROADMAP).
git clone <repo-url> biblio
cd biblio
cp .env.example .env # edit settings
npm install
npm run db:setup # schema + migration + seed
npm run dev # http://localhost:3000npm run dev -- -H 0.0.0.0 # listen on all network interfacesIn your phone's browser, go to http://<machine-local-ip>:3000. For access from outside your network, see SETUP.md → Tailscale / Cloudflare Tunnel section.
| File | Contents |
|---|---|
| ARCHITECTURE.md | Layers, adapter pattern, extension points |
| DATABASE.md | Schema, tenancy model, migration strategy |
| ROADMAP.md | Phases: CRUD → sharing → AI recommendations |
| SETUP.md | Installation, phone/remote access, deployment |
Next.js (full-stack) · Prisma · SQLite (→ Postgres) · TypeScript · Tailwind CSS
MIT (suggested — change to suit your needs).