Executive Product Specification

Product Requirements

What problem VinylFindr solves, why it matters, and how the mobile camera scanner works for everyday record collectors and shop owners.

The Problem

Pricing vinyl records while browsing in a record store is slow and frustrating. Discogs is the world’s definitive music marketplace, but its mobile website and standard search require buyers to manually type catalog numbers, decipher tiny matrix codes, and scroll through dozens of identical-looking reissues.

Why this matters: Collectors and shop owners need instant clarity on what a record is worth before buying or selling. When browsing crowded crates, every extra tap or search error slows them down.

Strategic Goals & User Benefits

VinylFindr turns a phone’s camera into an instant record pricing scanner, guided by three core pillars:

1. Instant Recognition: Identify records in seconds. Modern releases scan automatically via barcode, while vintage records without barcodes are identified through AI cover artwork recognition.
2. Accurate, Condition-Based Values: Show real market values based on physical record grading (Near Mint, Very Good Plus, Very Good) and recent 6-month sales history.
3. Effortless One-Handed Use: Tailored for physical crate digging—large touch targets, zero lag, and no mandatory typing required.

User Journey

01
Welcome & Camera Access Onboarding

A brief visual walkthrough introduces the scanner. The user grants one-time camera permissions or taps "Skip" to jump straight into the live viewfinder.

02
Point & Scan (Two Flexible Ways) Smart Scanner

The camera viewfinder offers two seamless ways to recognize music:

• Automatic Barcode Scan (Zero Clicks): Point at any barcode on the record sleeve—the app identifies the album instantly without pressing a button. • Shutter Photo Scan (AI Vision): For vintage records without barcodes, tap the shutter button to capture the cover art. Google Gemini AI identifies the artist and album artwork.
03
Instant Value & Details Card Pricing Sheet

A clean drawer slides up from the bottom showing album artwork, release year, tracklist, and low/median/high pricing. Tapping condition buttons (NM, VG+, VG) updates the estimated price, with a 6-month sales trend graph and direct link to Discogs.

04
Helpful Fallback Search Edge Case

If a worn, obscure, or custom sleeve cannot be identified automatically, the app provides a quick "Try Again" reset or opens a manual text search with one tap.

Core Features

01. Viewfinder
Distraction-Free Camera Interface High-contrast camera overlay with a centered album framing guide, live animated scan line, and quick-toggle flashlight to illuminate records in dim shops.
02. Multi-Engine Search
Hybrid Detection System Combines background barcode decoding, AI visual album matching, on-device text recognition (OCR), and MusicBrainz spell checking to maximize scan success on the first try.
03. Pricing Drawer
Interactive Valuation & Pressing Matrix Displays verified Discogs prices, pressings variations (US vs UK, colored vinyl), condition grade breakdowns, and interactive 6-month sales graphs.
04. Preferences
Customizable Collector Settings Lets users filter results to vinyl only (ignoring CDs and cassettes), connect their Discogs account for custom price alerts, and manage AI scan settings.
System Architecture & Data Pipeline

Technical Architecture

How VinylFindr operates under the hood: system components, recognition pipeline, database caching, and cloud security.

Technology Stack

Frontend Platform
Mobile Web Client Fast, lightweight, zero-install experience
Vanilla HTML5 & Modern JavaScript Pure, framework-free browser code for instant load times and 60fps animations on mobile. Why: No App Store download required—works instantly in Safari or Chrome.
Html5Qrcode Scanner High-speed background barcode reader that processes camera frames every second. Why: Detects barcodes instantly without making the phone lag.
On-Device OCR (Tesseract.js) Reads catalog codes and text printed on record sleeves directly in the browser. Why: Works as a backup reader even on spotty shop Wi-Fi.
Cloud & Security
Serverless Backend Secure API routing and AI intelligence
Google Gemini 2.5 Flash API Multimodal visual AI that analyzes photos of album art and extracts artist/album names. Why: Recognizes vintage records produced decades before barcodes existed.
Cloud Redis Price Cache Saves market price data (7 days for releases, 24 hours for price trends). Why: Speeds up repeated lookups and prevents hitting Discogs rate limits.
Firebase Cloud Functions & Secret Manager Secure cloud proxy handling all third-party communication. Why: API keys and private tokens remain 100% secure on Google Cloud servers.

5-Stage Recognition Pipeline

When a user points their camera or taps the shutter, the system runs through an intelligent sequence to identify the exact vinyl pressing:

Stage 1: Barcode
Zero-Click Barcode Reader (Fastest) The camera continuously scans for UPC/EAN barcodes. If found, it fetches pricing immediately without the user pressing a single button.
Stage 2: AI Vision
Gemini AI Cover Recognition When the shutter is pressed, the photo is analyzed by Google Gemini AI to identify the album cover artwork, typography, and artist.
Stage 3: Text OCR
On-Device Text Parsing If AI recognition needs extra verification, local optical character recognition (OCR) reads catalog numbers and text from the sleeve.
Stage 4: Verification
MusicBrainz Spelling & Release Correction Extracted text fragments are cross-referenced with MusicBrainz to resolve spelling errors, abbreviations, and international reissue titles.
Stage 5: Valuation
Discogs Marketplace Price Fetch The verified release ID queries the Discogs database to deliver real-time sales averages, condition values, and active listings.

Database Structure

VinylFindr uses Google Cloud Firestore for two core collections: logging user scans and caching market valuations.

/scan_history User Scan History Log
Tracks past lookups
Field Type Purpose & What It Stores
scan_idstringUnique identifier for each scan event.
uidstringUser account ID to display their personal scan history.
scanned_attimestampExact date and time the record was scanned.
scan_typestringMethod used: "barcode", "cover_art", or "manual".
resolved_release_idnumberMatched Discogs catalog ID.
artist / titlestringDisplay artist name and album title for quick history browsing.
thumbnail_urlstringLink to high-resolution album cover image.
/price_cache Market Valuation Cache
Expires every 7 days
Field Type Purpose & What It Stores
release_idnumberDiscogs catalog number used as the lookup key.
last_updatedtimestampTimestamp of last refresh (refreshed automatically after 7 days).
currencystringStandard pricing denomination (USD).
grades map Market prices broken down by physical record condition:
• NM (Near Mint): Min, median, and max sale prices for pristine copies. • VG+ (Very Good Plus): Prices for clean, well-cared-for used copies. • VG (Very Good): Prices for played copies with minor cosmetic wear.
sales_history_6m array Monthly median sales points over the past 6 months to render the price trend graph.

Cloud Security & Key Protection

Why this workflow matters: Users' browser sessions never touch or expose paid Discogs or Gemini API credentials. All requests pass through an encrypted serverless proxy.
01
User VerificationValidates client app token
Mobile App──[ App Token ]──>Cloud Function
02
Secret RetrievalSafely loads API keys from Secret Manager
Cloud Function──[ Fetch Key ]──>Secret Manager
03
Authorized QueryFetches verified Discogs record data
Cloud Function──[ Discogs Token ]──>Discogs API
04
Data CompressionCleans and strips unnecessary data
Discogs API──[ Raw Data (120KB) ]──>Cloud Function
05
Instant DisplayDelivers compact, fast payload to phone
Cloud Function──[ Clean Data (8KB) ]──>Mobile App
Design System & Ergonomics

Design & Interface Standards

Layout rules, touch ergonomics for record stores, typography hierarchy, and condition-coded color palettes.

Crate-Digging Ergonomics & Layout

48px Touch Targets
Effortless One-Handed Use All buttons, condition chips, and interactive tabs have a minimum touch boundary of 48×48px. This ensures users can tap accurately with their thumb while holding heavy vinyl sleeves with the other hand.
4px Grid System
Harmonious Spacing Scale Margins, padding, and UI components follow a strict 4px grid (4, 8, 12, 16, 24, 32, 48px) for clean visual alignment across all modern smartphone screen sizes.
Viewport Margins
Safe Screen Offsets 24px horizontal gutters keep content away from curved phone edges, while the bottom results drawer includes a 32px safe-area cushion above the phone's home indicator.

Typography System

Typography balances clean sans-serif readability with monospace numerical pricing for clear scannability.

Hero Price Value 32px · Roboto Mono · Bold 700 Role: Instant glanceable valuation in record aisles
$124.50
Album & Artist Header 24px · Google Sans Display · Bold 700 Role: Clear title recognition
Abbey Road
Section Sub-Headers 17px · Google Sans · Bold 700 Role: Visual chunking between release details
Release Variations
Body Text & Action Buttons 14px · Inter / Roboto · Regular 400 Role: High-contrast descriptions and buttons
Identify Album
Catalog & Matrix Codes 13px · Roboto Mono · Regular 400 Role: Precise release code matching
Cat# SHVL 804

Color Palette & Vinyl Grading System

Colors reflect professional vinyl grading standards to give instant visual cues on record quality and price levels.

Primary Brand Accent #0F35A9 Scan beams, primary CTAs, active indicators
Near Mint (NM) Grade #188038 Green badge for flawless, highest-value condition
Very Good Plus (VG+) #B06000 Amber badge for standard clean collector copies
Very Good (VG) Grade #D93025 Red badge for well-played copies with surface marks
Viewfinder Black #000000 Deep black camera framing backdrop
Warm Surface Card #F8F9FA Crisp, glare-free background for bottom sheets

Motion & Interaction Guidelines

Natural Easing
Fluid Physical Transitions All UI animations follow natural deceleration curves (cubic-bezier(0.2, 0, 0, 1)) to match native iOS and Android gesture responses.
400ms Drawer Slide
Responsive Valuation Sheet When a record resolves, the pricing drawer slides smoothly into view over 400ms without jarring camera interruption.
Swipe-to-Dismiss
Direct Gesture Control Users can swipe down anywhere on the results drawer to instantly close it and resume scanning the next record in the crate.