CIVIX — App Store Launch Playbook

Synthesis of 5 analyses (ASO listing, creative/visuals, monetization, positioning, lifecycle). Decisions reconciled; tradeoffs flagged inline. Char counts verified against the 30/30/100 limits.

---

1. App Store Listing — FINAL copy to paste

Title (30) — Civix - US Citizenship Test (27)

Brand-anchored, with the money keyword "citizenship test" in the highest-weight field. Ship as-is — let the brand compound.

Subtitle (30) — AI Mock Interview & 2025 Prep (29)

Decision: lead with the moat. Three of the five analyses converge on differentiator-first — "AI / mock / interview / 2025" are simultaneously your unique hook, your freshness signal, and your premium upsell, all in the second-highest-weight ASO field.

• Tradeoff flagged: this drops "naturalization" from the subtitle. It is recovered in the keyword field below (do not lose it — it's the formal term lawyers/applicants search).
• Alt if you'd rather lead with the legal-search term: Naturalization Interview Prep (28).

Keywords field (100) — paste exactly, no spaces after commas

uscis,civics,naturalization,128,question,study,practice,n400,immigration,green card,citizen,exam,oath

Singular forms; nothing repeated from Title/Subtitle; "green card" left as two tokens so Apple recombines (green + card + immigration + citizen all index). ~96/100 used. Localize this field per storefront (see §4) — add ciudadanía,examen (ES), شهروندی (FA), etc.

Promotional text (170, updatable without review)

New: realtime AI voice interview — answer like the real officer is asking.
Free: 64 questions + 1 AI interview/week. No ads, no fake "guarantees."

Description

First 3 lines (the only ones shown before "more" — these convert):

Pass the 2025 U.S. citizenship test — in your language.
Study all 128 official USCIS civics questions, then rehearse with an AI interview officer that talks back and grades you instantly.
Know the day you're ready. Free to start. Works fully offline.

Full body:

Civix preps you for the CURRENT 2025 USCIS naturalization test — 128 civics questions, 20 asked at your interview, 12 right to pass. Nothing outdated, nothing you won't be asked.

🎙️ AI MOCK INTERVIEW
Practice the real thing. A voice "officer" asks the civics questions out loud — you answer by speaking or typing, and get instant feedback on every answer. The single best way to beat interview-day nerves.

📚 ALL 128 OFFICIAL QUESTIONS
The complete USCIS civics bank, kept current for 2025. Plus reading and writing practice for the full English portion of the test.

🌍 IN YOUR LANGUAGE
Explanations in English, Spanish, Farsi, Pashto, Somali, Amharic, Ukrainian, and Vietnamese. Understand WHY an answer is right — don't just memorize.

🧠 ADAPTIVE LEARNING
A smart engine focuses your time on the questions you keep missing and shows a readiness score, so you study less and remember more.

📶 FULLY OFFLINE
The entire question bank lives on your phone. Study on the bus, at work, anywhere — no signal needed.

WHO IT'S FOR
Green card holders preparing for naturalization, including the 65/20 and 55/15 exemptions. Built with immigrants and refugees in mind.

FREE TO START
64 questions in English and one AI mock interview every week, free. Go Premium for all 128 questions, every language, and unlimited AI interviews.

Premium: $9.99/month or $59.99/year (save 50%).

Your citizenship interview is too important to walk in cold. Download Civix and walk in ready.

Android short description (80) for fast-follow: Pass the 2025 USCIS citizenship test: all 128 questions + AI mock interview.

Keyword strategy in one line

Win the freshness terms (2025, 128, civics 2025) and the differentiator (mock interview, naturalization interview) cheaply now, while slowly climbing the head terms (us citizenship test, uscis) that Title/Subtitle target. The 8-language angle is a near-uncontested lane — localized keyword fields are the highest-ROI fast-follow.

---

2. Screenshots + App Preview Video

Design system (lock across all assets)

Pure zinc background (App Store light mode = default browse surface), slate-blue primary accent, gold reserved ONLY for the readiness ring / XP. Headline 64–72px bold, sub-caption 36–40px. Frameless full-bleed device, text band ~28% top. One consistent layout so the set reads as a system. Calm, dignified tone — this audience is anxious; avoid game-y/salesy styling.

Screenshots — 7-slot sequence (6.9" iPhone, 1290×2796 portrait)

Slots 1–3 are the no-scroll zone — each must independently say "this passes the real test."

#	Headline	Sub-caption	Screen
1 — HOOK	Pass the 2025 Citizenship Test	Updated for the new 128-question USCIS civics test	Home dashboard, gold readiness ring at "78% Ready", "20 asked · 12 to pass" chip
2 — MOAT	Practice with an AI USCIS Officer	Real voice mock interview — answer out loud, get instant feedback	AI voice stage: officer bubble "What is the supreme law of the land?", live waveform, transcript
3 — PROOF	Know if you'd pass — instantly	Officer scores every answer and tells you why	Post-answer feedback card: green "Correct ✓ The Constitution"
4 — IN-LANGUAGE	Explanations in your language	English · Español · فارسی · پښتو · Soomaali · አማርኛ · Українська · Tiếng Việt	Civics Q in English with explanation panel in Farsi (RTL = obviously real localization)
5 — BREADTH	All 128 questions. Smarter every day.	Adaptive engine drills what you keep missing	Category grid with progress rings + "Focus: Civics — needs review" nudge
6 — OFFLINE	Study anywhere — no internet needed	Full test bundled. Practice on the bus, at work, offline.	Single-question study view with "Offline ✓" badge
7 — CTA	Be ready on interview day	Free: 64 questions + 1 AI interview weekly. Premium: all 128 + unlimited.	Readiness ring at "100% Ready", subtle confetti, "Start free" pill

App Preview Video — 28s, in-app footage only, captions burned in (plays muted in search)

Poster frame: gold readiness ring at "78% Ready". Ship Variant A first.

00:00–03  HOOK     Ring animates 0→78%.        Overlay: "Pass the 2025 Citizenship Test"
00:03–08  PROBLEM  Scroll 128-question grid.    Overlay: "128 civics questions. 20 asked. 12 to pass."
00:08–18  DEMO     Tap AI Mock Interview → officer Q → mic waveform → transcript →
          (most time; the moat)                 green "Correct ✓ The Constitution".
                                                 Overlay: "Practice out loud with an AI officer" → "Instant feedback"
00:18–23  BREADTH  Explanation EN→ES→فارسی(RTL); "Focus: needs review"; "Offline ✓".
                                                 Overlay: "Explanations in your language · works offline"
00:23–28  RESOLVE  Ring fills to "100% Ready", confetti. Overlay: "Be ready on interview day"

Record on iPhone 16 Pro, current build, light mode. Demo account at ~78% readiness with one near-perfect interview in history so the feedback card shows a real "Correct". No logo card, no hard "Download" CTA.

3-variant plan (for Product Page Optimization): A = Outcome (above, default) · B = pure AI-interview walkthrough · C = in-language led (open on the 8-language flip; for localized storefronts).

App icon

Single bold civic mark on a solid slate-blue tile — white star (lead concept) or stylized capitol dome. Two elements max, legible at 60px. NOT a flag, NOT the Statue (category clichés that turn to mush small). Keep gold OUT (reserved for in-app XP). 1024×1024 PNG, no alpha, no rounded corners.

• A/B once live (PPO, ≥1,000 impressions/variant, 7+ days): (1) white star/blue [control] · (2) white capitol dome/blue · (3) deeper navy vs slate-blue, same mark. Metric: install conversion.

---

3. Monetization / Paywall A/B priorities

Current state (verified in code)

2 tiers, annual default ($59.99/yr "SAVE 50%" + $9.99/mo), no trial, no weekly plan. Placement is feature-gated only — the peak-value moment (end of first free AI interview) is un-monetized, and there's no social proof on the paywall (the single biggest gap).

Audience reframe that drives every decision

Goal is finite and dated — users need the app 1–3 months, pass, and leave. LTV is short and front-loaded. High-intent, high-stakes, but price-sensitive (low-income, ESL, refugee). The test is crammable in a week → naive 7-day trials invite cram-and-cancel.

Target structure

Weekly:   $7.99/wk   — "Interview this week?"          (NEW: capture + anchor)
Monthly:  $9.99/mo   — no trial, instant               (later test → $12.99)
Annual:   $59.99/yr  — 3-DAY FREE TRIAL, default       (NEW trial; "study until you pass")
          SAVE 50% • $5.00/mo billed annually

A/B tests — ranked, one element per cycle

#	Test	Hypothesis / Expected	Cycle
1	3-day free trial on annual (monthly stays no-trial)	Trial badge + risk removal lifts net paid despite some cram-cancel. +40–80% paywall→start; net paid +15–30%	1
3	Social proof above the fold — pre-reviews: "Built on the official 2025 USCIS 128-question test • 8 languages"; post-launch: "★★★★★ Join 10,000+ future citizens"	Fixes the 1/5 element. +8–15% paywall→purchase	1 (ships with #1 — different elements)
2	Add weekly tier ($7.99/wk), annual still default	Captures imminent-deadline users; anchors annual as a deal. +10–20% payer conversion, low cannibalization	2
4	Anchor format: "$5.00/mo, billed annually" vs "$0.16/day"	+5–10% annual mix	3
5	Headline: "Walk into your interview ready to pass" vs control	+3–7% paywall→CTA	3
6	Monthly → $12.99 (annual unchanged; widens SAVE to 61%)	Deadline buyers price-inelastic. Kill if monthly conversion drops >15%	4
7	CTA copy: "Start studying — Annual $59.99" / "Start 3-Day Free Trial"	+3–6%	4

Sample floors: ~6,000/variant at 5% baseline (no-trial), ~2,000/variant at 15% (trial). Use RevenueCat Experiments or Superwall (no redeploy).

Placement builds (ship in parallel, not A/B variants)

1. Paywall after the first AI interview — the highest-converting placement you don't have. "You scored 14/20. One more practice could be the difference. Premium = unlimited mock interviews until you pass." (peak-end + loss-aversion at the aha moment).
2. One skippable post-onboarding soft paywall (after language pick + first readiness score). Keep the close button.
3. Keep all existing feature gates. Do NOT add a hard onboarding wall — wrong for this audience; retention + word-of-mouth depend on a usable free tier.

Win-back — segment hard (most churned users passed and are done)

• Don't chase high-readiness / many-interview churners → trigger a referral prompt instead ("Share Civix with someone studying").
• Do win-back early/low-engagement/low-readiness churners (postponed/rescheduled). StoreKit 2 Win-Back Offers (iOS 18+), 50% off first month back; resubscribe push ladder Wk1/Wk3/Wk6, archive Wk12.

Files to edit: tiers/copy in apps/mobile/app/paywall.tsx (PRICING_TIERS, PREMIUM_FEATURES, LOCKED_ON_FREE); SKU map in apps/mobile/lib/purchases.ts (add civix_pro_weekly); post-interview trigger in apps/mobile/app/(tabs)/interview/ai-interview.tsx. Trial + win-back offers are configured in App Store Connect / RevenueCat, not code.

---

4. Category + positioning

Category: Primary Education, Secondary Reference.

• Education = bigger audience, active Apple editorial ("Learn Something New", "Back to School", seasonal civics/heritage), stronger "test prep / study / learn" search relevance. A polished 8-language voice-AI civics app is exactly their human-interest feature story. Every serious competitor lives here.
• Reference = honest second discovery surface (a real 128-question bank), thinner niche → easier secondary chart visibility.

Competitive white space: nobody owns high-quality + high-trust + multilingual + AI interview. The official USCIS app owns trust but is barebones/English-centric; the clones own volume but are ad-spammy, English-only, and some still ship the outdated 100-question test.

North-star positioning line:

The only US citizenship app that lets you rehearse the real interview out loud — with a voice AI officer — and learn in your own language.

Differentiator priority for ALL copy/creative:

1. AI voice mock interview (unique hook)
2. 8 languages / explanations in your language (the moat)
3. Current official 2025 test, 128 questions (trust vs outdated clones)
4. Adaptive readiness score (the "knows when you're ready" proof)
5. Fully offline + honest pricing, no ads

Realistic ranking read: top-100 of the citizenship/civics keyword cluster within ~6–10 weeks with the AI differentiator + good screenshots. Win the niche keyword charts first; head-of-Education is a longer game.

Keyword-gap to own (clones ignore these higher-intent terms): naturalization, n400, interview.

Cheapest defensible growth lever — localized App Store listings for FA/PS/SO/AM/UK/VI. Almost no competitor localizes the listing itself into these languages → near-zero competition on non-English citizenship keywords. Prioritize as the #1 fast-follow.

Threats to monitor: (a) official USCIS app adding audio/interview; (b) a clone bolting on a chatbot and claiming "AI interview" — pre-empt by owning "realtime voice officer," not just "AI."

---

5. Onboarding / Retention / Ratings

Activation = the one number

User answers their first 5 civics questions AND sees their Readiness Score appear. Target >50% of installs reach it in session 1. Secondary activation (D1–D3): first AI mock interview completed.

Fast-activation onboarding (<75s, 5 taps to the number — guest-first, no account, no paywall, no push prompt)

1. Language (auto-detect, confirm only) — "Explanations in your language. Questions stay in official English."
2. Test version (1 tap) — 2025 (128) / 65-20 / 55-15. Drives readiness math + pass bar.
3. Interview date (optional, framed as default) — "We'll pace your studying so you're ready in time." Powers every deadline hook. ~40% will have a date.
4. Drop straight into 5 real questions (not a menu). First question a near-guaranteed win to manufacture an early streak.
5. THE REVEAL (activation fires): "Your Readiness Score: 34%" ring filling → [Keep studying] + [Try a mock interview →].

Then, only then, the soft asks in order: (1) Save progress → Sign in with Apple ("Save your Readiness Score and streak", target 45–60%); (2) Pre-permission push screen → "We'll send one short daily review and remind you as your date gets closer. No spam — ever." (grant target >50%). Paywall NOT in onboarding — first wall is the feature gate (question #65 / 2nd weekly AI interview).

Readiness Score = the home screen

Big ring with band (Not Ready <50 → Getting There 50–79 → Interview Ready 80+); if date set, "23 days left · on track/behind"; streak chip; one CTA "Today's 15 questions". The number must move every session (even +1%) or the loop dies — surface the FSRS/IRT engine as "We resurfaced 4 questions you were forgetting."

Retention hooks

• Daily review: fixed 15 questions / ~4 min, forgetting-model prioritized. Push (default 7pm): generic / streak-aware / weak-spot variants.
• Deadline-aware push ladder (your unfair advantage): 30d → 14d → 7d ("take a full mock today") → 3d → 1d ("Tomorrow's the day 🇺🇸") → +1 day "How did your interview go?" (routes to rating logic).
• AI interview = weekly anchor: push when the free one resets ("Officer's ready — 10 minutes"); run-out seeds the upgrade.
• Streak mechanics: 1 freeze/week (immigrant/refugee schedules are unpredictable — forgiving beats punishing). Milestones at 7d / 30d / first 80%.
• Win-back (dormant 7+d): loss-framed — "Your Readiness dropped to 31% — 4 minutes brings it back up."
• Cancellation flow: "Too expensive" → monthly downgrade / "study until your interview" pause; "Already passed" → congrats + rating + referral; "Not using" → "you've mastered 38 questions, 26 to go."

Ratings — exact trigger logic

Never on cold open, after a wrong answer, or on the paywall. Pre-prompt gate → native SKStoreReviewController.

Fires on whichever success moment comes first: (1) Readiness crosses 80% for the first time; (2) passes an AI mock (≥12/20 standard, ≥6/10 exemption), ideally 2nd+ pass; (3) "I passed my real interview!" tap from the day-after push.

Eligibility (all true): sessions ≥3 · days-since-install ≥3 · activation done · hit a success moment this session · no crash this session · not prompted this version · not prompted in 30 days.

Pre-prompt survey (filters detractors, localize into all 8 langs): "Feeling more ready for your citizenship test?" → Yes fires native prompt; Not yet opens in-app feedback sheet (never the native prompt). Expected lift: +0.3–0.8★. Android fast-follow via Play In-App Review.

Review-response policy: respond to 100% of ≤3★ within 24h in the reviewer's language (HEAR framework; never defensive, never ask to change the rating). Pre-write drafts for the predictable clusters: pricing/no-trial, "questions in my language" (English-questions product rule), content accuracy ("is this the new test?"), bug/crash, mic issue, vague 1★, and "I passed!" praise. Target avg 4.6+.

Week-1 KPIs to instrument

D0 activation >50% · 5-question completion >70% · push grant >50% · D1/D7/D30 = 35%/18%/10% · daily-review completion among DAU >40% · first AI interview by D3 >35% · rating shown→submitted with prompted-cohort avg >4.5.

---

6. Checklist — DO BEFORE SUBMIT vs POST-LAUNCH

DO BEFORE SUBMIT (launch-blocking)

Listing & metadata

• Title Civix - US Citizenship Test, Subtitle AI Mock Interview & 2025 Prep, keyword field, promo text, full description — pasted into App Store Connect.
• Category: Primary Education, Secondary Reference.
• 7 screenshots (6.9") with locked design system; slot 1 = readiness ring, slot 2 = AI officer.
• App Preview Variant A (28s) uploaded; captions burned in; poster frame = gold ring.
• App icon (slate-blue + white star), 1024×1024, no alpha.
• App Privacy ("nutrition label") completed — flagged open across prior audits.

Monetization (must be correct on day one)

• IAP products live in ASC: weekly civix_pro_weekly ($7.99), monthly ($9.99), annual ($59.99) + 3-day intro offer on annual.
• RevenueCat prod entitlement check wired; REVENUECAT_SECRET_API_KEY on Vercel + iOS RC key present in EAS production env (both flagged missing in memory — verify).
• Social proof strip on paywall (pre-review variant).
• Post-first-AI-interview paywall trigger shipped.
• Free tier genuinely reachable (64 Q + 1 weekly AI interview) — prior audit found this was unreachable; re-verify on device.

Onboarding / lifecycle minimum

• 5-tap guest onboarding → Readiness reveal (activation event) instrumented.
• Rating pre-prompt gate + eligibility rules + 8-language survey.
• Daily-review + deadline push ladder scheduled; pre-permission push screen.
• Analytics events firing for all §5 week-1 KPIs.

Compliance / build hygiene

• Submit the production EAS profile build only (QA bypass hard-disabled).
• Verify EAS prod env: RC key present, TestFlight bypass secrets ABSENT.
• CI green (typecheck → web build → tests → lint → mobile data audits).

POST-LAUNCH (fast-follow, in priority order)

1. Localized App Store listings (ES first, then FA/PS/SO/AM/UK/VI) — keyword fields + screenshot captions per locale. The cheapest defensible growth lever.
2. Monetization A/B Cycle 1: Test 1 (3-day trial) + Test 3 (social proof) together → Cycle 2 weekly tier → Cycles 3–4 anchor/headline/price/CTA.
3. StoreKit 2 win-back offers (early-churn segment) + referral prompt (pass-and-leave segment).
4. App-icon PPO test (3 variants, ≥1,000 impressions each, 7+ days).
5. Preview-video Variants B & C (demo-led / in-language-led) for localized storefronts.
6. Android listing (short description ready; replicate creative + localized fields).
7. Swap social proof to real ratings ("★★★★★ Join 10,000+ future citizens") once volume supports it; run a filtered rating campaign after any release that fixes a top complaint.
8. Monitor threats: official-app feature parity; clones claiming "AI interview" — keep owning "realtime voice officer."

Single highest-leverage move

Make the Readiness Score visibly increase every session and tie the push, the streak, the deadline ladder, the paywall, and the rating prompt to that one number. It is simultaneously your activation event, retention engine, monetization trigger, and 5-star moment.

Open items to verify before go-live (from prior audits/memory)

• RevenueCat iOS key + REVENUECAT_SECRET_API_KEY on Vercel (entitlement check); ASC IAP products still pending.
• Free weekly AI interview reachability + 55/15 scoring on device.
• i18n chrome gap: many results/completion/settings strings still hardcoded English across the 8 languages — at minimum localize the rating pre-prompt survey before submit.