gaetan/Argus
1
0
Fork 0
Code Issues 7 Pull requests Projects Releases Packages Wiki Activity Actions

Bookshelf — web app to manage books to read (like a watchlist for books) #1

New issue
Open
opened 2026-08-23 11:10:14 +02:00 by gaetan · 0 comments
gaetan commented 2026-08-23 11:10:14 +02:00
Owner
Copy link

Destination

A self-hosted, single-user web app for managing a personal book watchlist. Built in Go, served via Docker. Users can add books (via Google Books API search or manual entry), track status (want to read / reading / read), log reading progress, and rate/review books they've finished. Clean UI with PicoCSS, JSON API alongside HTML templates, session-based auth.

Notes

  • Domain model: see CONTEXT.md at repo root
  • Tech stack: Go + chi + templ + PicoCSS + SQLite + Docker
  • Google Books API for book metadata lookup
  • Session-based authentication (one password, session cookie)
  • JSON API alongside HTML templates for future-proofing
  • Progress tracking: current page / total pages
  • ISBN-based deduplication
  • Status transitions: Reading→Read prompts for rating/review; Want to read→Reading auto-sets total pages; Any→Want to read resets progress
  • Tags are user-created labels; genres come from metadata source
  • Search: case-insensitive, partial match on title/author
  • Filter by status; sort by date added, date started, date finished, rating
  • Single Docker container serving API + templates

Decisions so far

Not yet specified

  • Frontend build pipeline (templ generation + CSS bundling)
  • Data export/import format (JSON? CSV?)
  • Error pages and 404 handling
  • Pagination strategy for large libraries
  • Reading streak / gamification (if any)

Out of scope

  • Multi-user support
  • Social features (sharing, reviews visible to others)
  • Custom shelves beyond the three status buckets
  • Mobile app (native or PWA)
## Destination A self-hosted, single-user web app for managing a personal book watchlist. Built in Go, served via Docker. Users can add books (via Google Books API search or manual entry), track status (want to read / reading / read), log reading progress, and rate/review books they've finished. Clean UI with PicoCSS, JSON API alongside HTML templates, session-based auth. ## Notes - Domain model: see CONTEXT.md at repo root - Tech stack: Go + chi + templ + PicoCSS + SQLite + Docker - Google Books API for book metadata lookup - Session-based authentication (one password, session cookie) - JSON API alongside HTML templates for future-proofing - Progress tracking: current page / total pages - ISBN-based deduplication - Status transitions: Reading→Read prompts for rating/review; Want to read→Reading auto-sets total pages; Any→Want to read resets progress - Tags are user-created labels; genres come from metadata source - Search: case-insensitive, partial match on title/author - Filter by status; sort by date added, date started, date finished, rating - Single Docker container serving API + templates ## Decisions so far <!-- none yet — map just created --> ## Not yet specified - Frontend build pipeline (templ generation + CSS bundling) - Data export/import format (JSON? CSV?) - Error pages and 404 handling - Pagination strategy for large libraries - Reading streak / gamification (if any) ## Out of scope - Multi-user support - Social features (sharing, reviews visible to others) - Custom shelves beyond the three status buckets - Mobile app (native or PWA)
Sign in to join this conversation.
No Branch/Tag specified
Branches Tags
main
No results found.
Labels
Clear labels   
needs-info

   
needs-triage

   
ready-for-agent

   
ready-for-human

   
wayfinder:grilling

   
wayfinder:map

   
wayfinder:prototype

   
wayfinder:research

   
wayfinder:task

   
wontfix
No labels
needs-info
needs-triage
ready-for-agent
ready-for-human
wayfinder:grilling
wayfinder:map
wayfinder:prototype
wayfinder:research
wayfinder:task
wontfix
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
gaetan/Argus#1
No description provided.