Monetization planning document set
Prepared 18 July 2026 · product requirements normalized from the placement artifact, current implementation status, and founder requirements
Turns the current billing implementation and the new product requirements into an execution-ready, non-code PRD package. Each document is independently shareable; the master PRD is the governing contract.
Documents
Master PRD
Product contract, rules, flows, and acceptance criteria
Team plan summary
A simple shareable explanation of Free, Plus, Pro, offers, and rollout
RevenueCat & App Store
Products, entitlements, trial, offers, paywalls, webhooks, and testing
Backend & database
Canonical access, quota ledgers, enforcement, webhook projection, and APIs
iOS paywalls
Every placement, presentation rule, offer state, gating, and resumed actions
Admin & grandfathering
Cohorts, expiring grants, bulk operations, audit, and safety
Phased rollout
Cross-team execution phases, dependencies, release gates, and checklists
iOS subscription management IPRD
Settings/Profile plan status, change, cancel, restore, pending changes, and QA
Current implementation baseline
- Dev live Backend billing contract and RevenueCat webhook projection run on the dev backend but are not merged to production.
- Upload pending iOS billing/RevenueCat implementation is merged to
develop; Beta build 0.6.1 (125) was exported but the supplied report says TestFlight upload remains. - Branch ready Admin grant console exists on
feat/billing-grants-admin, not main. - Missing Authoritative quota usage, server enforcement, automatic grandfathering, 3-day trial configuration, 50%/65% offer state, and lifecycle nudges.
Recommended reading order
- Approve the simple team summary and the assumptions in the master PRD.
- Configure App Store Connect and RevenueCat only after prices, discount duration, and rollover caps are signed off.
- Build backend/database enforcement before turning iOS gates into production restrictions.
- Finish iOS placements and offer-state behavior, then build Settings/Profile subscription management from the separate iOS IPRD.
- Release admin bulk-grandfathering before gates are enabled for legacy users.
- Follow the phased rollout checklist through sandbox, TestFlight, cohort backfill, and production ramp.