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]>
24 lines
1.4 KiB
Markdown
24 lines
1.4 KiB
Markdown
# 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
|
|
1. The owner, self-hosting for themselves: currently juggling several trackers, spreadsheets and Obsidian notes.
|
|
2. A few friends on the same instance.
|
|
3. 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.
|