Skip to main content

​
Iteration Log

Use this page to keep launch work from disappearing into chat, PRs, or one-off audits.

​
2026-08-03: Business Model Change + Launch Schedule

​
Summary

Founder review of launch readiness, pricing, and timeline. The monetization model changed from freemium-with-trial to a hard paywall at full price, and a 26-week execution schedule was set with three fixed dates.

​
Decisions

  • Hard paywall, full price, no trial and no intro offer. Pro is 12.99/moor12.99/mo or 99.99/yr. Rationale: launch exists to learn whether a stranger will pay full price; a discount buys conversions and destroys that signal. Recorded as a launch experiment with a defined review date (v1.1, late November), not a permanent commitment.
  • The website is the free tier. thisiswhyimhigh.com already serves 2,525 researched strains publicly. The app does not duplicate free browsing.
  • Guest access in the app is browse-only — strain browse/search/detail, High Families, music, rate-capped label scanner. Nothing saved, no AI.
  • All personal data and all AI moves to Pro — stash, favorites, collection, manual upload, rankings, and badges re-tier from Free to Pro.
  • Data retention: 30 days for never-subscribed accounts; 12 months read-only for lapsed subscribers, so a canceling customer’s history survives as a win-back asset.
  • Historical Import is Pro-included with caps. The highiq_historical_import SKU is retired.
  • Annual is the retention strategy for a weekly-use product — pre-selected on the paywall, target mix 50%+.
  • September App Store release behind an invite gate instead of TestFlight, so friends and family install from a normal link. Not launch day; no marketing.
  • Push notifications move to v1.1 (November), with a weekly email digest covering the retention job for launch.

​
Findings

  • Notebook generation is off in production. NOTEBOOK_GENERATION_ACTIONS_ENABLED resolves false for production builds and isNotebookArtifactRouteEnabled() returns false unconditionally. Under the hard-paywall model this means a paying subscriber could not reach the feature they paid for. Now launch gate 4.
  • The notebook stack shipped. packages/notebook-engine, ten convex/notebook*.ts modules, and the notebook screens are on main. Prior docs describing PRs #1253–1259 as unmerged draft branches were stale.
  • Google gmail.readonly restricted-scope verification was untracked in every launch gate, risk register, and certification list despite gating both Gmail sync and Historical Import. Added as the longest external lead time in the plan.
  • No paywall exists as a sales surface. SubscriptionBillingScreen is a billing screen; the post-onboarding sales screen is unbuilt.
  • Apple compliance items were undocumented: paywall auto-renewal disclosures, EULA/Privacy links on the paywall, Restore Purchases on the paywall, and monthly/annual sharing one subscription group.
  • The $4.99 recommendation in docs/business/[plan]-pricing-strategy-projections-nov30.md predates the AI-first product and is superseded.
  • 46 open pull requests, mostly auto/* drafts past the 7-day staleness rule. Recommendation: triage and pause routine automations until submission.

​
Docs Updated

  • Created planning/launch-readiness/execution-plan — 26-week week-by-week plan
  • Rewrote planning/pricing/strategy — hard-paywall model of record
  • Rewrote planning/launch-readiness/overview — new gates and phases
  • Updated planning/launch-readiness/feature-matrix — new tiers and blockers

​
Next Actions

  1. App Store Connect agreements, banking, tax, Small Business Program enrollment.
  2. Determine the exact Google restricted-scope verification requirement and start whatever can start now.
  3. Re-tier the feature-flag registry to the hard-paywall model.
  4. Build the paywall as a sales surface with Apple’s required disclosures.
  5. Turn on notebook generation in production and certify runbook Phase 7.

​
2026-08-01: Comprehensive Mobile Launch-Debt Hardening

​
Summary

Completed a repository-wide Mobile consistency and resilience pass across navigation, scrolling, screen layouts, design tokens, accessibility, async actions, native privacy configuration, Safari extension state sync, and bundled assets. Existing feature surfaces were preserved while shared primitives and behavior were normalized.

​
Product and UX Improvements

  • Hardened tab retap and scroll-to-top behavior, including the Stash experience, nested scroll containers, deferred tab scenes, refresh behavior, and safe-area spacing.
  • Normalized shared layouts, headers, cards, actions, empty/loading/error states, typography, geometry, and screen transitions across the Mobile app.
  • Improved profile-photo flows and interaction labels for shared search, chat composers, and Gmail selection controls.
  • Added same-frame async action gates to notebook generation/cancellation and strain submission; added abort, timeout, stale-result, and unmount protection to suggest-strain submission.
  • Removed unused native permissions, disabled Android backup, tightened permission copy, deduplicated the iOS privacy manifest, aligned the production Expo profile, and set the installed app name to High IQ.
  • Aligned Safari App Group identifiers and serialized extension-state writes so a late authenticated write cannot overwrite sign-out clearing.
  • Removed an unused 6.9 MB mascot asset and right-sized bundled logo and splash artwork while retaining production-quality source resolution.

​
Validation Evidence

  • Mobile lint and TypeScript: pass.
  • Mobile unit: 279 files / 2,196 tests pass.
  • Convex: 42 files / 566 tests pass.
  • Mobile UI: 28 suites / 77 tests pass.
  • Safari extension: 23 tests pass.
  • Storybook lint, TypeScript, and tests: pass (2 files / 5 tests).
  • Hermes compatibility and privacy-safe diagnostics: pass.
  • Mobile design-system validation: pass at the intentional 72/72 color baseline; all other tracked raw-design categories are zero.
  • Mobile geometry validation: pass across 1,604 shipping files; no missing continuous border curves or raw z-index values.
  • Dependency audit: 98 direct dependencies, 93 source-referenced, five provider/config-only, and zero unclassified.
  • Production Expo web export: pass with 8,852 modules and 74 assets; the previous 7.2 MB unused mascot output is gone.
  • React Doctor: 272 diagnostics (46 error-level compiler findings and 226 warnings). The remaining error-level groups are primarily unsupported try/finally, deliberate effect synchronization, and test-harness mutation; broad automatic rewriting was rejected as unsafe.

​
Remaining External Certification

  • Argent and simulator/device QA were intentionally deferred at product direction.
  • Revyl validation requires a configured REVYL_API_KEY in this environment.
  • Apple Developer registration and provisioning must include group.com.highiq.app.data before Safari extension distribution.
  • RevenueCat/App Store products, purchase, restore, and webhook synchronization remain the paid-beta blocker.
  • Candidate builds still need the Gate 2–4 route, journey, permission, small/large-device, and StoreKit certification runs before readiness states can advance.

​
2026-06-03: Initial Launch Readiness Audit

​
Summary

First end-to-end launch-readiness pass across mobile routes, feature flags, testing coverage, recent PRs, Revyl/Argent status, docs, and pricing.

​
Evidence

  • Raw audit created at docs/mobile/[audit]-launch-readiness-jun03.md.
  • Local mobile typecheck passed.
  • Local mobile unit + Convex tests passed.
  • Local mobile lint passed with warnings.
  • Revyl YAML validation passed.
  • React Doctor reported 0 errors / 720 warnings.
  • Latest checked Revyl smoke workflow failed 7/8.

​
Decisions

  • Do not public-launch yet.
  • Do not start paid launch yet.
  • Move into a certification sprint for friends/family TestFlight.
  • Use one paid SKU for paid beta: Pro at 12.99/monthand12.99/month and 99.99/year.
  • Defer Studio, Founder/lifetime, Basic, AI media add-ons, and broad historical import pricing.

​
Blockers Found

  • useFeatureAccess is broken open and returns accessible unconditionally.
  • Guest/free/Pro model is not implemented consistently.
  • Onboarding is not a complete first-run route flow.
  • Revyl validates YAML but is not yet launch certification.
  • Mobile screen/integration tests under apps/mobile/test/** are excluded from normal unit tests.
  • Strain detail needs UI/device polish.
  • Gmail and historical import need beta treatment and production proof.
  • Docs/site pricing and feature promises conflict.

​
Next Actions

  1. Fix feature access and tier model.
  2. Add access decision tests.
  3. Freeze v1.0 feature flags.
  4. Build onboarding.
  5. Polish strain detail.
  6. Add route smoke tests for missing launch surfaces.
  7. Stabilize Revyl fixtures.
  8. Reconcile docs/site pricing and feature promises.

​
2026-06-04: Feature Access Gating PR Opened

​
Summary

Opened PR #806 to fix the first P0 launch-readiness blocker: feature access was broken open because useFeatureAccess always returned accessible.

​
PR

  • https://github.com/jmegan/tiwih/pull/806

​
Changes

  • Adds a pure feature-access resolver for disabled flags, login-required features, free-tier features, and Pro subscription-required features.
  • Marks signed-in free vs Pro tiers in the mobile feature flag registry.
  • Aligns label scanner as a Pro feature, matching the existing screen-level upgrade gate and AI vision cost.
  • Removes the global main-layout subscription guard that blocked signed-in non-subscribers from all main app surfaces.
  • Adds unit coverage for access decisions and tier metadata.

​
Validation

  • pnpm --filter @highiq/mobile typecheck
  • pnpm --filter @highiq/mobile test
  • pnpm --filter @highiq/mobile lint passed with existing warnings
  • pnpm test:revyl:validate

​
Remaining Work

  • Review and merge PR #806.
  • Add direct-route Revyl/Argent tests for guest, free signed-in, Pro, disabled, and lapsed states.
  • Continue feature-by-feature certification, starting with onboarding and strain detail.

​
2026-06-04: First-Run Onboarding Entry PR Opened

​
Summary

Opened PR #807 to add the smallest launch-ready onboarding path: signed-in users with no orders, stash, notebooks, or favorites get a short first-value setup instead of landing directly in the main app.

​
PR

  • https://github.com/jmegan/tiwih/pull/807

​
Changes

  • Adds a dedicated /onboarding route.
  • Routes newly signed-in and cold-launch first-time users into onboarding.
  • Points users toward the existing first-order upload path instead of adding a large wizard.
  • Lets users browse strains with completion persisted through STORAGE_KEYS.ONBOARDING_COMPLETE.
  • Updates useFirstTimeUser so anonymous users are not classified as first-time signed-in users.
  • Keeps Skip for Now temporary instead of permanently completing onboarding for empty users.

​
Validation

  • pnpm --filter @highiq/mobile typecheck
  • pnpm --filter @highiq/mobile test
  • pnpm --filter @highiq/mobile lint passed with existing warnings
  • pnpm test:revyl:validate

​
Remaining Work

  • Review and merge PR #807 after PR #806 is reviewed.
  • Add Revyl/Argent proof for sign-in -> onboarding -> log first order -> review -> save -> stash payoff.
  • Add screenshot QA for the onboarding screen on mobile viewports.

​
2026-06-04: Active i18n Test Gate PR Opened

​
Summary

Opened PR #808 to start closing the mobile test coverage gap where files under apps/mobile/test/** are excluded from the active Vitest gate.

​
PR

  • https://github.com/jmegan/tiwih/pull/808

​
Changes

  • Expands the active mobile Vitest include pattern to support src/**/*.test.tsx.
  • Adds an active i18n key audit under src/_i18n.
  • Replaces the older shell/grep callback test with a Node/Vitest scan for literal tx, labelTx, and translate() keys.

​
Validation

  • pnpm --filter @highiq/mobile test:unit
  • pnpm --filter @highiq/mobile typecheck
  • pnpm --filter @highiq/mobile test
  • pnpm --filter @highiq/mobile lint passed with existing warnings
  • pnpm test:revyl:validate

​
Remaining Work

  • Migrate or replace stale screen/integration tests under apps/mobile/test/**.
  • Add active TSX tests for onboarding, locked/pro access states, and first-order upload UI where practical.
  • Decide whether to install @testing-library/react-native or keep screen coverage in Revyl/Argent plus focused pure-view-model tests.

​
2026-06-04: Launch Route Smoke PR Opened

​
Summary

Opened PR #813 to close the missing-route-smoke definition gap in Gate 2.

​
PR

  • https://github.com/jmegan/tiwih/pull/813

​
Changes

  • Adds P0 Revyl route-smoke definitions for High Family discovery, music/now-playing, subscription billing, profile edit/preferences, analytics/stats, dispensaries, notebook daily story/video, and Professor High gated state.
  • Wires the new route smokes into nightly regression and release-gate workflows.
  • Leaves the fast pre-merge smoke workflow unchanged so routine mobile PRs do not inherit the expanded route suite yet.
  • Updates docs/testing/revyl/mobile-feature-coverage-matrix.md and docs/testing/revyl/test-catalog.md.

​
Validation

  • pnpm test:revyl:validate
  • git diff --check

​
Remaining Work

  • Run PR #813’s expanded route-smoke set against the current candidate build.
  • Add access/tier direct-route checks after PR #806 lands.
  • Add fixture contracts for deterministic new, power-with-dispensary, rich, and lapsed personas.