DB reset pending — will lose test data

Required before production data load.

Aesthetic profile pending

Will define final visual language for the app. Blocked on Stage 3.

App name is Velverie

Chosen over Trope, ShelfLife, MoodRead. Romance-native, memorable, domain available.

UK English throughout

Australian founder, global audience. UK English is the standard for all copy.

Dark mode default

Romance readers read at night. Dark mode is the primary experience.

Five tabs: Home / Mood / Search / Library / Profile

Core navigation structure. Mood is the differentiator.

Trope taxonomy is flat, not hierarchical

Aliases map to canonical tropes. No nesting. Simpler for search and mood matching.

Target 500 books for launch

Quality over quantity. 500 well-tagged books beats 10k poorly tagged.

Authors input is manual CSV, not scraped

Goodreads scraping is legally risky. Manual curation ensures quality.

Privacy policy and terms required before TestFlight

Apple requires both. Live at velverie.app/privacy and /terms.

GDPR compliance from day one

Even pre-launch. Australian Privacy Act + GDPR. No shortcuts.

Territory: Australia first

Solo founder in AU. Launch where you can iterate fastest.

Primary channel: TikTok (BookTok)

Romance readers are on BookTok. Instagram is secondary.

Affiliate: trad-pub via Bookshop.org, indie via Amazon

Amazon tag: tropeapp-22. Bookshop.org for trad-pub titles.

Freemium model: free core, Pro for power features

Free: browse, search, basic library. Pro: mood engine, advanced filters, unlimited shelves.

RevenueCat for subscription management

Handles Apple/Google IAP, analytics, paywalls. No custom billing.

Flutter for cross-platform

iOS first, Android follows. Single codebase.

Supabase for backend

Auth, database, storage, realtime. No custom server.

Hub is Next.js on Vercel, not local Python

Replaced server.py. Deployed, accessible, production-grade.

Kit (ConvertKit) for email marketing

Waitlist, sequences, broadcasts. Already configured.

Fastmail for transactional email

brea@velverie.app. SMTP via app password.

No UI component library (shadcn, MUI etc)

All UI is custom per design system. Full control over aesthetics.

Claude API for book enrichment pipeline

Anthropic API processes author/book data. Key rotation deferred.

Mood system uses emotional tones, not genre labels

Moods like "yearning", "tension", "comfort" — not "contemporary romance".

Golden path testing before every TestFlight build

Core user journey must pass before any beta distribution.

TestFlight for iOS beta distribution

5-stage pipeline: Identified > Invited > Onboarded > Active > Churned.

Handle: @velveriereads on all platforms

Consistent across TikTok, Instagram, X. Not yet created.

GitHub Pages for velverie.app landing page

Static site. Simple. Free hosting. Custom domain configured.

Wave for bookkeeping (no API)

Manual tracker. Wave has no API. Finance panel is standalone.

Australian BAS quarterly schedule

Q1: Oct 28, Q2: Feb 28, Q3: Apr 28, Q4: Jul 28.

Anthropic API key rotation deferred

Not urgent. Intentionally deferred. Amber status in Security panel.

All hex values are CSS custom properties

Never hardcode raw hex in components. Stage 3 locks final palette.

Hub state lives in Supabase, not localStorage

Persistent across devices. RLS policies for access control.

Goodreads scraper deferred

Legal risk too high. Manual curation preferred.

Waitlist is live on velverie.app

Kit form embedded. Collecting signups pre-launch.

Press strategy is post-launch

No outreach until app is live. Pitches prepared in advance.

App Store copy written by Claude with brand voice

All copy generation uses assistant/chat with constraints.

Support triage uses Sentry + manual tickets

No App Store Connect API pre-launch. Reviews tab is placeholder.

Changelog is editorial, not auto-generated

Claude writes entries in brand voice from git log.

Vercel cron for daily scans and weekly digests

7am AEST scan, Sunday 8am digest, daily press scan.

Terminal panel uses local WebSocket server

Vercel is serverless — terminal needs local ws bridge.