# Kateify **Live:** **What Kate's been listening to**: a personal Spotify dashboard showing favourite albums, tracks and artists, where those artists come from, how her taste in genres shifts, and when she saves new music. Live from the Spotify Web API, with genre and origin data from MusicBrainz. > **Built with Claude Code.** Researched, designed, built, tested and documented by > [Claude Code](https://claude.com/claude-code), Anthropic's agentic coding CLI, working > from Kate's brief and feedback. It's a showcase of what that tool can do end to end, not > hand-written work. ## What's on the page - **Now playing**, or the last song played - **Your favourites** for the last 4 weeks, 6 months or 12 months: top album, top tracks, top artists, plus a world map of where those artists are from - **Over time**: a genre radar comparing all three periods, and Liked Songs by week, month and year ## Honest numbers Spotify's API doesn't share play counts or listening time for any period, and stopped providing genres in 2026. So Kateify never estimates them: rankings are shown as rankings, the top album is derived from top tracks (and says so), genres and countries come from [MusicBrainz](https://musicbrainz.org), and every card has a _"How this is calculated"_ note naming its source. ## How it's built - **Next.js 16** (App Router, React Server Components, Cache Components), **React 19**, **TypeScript**, **Tailwind CSS v4** - Charts with **[nanoplot](https://github.com/ShanonJackson/nanoplot)**: radar, bars and world map - **No database and no visitor logins.** The server reads Kate's data with a stored Spotify token and caches it, so visitors never touch Spotify directly - **Zod** validation of every API response, typed errors, structured logs with secrets redacted - **Tested**: ~110 unit and integration tests (Vitest + MSW) and Playwright end-to-end tests against the production build, including a check that no secret ever reaches the browser - Strict security headers (Content-Security-Policy, HSTS), read-only Spotify permissions ## Learn more - [`docs/OPERATIONS.md`](docs/OPERATIONS.md): running it locally, connecting Spotify, deploying, testing and security details - [`docs/PLAN.md`](docs/PLAN.md): the original research and the decision log of how the project evolved --- Personal, non-commercial project. Listening data from the Spotify Web API (not affiliated with Spotify). Genre and origin data from MusicBrainz (core data CC0; tags CC BY-NC-SA 3.0).