# Whatayarn Overview

## Table of Contents
- [Quick Facts](#quick-facts)
- [Story & Positioning](#story--positioning)
- [Audience & Core Value](#audience--core-value)
- [Primary Site Pages](#primary-site-pages)
  - [Homepage](#homepage)
  - [Pricing](#pricing)
  - [Blog](#blog)
  - [Sign In](#sign-in)
  - [Creator Dashboard](#creator-dashboard)
  - [Public Channel Pages](#public-channel-pages)
  - [Legal](#legal)
- [Homepage Flow](#homepage-flow)
- [Listener Experience on Channel Pages](#listener-experience-on-channel-pages)
- [Creator Dashboard Details](#creator-dashboard-details)
- [Messaging Inbox & Tagging](#messaging-inbox--tagging)
- [Channel Settings & Customization](#channel-settings--customization)
- [Plans & Pricing](#plans--pricing)
- [Limits & Entitlements](#limits--entitlements)
- [FAQ Highlights](#faq-highlights)
- [Support & Community](#support--community)

## Quick Facts
- **Tagline:** “Voicemail from your podcast listeners – no apps, no downloads.”
- **Product:** Hosted voicemail landing pages for podcasts and creators, routed to email + dashboard.
- **Created by:** Ty Lange-Smith (Aussie founder) with inspiration from local podcast communities.
- **Live proof:** 10,000+ listener voice messages already shared through Whatayarn.
- **Domain:** https://whatayarn.com (live production domain).
- **Demo links:** `/whatayarn` live channel demo, `/signin` to spin up your own.
- **Contact:** `hellowhatayarn@gmail.com`; Reddit community at r/WHATAYARN.
- **Current offer:** “Founding Offer - 30% off” badge featured across hero and pricing.

## Story & Positioning
Whatayarn was born from watching Australian podcasts struggle with clunky voicemail workflows-asking fans to record in voice memos, email files, remember length limits, and hope attachments arrived. The product replaces those long instructions with a branded link that slots into show notes, socials, or newsletters. Fans tap, record (or upload), and the creator receives formatted MP3 files with listener context in their inbox and dashboard.

## Audience & Core Value
- **Primary users:** Podcasters, storytellers, and creators who run listener Q&As, hotlines, or community segments.
- **Listener promise:** A frictionless, mobile-friendly way to speak back to the show in under 10 seconds.
- **Creator promise:** Beautiful landing pages, automatic email delivery, searchable inbox, branding control, and message-length enforcement without extra tooling.
- **Key outcomes:** More participatory episodes, ready-to-use audience stories, and easy repurposing for Shorts/Reels/TikTok clips.

## Primary Site Pages
### Homepage
One long-form landing page (`/`) that introduces the product, social proof, feature explanations, and pricing. Navigation anchors: How It Works, Features, Problem, Pricing, FAQ, Blog.

### Pricing
Dedicated page (`/pricing`) that highlights the same hero pricing stack, allowing visitors to jump straight into plan comparison with supporting sections below.

### Blog
Content hub at `/blog` with ShipFast-style MDX posts (e.g., “Podcast Voicemail,” “SpeakPipe alternative,” “Podcasting on a budget”). The page pulls post metadata, shows a feature image banner, and links back to Home/Pricing.

### Sign In
`/signin` offers Google OAuth or passwordless email magic link via Supabase. Magic links redirect back into `/app` with callback handling. Copy reassures sign-up is free and quick.

### Creator Dashboard
Authenticated area under `/app` with a sticky header, channel switcher, and nav tabs for Appearance, Messages, and Settings. Default landing route redirects to the user’s first channel or channel creation flow.

### Public Channel Pages
Slugged pages at `/{channelSlug}` present the listener-facing recording experience. Each page pulls channel branding, links, and entitlement checks from the API and sits inside a mobile-frame layout. Upgrade gating kicks in if the creator is on the free tier and usage limits are hit.

### Legal
Footer links point to `/tos` and `/privacy`; both live under the Next.js app directory and inherit standard ShipFast styling.

## Homepage Flow
- **Hero** - Founding offer badge, headline “Voicemail from your listeners,” promise of no apps/downloads, CTA form to reserve `whatayarn.com/<slug>`, Try Live Demo button pointing to `/whatayarn`, and stat bubble showing 10k+ messages shared.
- **How It Works** - Three-card walkthrough: create your channel, share anywhere, receive voice messages. CTA button loops back to channel creation.
- **Features** - Three alternating feature blocks:
  - *Make it yours* (custom URL, avatar, bio, social links)
  - *For your listeners* (no app, no login, upload or record)
  - *Your inbox, organised* (messages land as MP3, consistent formatting, listener info included)
- **Problem** - Split card comparing the “Old Way” (voice memos + email juggling) versus “With whatayarn” (tap, record, send at `whatayarn.com/yourshow`).
- **Pricing** - Two-plan layout (Creator Monthly and Creator Yearly) with strikethrough original price, founding offer badge, and Checkout buttons hitting `/api/stripe/checkout-redirect` with the correct price IDs.
- **FAQ** - Accordion answering the top creator questions (sharing the link, listener flow, inbox delivery, limits, mobile support, cancellation).
- **Footer** - Logo, mission blurb, copyright, Reddit link, quick nav shortcuts, legal links, blog link, contact email, and a “More Information” external resource.

## Listener Experience on Channel Pages
- **Header block** - Channel avatar, name, descriptive prompt, and optional custom link buttons (website, socials, email, etc.) styled as pill buttons with auto-appended UTM parameters.
- **Step-based workflow** -
  1. **Record or Upload:** Browser recorder with waveform visualizer, upload option, and max-duration indicator (formatting via `format-duration`). Handles permission prompts, errors, and allows retakes.
  2. **Identity capture:** Depends on creator settings. If login required, visitors are asked to sign in before proceeding. Otherwise a lightweight form collects optional name/email.
  3. **Details & Send:** Title + description form, validation, and UploadThing-powered audio upload to the servers. Listeners see progress states, error messaging, and gating if the creator has hit message limits.
  4. **Confirmation:** “Message sent!” screen with inline audio playback/download of the submitted clip, plus summary of title/description and a “Send another message” reset button.
- **Upgrade modal:** If entitlements deny sending (e.g., free-tier limit reached), visitors see a modal prompting the creator to upgrade: includes founding-offer pricing, plan features, and link to `/pricing`.
- **Powered footer:** Every channel page ends with a “powered by whatayarn” link back home, tracking clicks via PostHog.

## Creator Dashboard Details
- **Navigation:** Sticky header shows plan status, channel switcher with avatars, quick nav tabs for Appearance, Messages, and Settings, and an “Upgrade to Pro” button if on free tier.
- **Channel creation (`/app/new`):** Guided slug picker with live validation (letters/numbers/dashes/underscores), auto-prefilled from landing page form, and messaging for channel quotas. Free users see an alert if they try to exceed the free limit; Pro users can create up to five channels.
- **Appearance tab:**
  - Banner summarises live URL with one-click copy.
  - General card controls avatar upload/removal (UploadThing), display name, and description with max lengths.
  - Links admin lets creators add social/website buttons (supports website, Facebook, Instagram, TikTok, YouTube, Spotify, Apple Podcasts, Patreon, X, Reddit, email). Drag-and-drop reordering persists to the API, and each link can be edited or deleted inline.
  - Live mobile preview renders inside a phone frame iframe refresh.
- **Settings tab:**
  - SEO controls: custom slug, meta title (≤70 chars), meta description (≤160 chars).
  - Notifications & defaults: toggle email notifications for new messages, toggle listener login requirement, input for max audio duration (1–600 seconds) with debounced auto-save.
  - Danger zone: delete channel confirmation flow that removes data and redirects home.
- **Account tab:** `/app/[id]/account` currently placeholder (“TODO”).

## Messaging Inbox & Tagging
- **Message list:** Grouped by recency buckets (Today, Yesterday, Last week, Last month, Older). Each entry shows title, duration pill, sender name/email, relative timestamp, manual description preview, custom tags, and bookmark badge.
- **Filters:** Global search, tag filter popover, “Bookmarked” toggle, and “Clear all” control keep query string state synced for sharing.
- **Tags & bookmarks:** Per-message tagging with optimistic updates, dedicated bookmark toggle stored as a tag, and UI to add/remove custom tags. Tags also feed the filter dropdown.
- **Pagination:** Paginated requests (limit 100) with next/previous controls; stores keep count metadata for analytics.
- **Detail view:** Dedicated page per message with full waveform audio player (WaveSurfer.js), download button, sender avatar with copy-to-clipboard email, description, and tag management.
- **Error handling:** Messages list wrapped in a custom error boundary that invites a page reload if something fails.

## Channel Settings & Customization
- **Branding:** Custom avatar (upload/remove), name, description, and shareable slug at `whatayarn.com/<slug>`.
- **SEO:** Meta title/description editors to control search snippet text, plus slug editing with validation.
- **Links:** Add unlimited CTA buttons with iconography mapped to link type, reorder them with drag-and-drop, and auto-append UTMs.
- **Listener defaults:** Control whether sign-in is required and set the maximum recording length to match show format.
- **Notifications:** Toggle email notifications for new messages per channel.

## Plans & Pricing
- **Creator Monthly:** A$15/month (displayed with original price A$21 struck through). Full feature access, cancel anytime.
- **Creator Yearly:** A$12/month billed annually (A$17 original). Highlighted as “🔥 MOST POPULAR” with savings callout (Save A$36/year ≈ 20%).
- **Included features (both paid plans):**
  - Create and customise branded voicemail channels
  - Unlimited incoming messages
  - Up to five message pages/channels
  - Adjustable max audio duration controls
  - Email notifications on every new message
- **Checkout:** Buttons initiate `/api/stripe/checkout-redirect` which route to Stripe checkout (handles auth redirects if needed).
- **Global copy:** “One plan. Everything you need. Pay monthly or save with yearly.” Founding offer badge reinforces limited-time discount.

## Limits & Entitlements
- **Free tier:** 1 channel, up to 10 total messages across channels, adjustable message duration between 10 seconds and 10 minutes, email notifications available, but message sending for listeners can be blocked once quota is hit (with upgrade modal).
- **Paid Creator plans:** Up to 5 channels (message pages), unlimited incoming messages, same duration controls, priority entitlements check passes automatically.
- **Entitlement checks:** Server-side service counts total messages per creator; if limit exceeded, `canSend` toggles false and reason surfaces in the listener workflow + upgrade modal.

## FAQ Highlights
- **How do I share my link?** Drop it in show notes, bios, newsletters-anywhere you promote episodes; it’s a single shareable URL.
- **Do listeners need an app or account?** No app download. Login is optional unless the creator turns on “Require login.”
- **Where do messages go?** Straight to the creator’s email inbox (e.g., Gmail/Outlook) and to the dashboard inbox with MP3 attachments, playback links, and listener info.
- **How many messages can I get?** Free channels cap at 10 total messages; Creator plans lift the cap.
- **Max duration?** Creator sets it-anywhere from 10 seconds to 10 minutes.
- **How many channels?** 1 on free, up to 5 on Creator plans.
- **Mobile support?** Fully responsive; most listeners submit from phones in seconds.
- **Cancellation?** Plans are cancellable anytime, no lock-ins.

## Support & Community
- **Email:** `hellowhatayarn@gmail.com` for questions, bugs, or ideas.
- **Reddit:** Official community at [r/WHATAYARN](https://www.reddit.com/r/WHATAYARN/).
- **Blog:** Guides covering podcast voicemail strategy, budget podcasting, SpeakPipe alternatives, and how-to walkthroughs.
- **More info:** Footer links to a Claude.ai artifact for extended documentation.
- **Analytics:** PostHog events track key interactions (CTAs, try-demo, checkout) to inform product decisions.