Reference: Premium Tier Specification (Companion+)

## Premium Tier Reference

**Last refreshed:** 2026-04-27
**Status:** Living reference — captures both shipped state and locked direction across pricing memo, Amicus epic #1446, and Pastor Mode plan
**Replaces:** prior reference (Apr 7, 2026 — predates Partner+, the 4-tier proposal, and Pastor Mode)

> **Convention used below:**
> - 🟢 **SHIPPED** — currently in `purchases.ts` / `SubscriptionScreen.tsx` / `UpgradePrompt.tsx` on master
> - 🟡 **PROPOSED** — locked in strategy memos, awaiting build epic
> - 🔴 **DRIFT** — inconsistency between sources of truth that needs reconciliation

---

## Source of truth files

| File | Owns |
|---|---|
| `app/src/services/purchases.ts` | Product IDs, prices, RevenueCat SDK wrapper |
| `app/src/screens/SubscriptionScreen.tsx` | The pricing UI surface (currently 19 feature entries) |
| `app/src/components/UpgradePrompt.tsx` | `FEATURE_DESCRIPTIONS` map (currently 19 keys) |
| `app/src/hooks/usePremium.ts` | Entitlement gating logic |
| `app/src/stores/premiumStore.ts` | Zustand store for premium state |

🔴 **DRIFT:** `financial-model.jsx` (the strategy artifact) still says lifetime is $99.99; `purchases.ts` says $149.99. Both should be unified into a planned `app/src/config/pricing.ts` single source of truth.

---

## Current shipped tiers 🟢

### FREE — "The Complete Study Bible"

- All 66 books, 1,189 chapters, ~62K verses (NIV + ESV; KJV planned)
- All 80 scholar panels — never gated
- All section panels: `heb`, `hist`, `cross`, `ctx`, `mac`, plus per-scholar entries
- All chapter panels: `ppl`, `trans`, `src`, `rec`, `lit`, `hebtext`, `thread`, `tx`, `debate`, `themes`
- All Explore tools at browse level: Maps, Timeline, Genealogy, People (313), Places (373), Word Studies (46), Prophecy Chains (50 overview), Concept Explorer, Difficult Passages (53), Debate Topics (308 overview)
- Unlimited notes, bookmarks, highlights
- Full-text search, FTS5 verse index
- Full offline access
- 🟡 50 Amicus queries / month (per pricing memo §08; gated to Apple FM + cached only, ~$0 cost)

### COMPANION+ — Premium tier 🟢 SHIPPED

| Field | Value |
|---|---|
| Monthly | **$4.99** (`companion_plus_monthly`) |
| Annual | **$39.99/yr · save 33%** (`companion_plus_annual`) |
| Lifetime | **$149.99** one-time (`companion_plus_lifetime`) |

**Feature inventory (from `FEATURE_DESCRIPTIONS`):**

| Feature | What it unlocks |
|---|---|
| Interlinear Hebrew & Greek | Word-level morphology, parsing, lemma |
| Concordance Search | Strong's-number search across the Bible |
| Content Library | Full text of all 269 articles |
| Cross-Reference Threading | 32 thematic threads with full passage context |
| Word Study Depth | Lexicon + semantic range + occurrence map |
| Prophecy Chain Detail | Per-link passage analysis with fulfillment notes |
| Concept Explorer Depth | Progressive revelation journey |
| Cross-Device Sync | Notes/highlights/progress sync (depends on #65) |
| Premium TTS | Natural-sounding voices with verse sync (depends on #66) |
| PDF Export | Formatted notes with scholar citations |
| Bible Periods | All 12 eras with people / books / themes |
| The Story of the Bible | 8-act redemptive narrative |
| Person Journey | Multi-book biographical arcs |
| Companion Study Partner | Spaced review queue + insight resurfacing |
| Extra-Biblical Literature | 1 Enoch, Jubilees, Apocrypha, DSS |
| Canon Comparison | Protestant / Catholic / Orthodox / Ethiopian side-by-side |
| How We Got The Bible | Canon formation + textual transmission journeys |
| Second Temple Context | NT-passage backgrounds citing 1 Enoch et al. |
| Premium Reading Plans | All 10 curated plans |

### PARTNER+ — Power-user tier 🟢 SHIPPED (Epic #1446)

| Field | Value |
|---|---|
| Monthly | **$9.99** (`companion_partner_plus_monthly`) |
| Annual | **$99.99/yr · save ~17%** (`companion_partner_plus_annual`) |

**What it adds over Companion+:**
- 1,500 Amicus queries/mo (vs 300 on Companion+)
- Sonnet-tier on every query (vs Haiku for inline / Sonnet for tab)
- Priority during peak load
- Export Amicus conversations to Markdown

---

## Proposed evolution 🟡

Locked in the pricing strategy memo (Apr 25) and Pastor Mode plan (Apr 26). Awaiting a "Pricing Strategy v2" build epic.

### Add SCHOLAR+ — Power-personal tier 🟡 PROPOSED

| Field | Value |
|---|---|
| Monthly | $14.99 |
| Annual | $149.99/yr · save ~17% |

**What it adds over Partner+:**
- Unlimited Amicus queries (soft cap 5,000/mo, abuse review beyond)
- Citation export (BibTeX, footnote)
- Beta channel access
- Priority support (24h SLA)
- Quarterly scholar Q&A invites
- White-glove onboarding session

**Strategic role:** captures the user who would otherwise add Logos Pro. Hallow is at $69.99/yr; Logos Pro at $14.99/mo. Scholar+ slots between them as a serious-personal-study ceiling.

### Add PASTOR — Vertical pastor tier 🟡 PROPOSED (with Pastor Mode build)

| Field | Value |
|---|---|
| Monthly | $24.99 |
| Annual | $249.99/yr · save ~17% |
| Verified pastor (Sheerid) | $12.50/mo · $124.99/yr |

**What it adds over Scholar+:**
- Pastor Mode unlocked (Series planner, Lesson editor, Podium Mode, PPTX export, Reflection loop, Pastoral Context Layer scaffolding — see Pastor Mode v1 plan)
- Pastor-tier Amicus quota (unlimited, no abuse review for verified pastors)
- Lesson outline generation via the generation pipeline
- Slide export (PPTX in v1; ProPresenter native in v2)

**Strategic role:** the pastoral discount makes this $12.50/mo for verified pastors — same as Companion+ price — but on a tier built for what they actually do. Pastors expense $25/mo; pastors evangelize from the pulpit; one pastor → ~12 paid downstream subscribers/year (per memo). This is the "conversion machine" tier.

### Pastor Mode beta period rules 🟡 PROPOSED

Per Pastor Mode plan decision 5 (open beta first):

- **First 60 days post-launch:** Pastor Mode available to **all premium tiers** (Companion+, Partner+, Scholar+) at no extra cost
- **After 60 days:** Pastor Mode requires Pastor tier OR Scholar+ (with stricter quotas)
- **Verified pastors:** 50% off Pastor tier via Sheerid, forever

### Convert lifetime → Founders' Lifetime 🟡 PROPOSED

Current $149.99 lifetime SKU has unlimited LTV downside as users upgrade-eligible at higher tiers indefinitely.

**Proposed:**
- Rename to "Founders' Lifetime" at **$179.99**
- Cap: **2,500 sales OR Dec 31 2026, whichever first**
- After cap: lifetime SKU retired permanently (existing buyers grandfathered)
- Includes: Companion+ tier forever, Founder badge, 50% off Partner+ / Scholar+ / Pastor upgrades forever
- Does NOT include: auto-upgrade to higher tiers (preserves upsell path)

---

## Amicus query allocations across tiers

Per Epic #1446 + pricing memo §08. Soft-gated, not hard-gated — every tier including Free gets *some* Amicus.

| Tier | Queries / mo | Routing | Est. cost / user / mo |
|---|---:|---|---:|
| Free | 50 | Apple FM + cached only | ~$0.00 |
| Companion+ | 300 | Haiku inline, Sonnet for tab | ~$0.26 |
| Partner+ | 1,500 | Sonnet on every query | ~$1.30 |
| Scholar+ 🟡 | Unlimited (soft 5K) | Sonnet, priority queue | ~$2.50 ceiling |
| Pastor 🟡 | Unlimited (no soft cap, verified) | Sonnet, priority queue, lesson-outline intent | ~$3.50 ceiling |

Cap-hit messaging follows the soft-gate pattern: "295 of 300 used" frames upgrade as expansion, not punishment.

---

## Discount programs 🟡 PROPOSED

Per pricing memo §10:

| Program | Discount | Verification | Phase |
|---|---|---|---|
| Pastoral / Ministry | 50% off Companion+ AND Pastor tier | Sheerid or ID.me | Phase 1 |
| Student / Seminary | 40% off Partner+ Annual | .edu email or Sheerid | Phase 2 |
| Family Sharing | Native Apple Family Sharing | None — Apple handles | Phase 1 |
| Gift subscriptions | Annual gifts during Advent / Lent | None | Phase 2 |
| Church / institutional | TBD | Manual/sales | Phase 3 (defer) |

---

## Free-tier philosophy (unchanged)

- **Gate tools, not content.** Every scholar, every panel, every verse is free.
- **No free trial.** The free tier sells itself — depth-driven discovery is the funnel.
- **Generous Free Amicus.** 50 queries/mo on Free is the conversion lever, not a punishment cap.

---

## Upgrade Prompt UX (unchanged from prior reference)

- Contextual, not blocking — appears where the user wants more
- Respectful — one tap dismisses, no guilt, no countdown
- Value-forward — says what you GET, not what you're missing
- Frequency limits: feature-lock tap always shows; proactive prompt max 1× per session after 3+ chapters

## Cancellation behavior (unchanged)

- Premium features revert to Free at end of billing period
- All user data persists — notes, highlights, bookmarks never deleted
- Cloud sync stops; local data remains
- Subtle "Welcome back" banner in Settings

---

## Drift items to resolve 🔴

These are concrete fixes that should land as part of any "Pricing v2" build epic:

1. **Centralize pricing config.** Create `app/src/config/pricing.ts` as single source of truth. Eliminates drift between `purchases.ts`, `SubscriptionScreen.tsx`, `UpgradePrompt.tsx`, and the strategy artifacts.
2. **`financial-model.jsx` lifetime price.** Says $99.99; actual is $149.99. Updating after Founders' Lifetime decision is even cleaner.
3. **Scholar count references.** Earlier docs said "54 scholars"; current count is **80** (per `content/meta/scholars.json`). Audit any in-app or marketing copy referencing the old number.
4. **Reading-plan gating.** Confirm the Free vs Premium split (Free gets basic, Premium unlocks all 10) matches actual reading-plan store implementation.

---

## Cost model summary (moderate scenario, post-corrections)

Per `financial-model.jsx` and pricing memo:

| Year | Users | Revenue | Cost | Profit | Margin |
|------|-------|---------|------|--------|--------|
| 1 | 1K → 100K | $127K | $2.7K | $124K | 98% |
| 2 | 100K → 240K | $290K | $27K | $263K | 91% |
| 3 | 240K → 362K | $411K | $28K | $383K | 93% |
| 4 | 362K → 475K | $460K | $28K | $432K | 94% |
| 5 | 475K → 590K | $522K | $28K | $494K | 95% |

**5-year cumulative:** ~$1.8M revenue, ~$114K cost, ~$1.7M profit
**Note:** cost model uses CloudFlare R2 hybrid (zero egress); does not yet include Pastor tier upside or Scholar+ uplift from the new ceiling tier — both are net positive.

---

## Cross-references

| Reference | What it covers |
|---|---|
| **Epic #1446** (Amicus v1) | Locked Partner+ tier definition, Amicus query architecture; functionally complete pending #1464 merge |
| **#1464** (peek-to-thread handoff re-land) | Last open Amicus child; PR #1775 in review |
| **#65** (Cross-Device Sync) | Required for Companion+ "Cross-Device Sync" feature — currently a roadmap entry |
| **#66** (Premium TTS) | Required for Companion+ "Premium TTS" feature — currently a roadmap entry |
| **#88** (Translation Licensing) | Pre-launch blocker for ESV/NLT/NASB — affects Companion+ value story |
| **Pricing strategy memo** (Apr 25 artifact) | Full 4-tier rationale, competitor analysis, Founders' Lifetime math, discount program scoping |
| **Pastor Mode v1 plan** (Apr 26 artifact) | Full architecture for the Pastor tier feature set |
| **Closed #86** | Original RevenueCat / premiumStore / UpgradePrompt / SubscriptionScreen infrastructure |


File	Owns
`app/src/services/purchases.ts`	Product IDs, prices, RevenueCat SDK wrapper
`app/src/screens/SubscriptionScreen.tsx`	The pricing UI surface (currently 19 feature entries)
`app/src/components/UpgradePrompt.tsx`	`FEATURE_DESCRIPTIONS` map (currently 19 keys)
`app/src/hooks/usePremium.ts`	Entitlement gating logic
`app/src/stores/premiumStore.ts`	Zustand store for premium state

Field	Value
Monthly	$4.99 (`companion_plus_monthly`)
Annual	$39.99/yr · save 33% (`companion_plus_annual`)
Lifetime	$149.99 one-time (`companion_plus_lifetime`)

Feature	What it unlocks
Interlinear Hebrew & Greek	Word-level morphology, parsing, lemma
Concordance Search	Strong's-number search across the Bible
Content Library	Full text of all 269 articles
Cross-Reference Threading	32 thematic threads with full passage context
Word Study Depth	Lexicon + semantic range + occurrence map
Prophecy Chain Detail	Per-link passage analysis with fulfillment notes
Concept Explorer Depth	Progressive revelation journey
Cross-Device Sync	Notes/highlights/progress sync (depends on #65)
Premium TTS	Natural-sounding voices with verse sync (depends on #66)
PDF Export	Formatted notes with scholar citations
Bible Periods	All 12 eras with people / books / themes
The Story of the Bible	8-act redemptive narrative
Person Journey	Multi-book biographical arcs
Companion Study Partner	Spaced review queue + insight resurfacing
Extra-Biblical Literature	1 Enoch, Jubilees, Apocrypha, DSS
Canon Comparison	Protestant / Catholic / Orthodox / Ethiopian side-by-side
How We Got The Bible	Canon formation + textual transmission journeys
Second Temple Context	NT-passage backgrounds citing 1 Enoch et al.
Premium Reading Plans	All 10 curated plans

Field	Value
Monthly	$9.99 (`companion_partner_plus_monthly`)
Annual	$99.99/yr · save ~17% (`companion_partner_plus_annual`)

Field	Value
Monthly	$24.99
Annual	$249.99/yr · save ~17%
Verified pastor (Sheerid)	$12.50/mo · $124.99/yr

Tier	Queries / mo	Routing	Est. cost / user / mo
Free	50	Apple FM + cached only	~$0.00
Companion+	300	Haiku inline, Sonnet for tab	~$0.26
Partner+	1,500	Sonnet on every query	~$1.30
Scholar+ 🟡	Unlimited (soft 5K)	Sonnet, priority queue	~$2.50 ceiling
Pastor 🟡	Unlimited (no soft cap, verified)	Sonnet, priority queue, lesson-outline intent	~$3.50 ceiling

Program	Discount	Verification	Phase
Pastoral / Ministry	50% off Companion+ AND Pastor tier	Sheerid or ID.me	Phase 1
Student / Seminary	40% off Partner+ Annual	.edu email or Sheerid	Phase 2
Family Sharing	Native Apple Family Sharing	None — Apple handles	Phase 1
Gift subscriptions	Annual gifts during Advent / Lent	None	Phase 2
Church / institutional	TBD	Manual/sales	Phase 3 (defer)

Year	Users	Revenue	Cost	Profit	Margin
1	1K → 100K	$127K	$2.7K	$124K	98%
2	100K → 240K	$290K	$27K	$263K	91%
3	240K → 362K	$411K	$28K	$383K	93%
4	362K → 475K	$460K	$28K	$432K	94%
5	475K → 590K	$522K	$28K	$494K	95%

Reference	What it covers
Epic #1446 (Amicus v1)	Locked Partner+ tier definition, Amicus query architecture; functionally complete pending #1464 merge
#1464 (peek-to-thread handoff re-land)	Last open Amicus child; PR #1775 in review
#65 (Cross-Device Sync)	Required for Companion+ "Cross-Device Sync" feature — currently a roadmap entry
#66 (Premium TTS)	Required for Companion+ "Premium TTS" feature — currently a roadmap entry
#88 (Translation Licensing)	Pre-launch blocker for ESV/NLT/NASB — affects Companion+ value story
Pricing strategy memo (Apr 25 artifact)	Full 4-tier rationale, competitor analysis, Founders' Lifetime math, discount program scoping
Pastor Mode v1 plan (Apr 26 artifact)	Full architecture for the Pastor tier feature set
Closed #86	Original RevenueCat / premiumStore / UpgradePrompt / SubscriptionScreen infrastructure

Reference: Premium Tier Specification (Companion+) #818

Description

Premium Tier Reference

Source of truth files

Current shipped tiers 🟢

FREE — "The Complete Study Bible"

COMPANION+ — Premium tier 🟢 SHIPPED

PARTNER+ — Power-user tier 🟢 SHIPPED (Epic #1446)

Proposed evolution 🟡

Add SCHOLAR+ — Power-personal tier 🟡 PROPOSED

Add PASTOR — Vertical pastor tier 🟡 PROPOSED (with Pastor Mode build)

Pastor Mode beta period rules 🟡 PROPOSED

Convert lifetime → Founders' Lifetime 🟡 PROPOSED

Amicus query allocations across tiers

Discount programs 🟡 PROPOSED

Free-tier philosophy (unchanged)

Upgrade Prompt UX (unchanged from prior reference)

Cancellation behavior (unchanged)

Drift items to resolve 🔴

Cost model summary (moderate scenario, post-corrections)

Cross-references

Metadata

Metadata

Assignees

Labels

Projects

Milestone

Relationships

Development

Issue actions

Reference: Premium Tier Specification (Companion+) #818

Description

Premium Tier Reference

Source of truth files

Current shipped tiers 🟢

FREE — "The Complete Study Bible"

COMPANION+ — Premium tier 🟢 SHIPPED

PARTNER+ — Power-user tier 🟢 SHIPPED (Epic #1446)

Proposed evolution 🟡

Add SCHOLAR+ — Power-personal tier 🟡 PROPOSED

Add PASTOR — Vertical pastor tier 🟡 PROPOSED (with Pastor Mode build)

Pastor Mode beta period rules 🟡 PROPOSED

Convert lifetime → Founders' Lifetime 🟡 PROPOSED

Amicus query allocations across tiers

Discount programs 🟡 PROPOSED

Free-tier philosophy (unchanged)

Upgrade Prompt UX (unchanged from prior reference)

Cancellation behavior (unchanged)

Drift items to resolve 🔴

Cost model summary (moderate scenario, post-corrections)

Cross-references

Metadata

Metadata

Assignees

Labels

Projects

Milestone

Relationships

Development

Issue actions

Reference: Premium Tier Specification (Companion+) #818

Description

Premium Tier Reference

Source of truth files

Current shipped tiers 🟢

FREE — "The Complete Study Bible"

COMPANION+ — Premium tier 🟢 SHIPPED

PARTNER+ — Power-user tier 🟢 SHIPPED (Epic #1446)

Proposed evolution 🟡

Add SCHOLAR+ — Power-personal tier 🟡 PROPOSED

Add PASTOR — Vertical pastor tier 🟡 PROPOSED (with Pastor Mode build)

Pastor Mode beta period rules 🟡 PROPOSED

Convert lifetime → Founders' Lifetime 🟡 PROPOSED

Amicus query allocations across tiers

Discount programs 🟡 PROPOSED

Free-tier philosophy (unchanged)

Upgrade Prompt UX (unchanged from prior reference)

Cancellation behavior (unchanged)

Drift items to resolve 🔴

Cost model summary (moderate scenario, post-corrections)