Lucas WintherandClaude Opus 5.5
560c27c04d
Adds the approved v1 design spec, UI mockups, AGENTS.md (with CLAUDE.md and GEMINI.md pointers), architecture/decisions/todo/permissions docs, agent permission files, and an empty Bun workspaces skeleton. Co-Authored-By: Claude Opus 5.5 <[email protected]>
1.4 KiB
1.4 KiB
Product
STTracker is a self-hosted meta tracker for everything a person reads, watches, plays and listens to.
It is the user's own permanent record. Platforms (Hardcover, Trakt, MangaBaka, ListenBrainz, Last.fm…) are sources it watches, not the source of truth.
Full spec: docs/specs/001-sttracker-v1-design.md.
Who it's for
- The owner, self-hosting for themselves: currently juggling several trackers, spreadsheets and Obsidian notes.
- A few friends on the same instance.
- Maybe, later, a small public instance.
What it must feel like
- The user is in control. They never conform to the data. A title alone is a valid entry. No sync silently overwrites what they wrote.
- One interface for all media. Books, games, shows and music use the same features; a media type is just a label.
- About stories and things you love, not an admin stats dashboard.
Two surfaces
- The app: everyday library, logging, sources, and a Changes inbox. Calm, dense, Hardcover-like.
- The public page: a shareable, personal page with a scrapbook layout and a river timeline view. Phase 2.
Voice
Plain, warm, direct. Sentence case. Name things by what users understand: "Changes", "Sources", "Owned", "Quick add", "Draft". Never "records", "connectors" or "webhooks" in user-facing copy. Errors say what happened and how to fix it, without apologising.