Claude-code-toolkit paywall-pricing-optimizer

Prerequisites

• A defined app concept (what it does, who it serves)
• Target platform (iOS, Android, or both)
• Revenue goal (hobby $1K/mo vs business $10K/mo)
• No tools required — this skill produces strategy and implementation guidance

Workflow Overview

1. Assess the App
2. Choose Monetization Model
3. Design Subscription Tiers
4. Set Pricing
5. Design the Paywall Screen
6. Plan Pricing Experiments

---

Step 1: Assess the App

Gather these inputs before making any monetization decisions:

Questions to ask:

1. What core value does the app provide? (entertainment, productivity, health, utility)
2. How often do users engage? (daily, weekly, occasionally)
3. Who is the target audience? (age, income, tech savviness)
4. What do competitors charge? (research 3-5 direct competitors)
5. Does the app have ongoing costs? (AI API calls, server infrastructure, content creation)

Usage frequency determines model viability:

Frequency	Best Models	Why
Daily	Subscription	High engagement justifies recurring cost
2-3x per week	Subscription or freemium	Moderate engagement, needs strong value
Weekly or less	One-time purchase or consumable	Hard to justify subscription
Sporadic/urgent	One-time purchase or pay-per-use	Users pay when they need it

---

Step 2: Choose Monetization Model

Decision Framework

Does the app provide ongoing, evolving value?
├── YES → Does it have significant per-use costs (AI, API)?
│   ├── YES → Freemium with consumables (credits/tokens)
│   └── NO → Subscription
└── NO → Is it a tool with finite, clear value?
    ├── YES → One-time purchase (or lifetime unlock)
    └── NO → Freemium with ads + optional ad removal

Model Deep-Dive

Subscription (~70% of top-grossing apps)

• Best for: ongoing value, content, AI features, daily-use apps
• Pros: predictable revenue, high LTV, aligns with App Store incentives
• Cons: higher churn, requires continuous value delivery
• Apple/Google take: 30% year 1, 15% year 2+ (Small Business Program)

One-Time Purchase

• Best for: utilities, tools with finite value, privacy-focused apps
• Pros: simple, no churn anxiety, easy to communicate value
• Cons: no recurring revenue, need constant new user acquisition
• Tip: offer a "Pro" unlock at $9.99-29.99 for utilities

Freemium with Consumables

• Best for: AI-heavy apps (credits/tokens), on-demand services
• Pros: pay-for-what-you-use feels fair, low barrier to start
• Cons: unpredictable revenue, complex to balance
• Pattern: give 10-20 free credits, then sell packs ($2.99/50, $9.99/200)

Ads + Ad Removal

• Best for: mass-market apps with 100K+ DAU
• Pros: monetize free users, ad removal is easy upsell
• Cons: only viable at massive scale, degrades UX
• Reality check: most indie apps never reach the DAU needed

---

Step 3: Design Subscription Tiers

Free vs Premium Split

The free tier must deliver enough value to hook users, but leave them wanting more. Apply the "taste, not feast" principle.

What goes in Free:

• Core functionality (enough to experience the value proposition)
• Limited usage (3-5 uses per day, 7-day history, basic features)
• Onboarding and setup
• Basic customization

What goes in Premium:

• Unlimited usage
• Advanced features (AI, analytics, export, sync)
• Customization and personalization
• Ad removal (if applicable)
• Priority support or early access

Tier Naming

Choose names that communicate value, not hierarchy:

Pattern	Free Tier	Paid Tier	Best For
Status-based	Basic	Pro	Productivity tools
Capability-based	Starter	Unlimited	Usage-limited apps
Experience-based	Free	Premium	Content/media apps
Playful	Explorer	Champion	Gamified/wellness

Avoid: "Lite" (implies inferior), numbered tiers (confusing), more than 2 tiers for indie apps (3+ tiers create decision paralysis).

Two-Tier vs Three-Tier

Two tiers (recommended for most indie apps):

• Free + Premium
• Simple, clear upgrade path
• One decision: upgrade or not

Three tiers (only if justified):

• Free + Standard + Pro
• Use the decoy effect: make Standard the obvious choice
• Only viable if you have meaningfully different feature sets for each

---

Step 4: Set Pricing

Pricing Benchmarks by Category (2025)

App Type	Monthly	Annual	One-Time
Simple utility	$2.99-4.99	$19.99-29.99	$4.99-9.99
Habit/tracker	$4.99-6.99	$29.99-44.99	$9.99-14.99
Productivity	$5.99-9.99	$39.99-59.99	$14.99-29.99
Health/fitness	$6.99-12.99	$39.99-79.99	-
AI-powered tool	$9.99-19.99	$59.99-99.99	-
Education/learning	$6.99-14.99	$49.99-99.99	-
Creative tool	$4.99-9.99	$29.99-59.99	$14.99-29.99

Pricing Sweet Spots

Tier	Monthly	Annual	Best For
Impulse buy	$2.99-4.99/mo	$19.99-29.99/yr	Simple utilities
Standard	$5.99-6.99/mo	$34.99-44.99/yr	Most indie apps
Premium	$9.99-14.99/mo	$59.99-99.99/yr	AI-heavy or professional

Pricing Psychology Rules

1. Anchor with annual pricing — show annual plan first, display the per-month equivalent, cross out the monthly price to show savings
2. Use odd pricing — $6.99 not $7.00, $49.99 not $50.00
3. Show savings percentage — "Save 40%" on annual plan
4. Three-tier decoy — if offering 3 options, make the middle tier the obvious best value (price it closer to the cheap option, feature-set closer to the expensive one)
5. Pre-select the best-value plan — highlight and pre-select the annual plan

Free Trial Strategy

Length	Best For	Conversion Impact
3 days	Apps with immediate value	Higher conversion, lower trial starts
7 days	Standard choice for most apps	Balanced conversion and adoption
14 days	Apps requiring habit formation	Higher trial starts, lower conversion
30 days	B2B or complex tools	Very low conversion, use sparingly

Introductory offers:

• 50% off first month or first year
• Extended free trial (14 days instead of 7)
• Seasonal promotions (New Year, back to school)

---

Step 5: Design the Paywall Screen

Hard vs Soft Paywall

Hard paywall (before any use):

• Only for apps with strong brand recognition or no free alternative
• Very few indie apps should use this
• Risk: 90%+ of users bounce immediately

Soft paywall (after value demonstration):

• Show the paywall after the user has experienced value
• Best triggers for showing the paywall:
  • After 3-5 uses of the core feature
  • After completing onboarding
  • After hitting a usage limit ("You've used 3 of 3 free scans today")
  • After achieving a milestone ("Great progress! Unlock unlimited tracking")
  • On attempting a premium feature (contextual upgrade prompt)

Paywall Screen Anatomy

Design the paywall screen with these sections in order:

1. Hero Section

• Benefit-focused headline (NOT feature-focused)
• Bad: "Unlock Premium Features"
• Good: "Track Every Habit, Crush Every Goal"
• Good: "Never Lose a Thought Again"
• Subheadline reinforcing the outcome

2. Feature/Benefit List

• 3-5 items maximum (more causes decision fatigue)
• Use checkmarks or icons
• Frame as benefits, not features:
  • Bad: "Unlimited storage"
  • Good: "Save everything, forget nothing"
• Optional: side-by-side Free vs Premium comparison

3. Social Proof

• Star rating with review count ("4.8 stars from 12,000 reviews")
• Testimonial quote from a real review
• User count ("Join 50,000+ users")
• Press mentions or awards

4. Pricing Cards

• Show annual plan first (left or top position)
• Highlight annual as "Best Value" or "Most Popular"
• Show per-month equivalent for annual plan
• Show savings: "Save 40%" or cross out monthly equivalent
• Pre-select the annual plan

5. Call-to-Action

• Action-oriented text:
  • Good: "Start Free Trial", "Try 7 Days Free", "Unlock Everything"
  • Bad: "Subscribe", "Buy", "Purchase"
• Make the button large, high-contrast, and unmissable
• Below CTA: "Cancel anytime" or "No commitment"

6. Trust Signals

• "Cancel anytime" (most important — always include)
• "No commitment"
• "Secured by Apple" / "Secured by Google Play"
• "Restore purchases" link
• Privacy policy link

See references/paywall-copy-formulas.md for headline templates, CTA variations, and feature list copy patterns.

Common Paywall Mistakes

1. Too many plan options — 2 is ideal, 3 max. Never 4+.
2. Feature-focused copy — users buy outcomes, not features.
3. No free trial — always offer a trial for subscriptions.
4. Paywall too early — show value before asking for money.
5. Weak CTA — "Subscribe" converts far worse than "Start Free Trial".
6. No social proof — testimonials and ratings build trust.
7. Missing "Cancel anytime" — this single line lifts conversion 10-15%.
8. No price anchoring — always show what the user saves.
9. Ugly design — the paywall is a product page; invest in its design.
10. Same paywall everywhere — contextualize based on what triggered it.

---

Step 6: Plan Pricing Experiments

Before committing to a pricing strategy, plan what to test.

See references/pricing-experiments.md for detailed A/B testing methodology, sample size calculators, and experiment prioritization.

What to Test First (Priority Order)

1. Free trial length (3 vs 7 vs 14 days) — biggest lever
2. Paywall timing (after onboarding vs after 3 uses vs on premium feature)
3. Annual vs monthly default (which is pre-selected)
4. Headline copy (benefit A vs benefit B)
5. Price point ($4.99 vs $6.99 vs $9.99)
6. Social proof (with vs without)

Key Metrics to Track

Metric	Formula	Target
Trial start rate	Trials / paywall views	15-30%
Trial-to-paid conversion	Paid / trial starts	40-60%
Paywall conversion rate	Purchases / paywall views	5-15%
ARPU (avg revenue/user)	Total revenue / total users	Varies
LTV (lifetime value)	ARPU * avg subscription length	> 3x CAC
Monthly churn rate	Cancellations / active subscribers	< 10%

---

RevenueCat / StoreKit / Google Billing Integration

RevenueCat (Recommended for Indie Devs)

RevenueCat abstracts StoreKit and Google Billing into a single SDK. Free up to $2,500/mo MTR.

Setup pattern:

1. Create a RevenueCat project and add App Store / Google Play apps
2. Configure products in App Store Connect / Google Play Console
3. Configure offerings and entitlements in RevenueCat dashboard
4. Install SDK:

   expo install react-native-purchases

5. Initialize on app launch with API key
6. Fetch offerings to display on paywall
7. Make purchase and check entitlement status
8. Handle restore purchases

Key concepts:

• Product — the SKU in App Store Connect / Google Play Console
• Entitlement — what the user unlocks (e.g., "premium")
• Offering — a group of packages shown on the paywall (allows remote config)
• Package — a product within an offering (e.g., monthly, annual)

StoreKit 2 (iOS Native)

Use StoreKit 2 for Swift/SwiftUI apps without RevenueCat:

• Product.products(for:)

  to fetch products

• product.purchase()

  to initiate purchase

• Transaction.currentEntitlements

  to check active subscriptions

• Transaction.updates

  to listen for transaction changes
• Handle

  Transaction.unverified

  cases

Google Play Billing Library (Android Native)

Use Billing Library 6+ for Kotlin/Java apps:

• BillingClient.queryProductDetailsAsync()

  to fetch products

• BillingClient.launchBillingFlow()

  to initiate purchase

• BillingClient.queryPurchasesAsync()

  to check active subscriptions
• Acknowledge purchases within 3 days or they auto-refund

Cross-Platform (Expo / React Native)

For Expo apps, RevenueCat is the standard approach:

• expo install react-native-purchases

• Configure

  app.json

  with

  eas.build

  for native module support
• Test with sandbox accounts on both platforms
• Use

  expo-dev-client

  for development builds (Expo Go does not support IAP)

---

Output Deliverables

At the end of this workflow, deliver:

1. Monetization model recommendation with reasoning
2. Tier structure — what is free vs premium
3. Pricing recommendation — monthly, annual, and any introductory offers
4. Paywall screen spec — layout, copy, and design direction
5. Experiment plan — first 3 tests to run, ordered by impact
6. Integration guidance — RevenueCat/StoreKit/Billing setup steps