A personal TV and anime scheduling app. Build a lineup of shows, generate a viewing schedule, and track what you actually watched.
Built for people who want to watch TV intentionally, instead of scrolling and tapping whatever is on top.
- Lineup builder. Add TV shows, anime, and movies to a lineup in any order, with per-show scheduling flags.
- Schedule generator. Auto-fill a time block (say 8PM to midnight) with episodes from your lineup, using round-robin or random rotation. It fills empty gaps only and never double-books.
- Library tracking. Mark shows watching, plan to watch, completed, or dropped. Track episode-level progress, per season or all at once.
- Lists. Build ranked or unranked collections, reorder by drag, and export one as a shareable image or plain text.
- Reviews. Write long-form reviews in a rich text editor.
- Stats. Weekly and all-time activity, completion counts, and genre breakdowns.
- Networks and providers. Browse and filter content by network or streaming service.
- Anime support. TMDB for Western content, Jikan (MyAnimeList) for anime, unified behind a single content record so a title is the same entity whichever source it came from.
┌────────────────────────────────────────────────────┐
│ frontend/ React 19 + Vite + Wouter │
│ │
│ Pages : Home Lineup Library Search │
│ Browse Reviews Stats Settings │
│ Auth : Clerk SDK │
│ State : TanStack Query │
│ UI : Mantine + Tailwind CSS │
└───────────────────────┬────────────────────────────┘
│
│ REST /api/*
│ Authorization: Bearer <token>
│
▼
┌────────────────────────────────────────────────────┐
│ backend/ Fastify + Kysely + PostgreSQL │
│ │
│ Routes : queue schedule library content │
│ lists reviews people networks │
│ billing user auth webhooks │
│ Auth : Clerk JWT verification │
│ Billing : Stripe subscription entitlements │
│ Cache : Redis (TMDB and Jikan responses) │
└────┬──────────────┬──────────────┬──────────┬──────┘
│ │ │ │
▼ ▼ ▼ ▼
PostgreSQL TMDB Jikan Stripe
(Kysely) (Western TV (Anime) (Billing)
& movies)
─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─
smallweb/ Astro standalone marketing site
docsite/ Docusaurus documentation site
- Node.js 22.x (both packages pin
engines.node) - pnpm (
npm install -g pnpm) - PostgreSQL 15+ (local or Supabase)
- Clerk account (authentication)
- TMDB API key (content search)
Redis is optional in development. Without it, TMDB and Jikan responses simply are not cached.
git clone <repo-url>
cd showshowshowcd backend
pnpm install
cp .env.example .env
# Edit .env with your values (see backend/README.md for details)
pnpm run migrate:up
pnpm run devBackend runs on http://localhost:3000.
cd frontend
pnpm install
cp .env.example .env
# Set VITE_API_URL=http://localhost:3000
# Set VITE_CLERK_PUBLISHABLE_KEY from your Clerk dashboard
pnpm run devFrontend runs on http://localhost:5173, or $FRONTEND_PORT if set.
Backend (backend/.env):
| Variable | Description |
|---|---|
DATABASE_URL |
PostgreSQL connection string |
CLERK_PUBLISHABLE_KEY |
From Clerk dashboard |
CLERK_SECRET_KEY |
From Clerk dashboard |
CLERK_WEBHOOK_SECRET |
Configure webhook in Clerk, pointing at POST /api/webhooks/clerk |
TMDB_API_KEY |
From themoviedb.org |
Frontend (frontend/.env):
| Variable | Description |
|---|---|
VITE_API_URL |
Backend URL (default http://localhost:3000) |
VITE_CLERK_PUBLISHABLE_KEY |
Clerk publishable key (pk_...), the same value as CLERK_PUBLISHABLE_KEY in the backend |
Optional: Stripe keys for billing, PostHog for analytics, REDIS_URL for caching. See backend/README.md for the full list.
showshowshow/
├── backend/ # Fastify REST API
├── frontend/ # React SPA
├── smallweb/ # Astro marketing site (showshowshow.app)
├── docsite/ # Docusaurus documentation site
└── readme_pics/ # Screenshots used by this file
See each subdirectory's README for component-specific details:
See CONTRIBUTING.md.
Elastic License 2.0, see LICENSE. Source available; commercial hosting of this software as a service is not permitted.