Documentation
Design phase 5: monetization UX
mdcraft.ai Phase 5 — Monetization Surfaces and Upgrade UX#
Objective#
Convert activated free users into paid users through value-timed upgrade moments, without harming trust or first-success speed.
Strategic alignment#
This phase follows the locked direction:
- premium markdown finishing layer
- quality-first
Markdown -> PDFexperience - honest
PDF -> Markdownbeta framing
It also aligns with the freemium model plus one public Pro plan in the foundation.
Monetization principles#
- Value before ask
- no hard paywall before a user reaches first successful export
- Contextual upsell
- upgrade prompts should appear where premium value is naturally understood
- Benefit-first copy
- explain what outcome improves, not just what feature unlocks
- Low-friction path
- upgrade CTA should not interrupt active editing flow
- Trust-safe gating
- no manipulative countdowns or dark patterns
Package architecture (design-facing)#
Free#
- limited daily studio runs
- core studio workflows
- account-backed profile defaults
- single-account focus
Pro#
$8/month- unlimited studio runs
- saved defaults across sessions
- markdown to pdf plus pdf to markdown beta
- billed monthly, cancel anytime
Enterprise later#
- keep this contact-led, not self-serve
- bring it forward only when procurement or API needs are real
Monetization surface map#
Homepage#
- pricing section with
Freeand one paidProoffer - one clear CTA to start free or upgrade
- short ROI copy: time saved + quality consistency
Workbench (primary)#
- usage messaging in the studio access surface
- upgrade prompts around free-tier limits and account state
- post-export success panel with upgrade suggestion
Pricing page/section#
- concise
FreevsProcomparison - use-case-first guidance:
- “best for individuals”
- “best for frequent professional exports”
Trigger strategy (when to ask)#
Trigger A: Usage threshold#
When free usage is nearly exhausted:
- soft warning at ~80%
- stronger prompt at limit hit
Trigger B: Billing-controlled feature intent (future iteration)#
When the product later exposes a billing-controlled capability:
- in-context lock card with immediate upgrade action
Trigger C: Post-value moment#
Immediately after a successful export:
- compact panel showing unlocked benefits with Pro
UX patterns for upgrade prompts#
Pattern 1: Inline lock card#
- location: next to locked setting
- copy: “Unlock brand-ready exports”
- actions:
Upgrade+Not now
Pattern 2: Toast/banner reminder#
- location: top-right toast or top bar
- use: approaching limits
- actions:
View plans
Pattern 3: Success-state panel#
- location: export success panel
- use: repeated exports on free plan
- actions:
Upgrade to Pro
Messaging guidelines#
Good:
- “Remove daily caps for repeat export work.”
- “Keep the studio available whenever you need it.”
Avoid:
- “You must pay now to continue.”
- “Limited-time pressure” without real basis
Paywall behavior model#
Soft gates (preferred default)#
- allow viewing controls
- block final premium action only
- show clear unlock rationale
Hard gates (use sparingly)#
- only when limit is fully exhausted
- always present clear fallback options
Plan-to-feature mapping reference#
- limited daily studio runs -> Free
- unlimited studio runs -> Pro+
- enterprise billing/procurement support -> contact-led later
- API and automation rollout -> contact-led later
Accessibility and trust requirements#
- all lock states and limits readable by screen readers
- no essential information hidden by color alone
- prompts dismissible and non-blocking during editing
Monetization KPIs#
- free -> pro conversion rate
- free -> paid upgrade click-through
- upgrade prompt view -> upgrade start rate
- export completion rate (must remain stable or improve)
- churn signals after upgrade prompt exposure
Acceptance criteria#
- Upgrade moments occur after value signals, not before.
- Users always understand why a feature is gated.
- Monetization prompts do not reduce first-export completion.
- Plan differentiation is clear and tied to outcomes.
Implementation status#
Iteration update (2026-03-10)#
- studio now surfaces a free-vs-pro access banner
- free plan messaging communicates daily run limits and Pro upgrade path
- hooks for plan-aware behavior are now present in studio UX