Listen to something that moves you. A little better, every day.
VoysNote is an inspiration-first audio entertainment platform, plus VoysNote Studio, an AI production studio that researches, writes, fact-checks, narrates and masters inspirational audio. Humans approve every series and every episode before release.
Every piece of audio on VoysNote must have a genuine inspirational purpose. The central editorial question: what will someone feel, understand or believe differently after listening?
npm install
npm run dev # http://localhost:3000- Open
/welcomeand create an account. In local development the first account becomes the admin. Elsewhere, list admin emails inADMIN_EMAILS. - Browse the app. The eight seeded series are editorial concepts with no audio, and they're labelled "In development".
- Make real audio playable in either of two ways:
- CMS (
/admin): open an episode, upload a recording with its licence, then publish. The audio is analysed and mastered to −16 LUFS with FFmpeg. - Studio (
/studio): add your API keys (below), then start a production or click Produce in Studio on any episode.
- CMS (
npm test # 18 unit + end-to-end tests (real FFmpeg; provider test doubles)
npm run typecheck
npm run build
npm run db:reset # wipe local data; re-seeds on next startCopy .env.example to .env.local. Every key is server-side only.
| Feature | Needs |
|---|---|
| Accounts, listening, streaks, Daily Five, journal, CMS, creator tools | nothing |
| Audio mastering, loudness, waveforms | nothing (FFmpeg is bundled) |
| Studio research, writing, editorial, fact-check, quality agents | ANTHROPIC_API_KEY |
| Licensed AI narration | ELEVENLABS_API_KEY |
| Cover art generation | GEMINI_API_KEY or FAL_KEY |
| VoysNote+, coins, creator subscriptions | STRIPE_SECRET_KEY, STRIPE_WEBHOOK_SECRET (webhook → /api/webhooks/stripe) |
| Production data | DATA_BACKEND=supabase (run supabase/migrations) and STORAGE_BACKEND=r2 or supabase |
There are no simulated stand-ins. When a key is missing, the Studio step that needs it stops as blocked and names the key. Press Resume once it's connected. Payment buttons say payments aren't enabled.
- Listener app: 6-screen onboarding (feelings → interests → time); a Home screen with Daily Five, Continue Listening, Today's Note, Made for Your Mind, The World According To…, Your Next Chapter, Voices You Follow, New This Week and Your Journey; Explore by feeling, subject and franchise; Follow a Mind; series, episode, collection and creator pages; Library (with offline downloads for VoysNote+); private Voice Journal (text and voice); Profile with a streak calendar and milestones; Year in Voices; invites; settings; privacy (consent history, export, delete).
- Player: a persistent mini-player and full-screen player with waveform seek, ±15/30 s, speed, sleep timer, queue, chapters, transcript, save, bookmark-a-moment, share, Media Session lock-screen controls, resume across sessions, and a "What stayed with you?" reflection.
- Habits: a day qualifies with 1 minute of listening or by finishing any piece. One missed day in any 7 is forgiven. Milestones at 7, 30, 100 and 365 days. Weekly goals. Streak protection is never sold.
- Money: VoysNote+ (£6.99 default), coin packs with full prices shown, coin unlocks, creator subscriptions (£4.99–£9.99), Stripe Checkout and Billing Portal, idempotent webhooks, refund claw-back, and creator revenue-share payouts. Access is enforced server-side on every audio byte.
- Creators: application → human verification → verified channel; upload or in-browser recording with automatic mastering; series with free, premium or subscriber access; submit for editorial review; real analytics and earnings.
- CMS (
/admin): search and filters, series and episode editing, audio upload with rights, artwork upload with licence, publish or schedule behind editorial gates, unpublish, bulk archive with confirmation, publishing history, review queue, collections, quality benchmarks, founder dashboard (cohorts and funnel from real data) and audit log. - Studio (
/studio): 16 agents plus you; an opportunity scan; "The World According To…" research editions; the 17-stage pipeline; a durable workflow engine (retries, rate-limit waits, resumable, budgets); inspectable deliverables with prompts and models; a Writers' Room for human edits; and an advisory quality system with a cliché linter, technical loudness checks and a human-calibrated rubric.
See docs/ARCHITECTURE.md, docs/DEPLOYMENT.md and docs/STATUS.md (what works, what needs configuration, what's next).