Shelf
Design & build | 2026 · v1 → v2Reading companion
Shelf is a reading companion — Track books. Share reviews. Read smarter. — for readers who finish a book every few days, juggle holds, and always want the next one. Browse a catalog, rate and review, tag what you want to read, and see what the community is reading next.
The arc
A first version on seeded mock data to prove the UX, then a rebuild on real data (Open Library API + Supabase) and a sharper visual identity — from editorial serif to a monospace "card catalog" system.
Stack
Cursor, Figma, Vanilla JS, Open Library API, Supabase, Netlify
View the live app ->
v2 (latest)
v1 (original)
V2 explorations
Catalog, search, reviews, auth-gated shelves on live data:User Tasks & Flows
Discover (browse catalog, search) → Decide (reviews & ratings) → Track (Want to read / Favorite) → Share (post to feed).In v2, tracking and sharing sit behind Sign in / Join.
Version 1 · Mock-data prototype
Libby isn’t an open API — so v1 simulated a connected library: network delays, seeded covers, grepped reviews. Comments lived locally and didn’t persist on return. Typography: Cormorant Garamond / DM Sans on a literary cream canvas — enough realism to pressure-test UX before live data.Version 2 · Live data + backend
As I moved into 2.0, I evolved the site design from a few seeded books to experience the flows to OpenLibrary API data to enable real search queries and improve the logic of the search results (default to English and show the most likely result first based on popularity). I also connected Supabase to log custom book lists and retain a record of comments and reviews in the site’s backend. Here’s a peek at some of the features I focused on and how the approach changed moving from mock data to a real API + backend:What changed, v1 → v2
Data — mock-data.js → Open Library API
Backend — none → Supabase auth + database
Personalization — static profile → Want to read / Favorite shelves
Design — Cormorant serif editorial → IBM Plex Mono card catalog
Search — basic browse → full keyword search, ranked results, language defaults
Mood Board & Styles
Both versions share warm cream canvas; v2 shifted ink warmer and traded elegant serif for a monospace catalog voice.
Prompts, evals, and failure modes
Where time went in v2: API shape, auth, empty/error/loading states, and search rankingsVisit Shelf (v2) →
More Vibe-Coded Projects