For engineers and contributors. User-facing documentation lives at /docs.

v1.9 Distribution Plan

Goal: Early-stage founders try v1.9 and give feedback. One primary metric to optimize.


Primary metric

  • Recommendation: "Analyses per visitor" (or visitor → run analysis conversion rate). Secondary: feedback votes ("Was this useful?"), return usage, referrals.
  • Where measured: Events are sent to POST /api/analytics/events and persisted to Supabase analytics_events (when configured). Query by name and payload.
  • Event names for conversion:
    • analysis_started — fired when user starts a full analysis (result page, before POST /api/analyze). Payload: { url }.
    • crawl_started — fired when user starts a crawl (crawl page, before POST /api/roles/crawl). Payload: { url }.
    • report_completed — fired when Report 1 completes. Payload: { url, stage?, hasEnrichment? }.
  • Conversion: Count analysis_started (or crawl_started) per period; count report_completed per period. Conversion to run = report_completed / analysis_started (or use crawl_started for crawl-first flow). Optionally track unique visitors via session or user id when available.

Phases (order of execution)

Phase 1 — Community and build-in-public (first)

  • No launch-date dependency. Value-first posts: Indie Hackers, Hacker News, Reddit (r/startups, r/Entrepreneur, r/SaaS), X, LinkedIn.
  • Example: "We analyzed 50 landing pages for PMF signals—here's what we learned" with tool in comments or closing line.
  • Document: 2–3 post templates, which subreddits, "post then comment with link when relevant." See docs/social/v1.9-publishing-guide.md and related v1.9 social docs.

Phase 2 — Product Hunt

  • When MVP is stable and 10–20 supporters ready. One owner, one launch day.
  • Prepare: tagline, maker comment, 2–3 gallery screenshots. Reuse structure from v1.8 publishing guide; v1.9 PH subsection with checklist (tagline, comment, gallery, launch day replies).

Phase 3 — Content and partnerships

  • Case studies ("What PMFKit reveals about [known product]"), "Ultimate PMF Checklist" style post, accelerator/incubator outreach (free cohort access). Start after Phase 1/2 have generated usage and testimonials.

Copy and messaging (single source)

Use the same words across landing, PH, X, Reddit, LinkedIn. Single source: product-audience-voice.md. Align with decisions.md for first-run message.

AssetCopy
TaglineDiagnose your product. Decide what to build next.
Meta descriptionPaste your URL. We pull stage, distribution readiness, and one thing to do this week from your site.
First-run messageSign in to run your first analysis. 5 free per month.
Free-tier line5 free analyses per month.
Primary CTARun PMFKit
Where usedLanding (app/page.tsx), PH tagline/maker comment, X/Reddit/LinkedIn posts, pricing page.

Link this section from checklist.md and from each v1.9 social doc.


v1.9 social and launch docs

Content emphasizes: one report, evidence-backed, first-run message per decision, free tier.