Canon: A Personal Tracker for Creator Content Consumption
A gamified system for tracking your progress through your favorite creators' complete bodies of work.
What Is It?
A personal tracker for consuming your favorite creators' work. Add a creator, ingest their canon, curate what you want, track your progress. Gamified completionism for intentional consumption.
Core loop: Browse creators → see % complete → pick something to read/watch → mark done → watch the number go up.
Core Concepts
Data Model
creators table
works table
Indexes
idx_works_creatoronworks(creator_id)idx_works_statusonworks(status)
Computed Stats (queries, not stored)
- Canon % =
COUNT(status='done') / COUNT(status IN ('queued','done'))per creator - Total works = all works for a creator
- Queued = approved but not yet consumed
- Re-read favorites =
ORDER BY read_count DESC, rating DESC - Latest unread = next queued work by discovered_at
Ingestion Strategy (priority order)
When you paste a creator's URL, try these in order:
- RSS feed — auto-discover via
<link rel="alternate">in HTML head. Richest data: title, URL, description, date. - Sitemap — fetch
/sitemap.xml. Gives all URLs, sometimes with lastmod dates. No titles (derive from URL path). - llms.txt — fetch
/llms.txt. Newer convention, curated page list. Growing adoption. - Scrape links — fetch the page, extract all internal
<a>hrefs, dedupe, filter obvious non-content (assets, auth, etc.).
All ingested works start as candidate. Approval UI lets you bulk-select which ones to queue.
Pages & Views
/canon — Main page
The hero view. Grid of creator cards.
Each card shows:
- Creator image/avatar
- Name + description
- Progress ring (circular % indicator)
- Stats line: "34/51 read · 3 favorites · 14 queued"
- "Next up" — title of the next queued work, clickable
- "Random" button — pick a random queued work
- "Top picks" — 2-3 most re-read or highest-rated works
Sorted by: most recently active, or lowest % (motivational), user choice.
/canon/[creatorId] — Creator detail
Full catalog view for one creator:
- Creator header (image, name, description, big progress ring, stats)
- Filter bar: status (queued/done/candidate/all), difficulty, topic tags
- Works list: cards or compact rows, each with title, status badge, difficulty, rating stars, read count
- Bulk actions: "Queue all candidates", "Mark selected as done"
/canon/discover — Add a creator
- Paste a URL
- App tries RSS → sitemap → llms.txt → scrape
- Shows results: "Found 47 articles from kentcdodds.com"
- Creator name/description fields (pre-filled if possible)
- Approval grid: checkboxes on each discovered work
- "Queue selected" / "Queue all" buttons
Route Structure
src/app/canon/
page.tsx # Main grid of creator cards
canon.module.css # Styles for main page
[creatorId]/
page.tsx # Creator detail / catalog view
discover/
page.tsx # Add new creator + ingestServer Actions
addCreator(name, url, description, imageUrl, type)— insert into creatorsingestWorks(creatorId, works[])— bulk insert discovered works as candidatesupdateWorkStatus(workId, status)— queue, done, dropmarkRead(workId)— increment read_count, set last_read_at, set status=done if first readrateWork(workId, rating)— set ratingbulkQueueWorks(workIds[])— move candidates to queued
Build Order
- Tables — create
creators+worksin Turso - Data layer —
src/lib/reading.tswith types + query functions - Server actions —
src/actions/reading.ts - Discover page — paste URL, ingest, approve works
- Main page — creator cards with progress rings
- Creator detail page — full catalog, filters, mark done
- Sidebar link — add to nav
- Polish — random button, re-read tracking, stats
Future Ideas (not building now)
- YouTube/podcast support (different embed/player)
- Spotify Wrapped-style "year in review" stats
- Public profile: "biggest fan" leaderboard per creator
- Import from Pocket/Instapaper/browser bookmarks
- Browser extension: "Add to Canon%" from any page
- AI summaries of articles you've read
- Spaced repetition: resurface articles you rated highly after N days
Related
- Intelligent Component Designer API
Design document for an AI-powered component composition system using LLM intelligence with deterministic, type-safe output
- Feature Spec: Project Launchpad System
Frictionless system for showcasing development projects - make adding new projects feel as easy as publishing a blog post
- Epic Dev Routes - Your App as Your Tooling Layer
Stop building separate tools - use Next.js /dev/* routes to turn your entire app into a personal productivity layer with hot reload, TypeScript safety, and zero deployment overhead
- backlog-this Command
A focused workflow for capturing ideas into backlog storage when I intentionally want to stop implementing and preserve context for later.