Dashboard
The Dashboard is the home screen and default landing page. Public v1 focuses on collection value, activity, recently added records, most valuable records, collection breakdown, Discogs matches, record shops, and games. Other sections documented below are retained for later releases and may be hidden.
Layout (web): On phones (<480px) the dashboard is a single stacked feed with a 2×2 quick-action grid and bottom navigation. From 480px the actions sit in one row; from tablet width (768px+) a top header replaces the bottom nav and the Crate Wall grid pairs modules. Laptop (1024px+) uses a 12-column command-center layout; desktop (1280px+) keeps a ~1200–1280px content canvas. Search is available from the desktop header and from a mobile search control (top-right, next to theme). Section hide controls sit in each card header (touch-safe on phones; quieter on desktop until hover/focus).
Layout (Expo): Same logical zones (hero, alerts, pulse, discovery, utility). Phones stay one column; tablets use side-by-side zone pairs; large landscape uses an 8/4 primary/rail flex. Portrait and landscape are both supported (`orientation: default`). Touch targets are ≥44pt.
Collection value
The hero section shows your total collection value based on Discogs median prices. Below it, a sparkline chart shows how your collection value has changed over the past 12 months, with a percentage change indicator.
Week in Review
Six stat cards summarizing your recent activity:
- Added this week — Records added in the past 7 days
- Week's value — Total value of records added this week
- Total collection — Overall record count
- Artists tracked — Unique artists across your collection
- Top genre — Most common genre
- Total value — Full collection estimated value
- Decade — 60s, 70s, 80s, 90s, 2000s, etc.
Quick Actions
Shortcut buttons jump to common tasks. Web and Desktop: Scan, Search, Share (share shelf), Export — laid out 2×2 on narrow phones and in one row from 480px up. Expo (iOS/Android): Scan, Search, Wantlist, Export — same idea (share shelf is available from Collection on mobile).
Daily habit
A compact strip at the top of the dashboard (Web / Desktop) or just below Quick Actions (Expo) with copy about building a listening habit. Spin This Today jumps to the smart queue section so you can pick a record to play. Same behavior on all platforms.
Activity Feed
A timeline of recent events: records added this week, upcoming shows (with venue when available), collection value, and Discogs match activity. On wider web layouts, Activity sits with hunt matches in the alerts rail.
Deep Cut of the Week
A weekly rotating spotlight on a record from your collection you might have overlooked. Changes every Monday, deterministic so everyone sees different picks based on their collection. Shows album art, artist, album, and metadata.
Recently Added
A horizontal scroll of your 8 most recently added records with "X days ago" labels.
Value Over 12 Months
A line chart showing your collection's value trend over the past year, with tooltips showing exact values per month.
Most Valuable
Your top 3 highest-value records with album art and value.
Collection Insights
Eight mini stat cards: Average value, Decade span, Unique labels, Format count, Top label, Top decade, Most valuable single record, Total records.
Collection Breakdown
Bar charts showing your collection by:
- Condition — M, NM, VG+, VG, etc.
- Format — LP, 7", CD, Cassette, etc.
- Top Labels — Most common record labels
- Collection (weighted 3×) — artists from your vinyl/CD/cassette collection
Taste bridge
When your account has Music life data, the dashboard can show a short snapshot: how many artists overlap between Spotify (synced library + recent plays) and your Discogs collection, optional streaming vs collection counts, and when the API provides them, a Discovery line (unique artists in streaming libraries / repeat listens %), matching Profile → Music life. For a fresh profile with no collection or streaming artists yet, Build your Taste bridge and Connect & sync → take you to Profile → Music life to link services and refresh. Music life → goes to the same profile section once data exists. The card stays hidden if Supabase or required migrations are not set up. Web/Desktop: switching to the Dashboard tab runs the usual dashboard load, which refetches this block. On iOS/Android, the snapshot refetches when you open the Dashboard tab (one request per focus, not duplicated on first open), so after Refresh taste bridge on Profile you can switch back to Dashboard to see updated numbers.
Your Taste DNA
A unified taste profile merging data from three sources:
- Last.fm scrobbles (weighted 2×) — artists from your recent listening
- Spotify (weighted 1×) — artists from new releases you follow
- Top Artists — Ranked list with source icons and score bars
Shows:
- Genre Breakdown — Horizontal bar chart of genres
- By Decade — Horizontal bar chart of decades
- You stream but don't own — Gap analysis showing artists with high digital affinity but no physical records
- Own but never stream — Records you own but rarely listen to digitally
- The app asks the server for shows for up to 60 artists, prioritizing artists with more releases in your collection (then alphabetically). You can also mute artists from a row or from Event settings.
Tap Refresh to recompute.
Coming to Town (Bandsintown)
Upcoming concert events for artists in your collection.
- Tap Event settings to add/remove tracked cities, choose how many days ahead to include (30 / 60 / 90 / 180), and mute or unmute specific artists (Expo and Web/Desktop both support the full muted list in settings).
- Events show date, venue, and a link to buy tickets
- City preferences, horizon, and muted artists persist across sessions (API)
- Set a target price — get notified when the Discogs median drops below it
New from Artists You Follow (Spotify)
Recent releases (last 6 months) from Spotify artists you follow. Tap to open in Spotify. Requires connecting Spotify in Profile.
Recently Played (Last.fm)
Your 10 most recent scrobbles. Tap to open on Last.fm. Requires connecting Last.fm in Profile.
Loved Tracks (Last.fm)
Your favorited tracks on Last.fm with heart icon. Tap to open on Last.fm.
Recent Stories
The latest provenance/memory notes from your collection records. View all stories opens the full list with tips: open a record and use the artist name for a same-artist timeline; Explore by label and Your scene map (higher on the Dashboard) cover label shortcuts and a map of shops or fairs in your cities when you have locations or trips.
Price Alerts
Track price changes on specific records:
- View active alerts with current vs. target price
- Add new alerts by searching for a release and setting your target
- Remove alerts you no longer need
- Rediscover a classic — Listen to something you haven't played in a while
Weekly Mission
A rotating gamified prompt that changes every week (same eight missions on Web, Desktop, and Expo). Dismiss for this week hides the card until the next weekly rotation; preference is stored on the device (`localStorage` on Web/Desktop, AsyncStorage on Expo). Profile → Show weekly mission again clears that preference without waiting for the week to roll over.
- Add a story — Write a provenance note on a record
- Explore the label — Dive into a label in your collection; when this mission is active, use Go to Explore by label to jump to that section (or add label data to your records if shortcuts are not shown yet). Web, Desktop, and Expo.
- Show off a shelf — Share your collection (Share My Shelf)
- Scan something new — Digitize a record with the scanner
- Spin your newest — Your latest addition
- Check your most valuable — Revisit estimated value on your top record
- Spin something you haven't played in a year — Oldest or stale adds
- Add a trip — Enter a city and date range
Spin This Today (Smart Queue)
Six deterministic daily picks from your collection — records "you haven't played in a while." Changes daily. Use Daily habit (above) for a one-tap scroll to this section on Web, Desktop, and Expo.
Your cities → browse shops
When you have saved event locations (Coming to town → Event settings), chips appear with each city name. Tap a city to fill the global directory search and show record shops for that area. Map (pin icon) opens a search for record stores near that city in Google Maps. Web, Desktop, and Expo.
Browse record shops worldwide
Search and filter the global record-shop directory (name, city, country, shop vs fair). Open any result in Google Maps; Web and Desktop also support an embedded map with multiple markers. Expo uses in-app browser / map flows for the same data. For the doc map and the latest UX differences between Web/Desktop and Expo, see `spec.md` and `docs/FEATURE-PARITY.md` in the repository.
Because You Own These... (Recommendations)
AI-powered artist recommendations based on your collection. Shows up to 12 recommended artists with images, names, and reasons.
Today's Finds
Four daily rotating picks curated from your wantlist and taste profile.
Travel Mode
Plan record-shopping trips:
- Matched shows — Concert events happening during your trip
- Matched record shops — Bookmarked shops in the trip city
- Delete trip when done
- Web & Desktop: add and edit shops from Profile → My Record Shops (optional feed URL, Feed button to edit or open the feed).
My Record Shops
Bookmark favorite stores and optionally attach a new-arrivals RSS or Atom feed so New at your shops can show recent items.
- Expo: the same My Record Shops block lives on the Dashboard (optional feed URL when adding a shop; Add feed URL / Open feed on each row).
- RSS rows — Latest titles from each bookmarked shop that has a feed URL (after the feed has been checked).
Shops appear in Travel Mode when you visit their city. The server can poll feeds when configured (see Supabase migration for `feed_url` / `feed_items` in the repo).
New at your shops
When you have event locations or trips, the dashboard shows New at your shops:
- Per-shop status — Last checked time and, if something went wrong, an error message from the daily feed job (timeout, blocked response, etc.). Editing the feed URL in My Record Shops clears the error for the next run.
- Open feed — Link next to each shop name opens the raw RSS/Atom URL (useful for checking the source in a browser).
- New since your last visit — When the latest headlines differ from what you saw last time you loaded the dashboard, a short note appears (stored per device: browser `localStorage` on Web/Desktop, AsyncStorage on Expo).
- Empty vs error — Copy distinguishes “still waiting for the first fetch,” “fetch worked but the feed was empty,” and “couldn’t load” (with the error line below when applicable). Item lines can show a date when the feed includes `pubDate`.
Web, Desktop, and Expo show the same content; feeds are configured under My Record Shops (Web/Desktop: Profile; Expo: Dashboard section).
Your scene map
After Your cities → browse shops, Your scene map puts the same shops-and-fairs list (from your locations and trips) on a Leaflet + OpenStreetMap map (up to 5 geocoded pins, same as the browse embed). Web and Desktop: tap Show map / Hide map to toggle inline. Expo: tap Show map for a full-screen in-app WebView using the same map stack (Nominatim geocoding, then Leaflet). If nothing can be geocoded, you’ll get a short alert instead of markers.
Games & Experiences
Six mini-games and one reference experience on the Dashboard — same titles and URLs on Web, Desktop, and Expo. Web and Desktop open each link in a new browser tab; Expo opens the in-app browser (Safari/Chrome custom tab) so you return to the app with one tap.
| Game / experience | Description |
| Beat Drop | Rhythm game |
| Punk Rock Trivia | Music trivia quiz |
| Grohl Machine | Drum machine |
| Label Detective | Label identification quiz |
| Vinyl Snake | Classic snake game with vinyl records |
| Cartridge Curves | Compare cartridge frequency responses and specs |
See Games for details.