WhisperHire - The Freelance Marketplace for AI Audio & Speech Developers

Core User Journey

1. Client registers via email magic link and completes the 4-step job posting wizard (audio type, languages, budget, description). 2. Founder receives a Resend alert, reviews the job, and manually emails the client 3-5 freelancer profile links within 24 hours. 3. Client reviews profiles, messages top candidates via in-platform chat, and selects one. 4. Client funds the first milestone in escrow via Stripe — freelancer is notified by email. 5. Freelancer completes the work, marks the milestone as delivered, and uploads any deliverable files. 6. Client reviews the delivery and clicks 'Approve' — Stripe releases the payout to the freelancer's Connect account within 3 business days. 7. After the final milestone, both parties are prompted to leave a star rating and written review.

Architecture Pattern

Next.js App Router with server components handles SSR for job listings and freelancer profile pages; API routes handle Stripe webhooks and form submissions. Supabase PostgreSQL stores all application data with row-level security enforcing tenant isolation, and Supabase Realtime pushes milestone status updates to the client dashboard without polling. All payment state is authoritative in Stripe — the database mirrors Stripe webhook events rather than serving as the source of truth for financial data.

Data Model

User {id, email, role: 'client'|'freelancer'|'admin', createdAt}. FreelancerProfile {id, userId, skills[], availability, hourlyRate, portfolioUrl, vetted: bool, githubUrl, bio, stripeConnectAccountId}. Job {id, clientId, audioType, languages[], budget, timeline, status: 'draft'|'posted'|'matched'|'active'|'complete', description}. JobMatch {id, jobId, freelancerId, proposalText, status: 'pending'|'accepted'|'rejected'}. Milestone {id, jobId, freelancerId, description, amount, status: 'pending'|'funded'|'delivered'|'approved'|'paid', stripePaymentIntentId}. Review {id, jobId, reviewerId, revieweeId, score: 1-5, comment, createdAt}. Each User has one FreelancerProfile or acts as client; Jobs have many Milestones; each completed Job produces two Reviews (bidirectional).

Integration Points

Stripe Connect (freelancer Express account onboarding, escrow PaymentIntent creation with application_fee_amount, milestone payout on approval, webhook events for payment state sync), Supabase Auth (GitHub OAuth for freelancers, email magic link for clients), Supabase Storage (vetting challenge audio file uploads, deliverable file storage with private access policy), Resend (job alert emails, match notification emails, milestone status emails, payout confirmation emails)

V1 Scope Boundaries

V1 includes: manual founder-driven matching, Stripe Connect escrow and milestone payouts, freelancer profiles with skill tags and vetting status, structured job posting wizard, basic star-rating review system, email notifications via Resend, Supabase file storage for vetting challenge uploads. V1 excludes: automated match ranking algorithm, in-app messaging beyond email, dispute resolution workflow, Pro badge subscription billing, Teams plan, adjacent AI niches beyond Whisper, mobile app, API access for ATS integrations.

Success Definition

WhisperHire wins when it has facilitated 10 completed, paid projects with a client satisfaction score above 4.5/5 within the first 90 days, proving that the vetting-plus-matching model solves the hiring problem better than any general platform and that repeat clients will keep coming back.

Challenges

Cold-start problem on both sides of the marketplace — need freelancers before clients arrive and vice versa. Solution: manually recruit 20-30 vetted Whisper developers from GitHub, Hugging Face forums, and Reddit before launch, so day-one clients see a real talent pool. Transaction volume must stay on-platform; enforce this via ToS and by making escrow the clear, most-convenient trust mechanism. A second risk is founder time cost during manual matching — cap at 10 active jobs simultaneously in V1 to avoid burnout before automation is built.

Avoid These Pitfalls

Do not build the matching algorithm before collecting at least 50 real match outcomes — manual matching for the first 50 projects is how you learn which signals (skills, past project type, availability, communication speed) actually predict client satisfaction. Do not expand to adjacent AI niches (ElevenLabs, LangChain) until the Whisper category is generating at least $5K/month in commission — premature expansion dilutes the brand and splits your recruitment effort. Do not skip or soften the vetting challenge — an unvetted marketplace is just another Upwork, and the vetting process is the single biggest differentiator; every shortcut here erodes the core value proposition.

Security Requirements

Stripe Connect KYC handles freelancer identity verification for payout eligibility, and escrow funds never touch WhisperHire's bank account — Stripe manages the hold, ensuring PCI compliance is fully delegated to Stripe. Supabase row-level security policies enforce tenant isolation so clients can only read and write their own jobs and milestones, freelancers can only see jobs they have been matched to, and all vetting challenge file uploads are stored with private Supabase Storage policies accessible only to the submitting freelancer and admin role. HTTPS enforced on all routes; API routes validate session tokens on every request via Supabase Auth middleware.

Infrastructure Plan

Next.js deployed on Vercel Pro for global edge SSR and automatic preview deployments on every pull request; Supabase Pro plan provides PostgreSQL, Auth, and Storage with daily automated backups and point-in-time recovery. All payment infrastructure runs on Stripe Connect with no additional payment servers required; Resend handles transactional email with DKIM-authenticated sending domain. CI/CD via GitHub Actions running Zod schema validation and Supabase migration checks on every push to main before Vercel auto-deploys.

Performance Targets

500 DAU at month 6 peak. Freelancer profile page load under 2 seconds via Next.js SSR. Skill-tag search results returned in under 500ms via Postgres full-text search at up to 500 freelancer profiles. Stripe milestone escrow capture completing in under 5 seconds. Resend transactional email delivery within 2 minutes. Supabase Realtime milestone status update pushed to client dashboard within 3 seconds of freelancer marking delivery.