Vinyl Crate
A vinyl collection app with an iPhone OS 3 / iPod nano look. Photograph a
record cover; Claude identifies it, Discogs finds the pressing, tracklist and
price, and it's filed in your crate. Browse as an iPod-style list or in Cover
Flow on a click-wheel nano, shuffle to pick something to play, export to CSV
and share a read-only link.
Runs as a website on Vercel and as an iPhone app (Capacitor) from the same code.
Develop
cp .env.example .env.local # then fill in the keys
npm install
npm run dev # http://localhost:3000 (add ?demo for a sample crate)
| Command | What it does |
|---|
npm run dev | website + API locally |
npm run lint | ESLint |
npm run build | production web build (what Vercel runs) |
npm run build:ios | static bundle for the app, synced into ios/ |
npm run ios:open | open the Xcode project |
Layout
| Path | |
|---|
app/page.js | the app shell: tabs, auth state, data loading |
components/ | Albums list, Now Playing, Import, Settings, nano + Cover Flow |
app/api/*/route.server.js | server routes (left out of the iOS build) |
lib/vision.js | cover identification: cheapest model first, configurable via VISION_MODELS |
lib/native.js | Capacitor bridges (haptics, share, files, sign-in links) with web fallbacks |
supabase/ | schema.sql for a fresh project, migrations/ for the live one |
ios/ | Capacitor iOS project |
docs/LAUNCH.md | App Store and scaling runbook |
