Product Evolution

Release History

Tracking ReFinEd's evolution from launch through each major feature release. Every version represents what we learned from real usage and how we responded to make financial education more accessible, measurable, and effective.

v1.6.4

Scenario Library Completion & No-Stub ClosureCurrent

May 13, 2026

What Changed

  • Completed the shipped scenario library so visible scenario content is playable rather than design-drafted
  • Chapter 3-6 applied scenarios now include playable decision prompts, options, and outcomes
  • Historical casefiles H02-H06 now include playable multi-turn decision paths
  • Product-visible stub scenario states removed from the app's shipped scenario grammar
  • Scenario validation strengthened so old stub status is rejected before release

Why It Mattered

v1.6.4 closes the gap between ReFinEd's scenario architecture and its shipped content library. Lessons teach the concept, quizzes test it, and scenarios now apply it through playable decision experiences instead of catalog-visible drafts.

v1.6.2

Expert Chat Clarity & Reward Integrity

May 9, 2026

What Changed

  • Expert Chat now hydrates recent local session messages so the AI does not rely on invisible prior context
  • New Chat behavior lets users start fresh without carrying prior local session turns into the prompt
  • AI backend wake messaging now explains when the Hugging Face service is starting up instead of leaving users with a silent spinner
  • PWA/web reward accounting fixed: lesson and quiz completion XP now awards once per completed action
  • Regression coverage added for chat session visibility, backend wake copy, and exact reward totals

Why It Mattered

v1.6.2 makes ReFinEd's internal state match the user's reality. The chat sees what the user can see, and XP reflects the action actually completed instead of duplicated web fallback rewards.

v1.6.1

Android Shell & Subscription Reliability

May 8, 2026

What Changed

  • Android top-band fix: native splash, titlebar, and edge-to-edge handoff cleaned up for the Google Play app
  • Google sign-in and RevenueCat identity sequencing hardened so subscription portability waits for the right account state
  • Restore Purchases now requires a linked Google identity, matching the purchase flow
  • SQLite additive migrations made idempotent, removing duplicate-column startup noise
  • Android ADB smoke-test tooling added for physical-device screenshots, UIAutomator checks, and logcat evidence

Why It Mattered

v1.6.1 stabilized the Android shell and billing identity path after the v1.6 scenario/directive launch, making the app safer to ship across Google Play and PWA surfaces.

v1.6.0

Scenario Architecture & Active Directives

April 23, 2026

What Changed

  • Scenarios pillar launched: new /scenarios tab with Applied and Historical libraries, shared card system, locked/playable/tease states, and dedicated detail pages
  • Applied Scenarios are real: chapter-based decision cases now form the post-lesson bridge between theory and judgment, with real completion telemetry and XP/streak consequences
  • Historical Scenarios are real: H01 (COVID crash and recovery) is now a genuine multi-turn replay with remembered choices, terminal outcome handling, and a decision timeline debrief
  • Active Directives now exist on the Dashboard: daily, weekly, and monthly market-weather challenges render with real cadence windows, urgency, and engagement tracking
  • Progression Router landed: passing a quiz can now dispatch the learner directly into the next eligible chapter scenario instead of dumping them back to the dashboard
  • Analytics and local telemetry expanded: scenario starts, option choices, historical turn advances, historical outcomes, and directive engagement now leave a real behavioral trail
  • v1.6 content pack seeded: 17 Applied scenarios, 6 Historical casefiles, and 8 event templates authored into the app's content substrate

Why It Mattered

v1.6 is the release where ReFinEd stops being only a curriculum-and-portfolio app and becomes a living decision environment. Lessons now lead into action, action leaves a behavioral record, and the app can finally distinguish between reading market concepts and exercising judgment under pressure.

v1.5.2

Onboarding, Sell Flow & Icon Polish

April 22, 2026

What Changed

  • Cold open onboarding: 5-page questionnaire on first launch captures experience level, learning goal, and daily time commitment — personalizes the lesson path before the first lesson starts
  • Holdings sell flow: Holdings page rebuilt with action table — tap any holding to open a Buy/Sell sheet without navigating to Market
  • Founder badge & lifetime offer: one-time purchase unlocks Pro for life, grants $1M simulated starting capital, and awards the exclusive Founder badge (custom art, legacy tier)
  • In-app release notes: master-detail changelog viewer with full version history, appears after each update
  • Trade ledger: every buy/sell recorded to portfolio_trades table with timestamp for future analytics
  • App icon fixed: all Android mipmap sizes regenerated (80% fill, proper adaptive icon safe zone); browser favicon replaced — was still showing the Firebase scaffold default
  • 292/292 tests

Why It Mattered

Three friction points that real users hit: no way to sell from Holdings, no personalized starting experience, and the app icon not matching across surfaces. v1.5.2 closes all three. The Founder offer also formalizes the lifetime access tier that was already live in RevenueCat.

v1.5.1

Lesson Interactions & Curriculum Restructure

April 19, 2026

What Changed

  • EnhancedMarkdown hub: modular callout rendering replaces raw markdown in all lesson views
  • Deep Dive modals: 📊 sections expand into full overlay with advanced analysis
  • Real Money Tip panels: 💰 collapsible panels with practical financial context
  • Glossary tooltips: financial terms underlined inline with first-occurrence detection — 15 curated terms at launch
  • Chapter navigation: ChapterCard grid + per-chapter drill-down replaces flat 20-card lesson list
  • 6-chapter curriculum (2,3,3,3,4,5 pacing): Foundations / Core Concepts / Market Forces / Trading Mechanics / Valuation / Institutional
  • Badge taxonomy update: 'Professional' badge renamed to 'Institutional' — 5 honest difficulty levels (Expert retired)
  • Chapter-based gating: getLessonStatus now uses chapter metadata instead of hardcoded index >= 10
  • Lesson file structure reorg: free/ + pro/ folders eliminated, replaced with ch01-foundations/ through ch06-institutional/
  • Google Play Console transferred to Thoth Systems developer account; RevenueCat RTDN via Pub/Sub confirmed live
  • 292/292 tests passing

Why It Mattered

Lessons became interactive rather than passive. The curriculum restructure also corrected a technical debt — lesson difficulty labels and file locations now reflect actual pedagogical position, not arbitrary free/pro tier assignment. The badge rename from 'Professional' to 'Institutional' reflects honest progression: institutional-grade thinking is the actual capstone, not a credential tier.

v1.5.0

Gamification + Analytics + Academic Transcript

April 8, 2026

What Changed

  • XP and streak system: earn points per lesson/quiz, build 3/7/30-day streaks with timezone-aware day-boundary logic
  • 20 achievement badges wired: milestone (Scholar, Analyst, Professional — later renamed Institutional in v1.5.1), performance (Sharpshooter, Hat Trick), and engagement badges (Streak Starter, Unstoppable, Compounding Master)
  • Badge pop notifications: instant on-screen toast with custom sound when earned
  • Academic Transcript: full course record with letter grades (A–F), pass rates, per-question correctness, and expandable study review
  • Per-question quiz results: track right/wrong per question, sent to analytics for aggregate learning insights
  • Sound system redesign: 30 semantic MP3s (low→high for correct, high→low for incorrect) with proper ADSR envelopes
  • Analytics infrastructure: D1 event tracking (lesson_started, lesson_completed, quiz_submitted, badge_awarded, streak_updated, streak_broken)
  • 291 comprehensive tests including anti-exploit coverage (hat trick deduplication, variable quiz length handling, streak reset logic)

Why It Mattered

This release made ReFinEd's progression system real and measurable. Students now see verifiable proof of their learning through grades, badges, and streaks. The per-question analytics enable us to understand where students struggle and iterate curriculum accordingly.

v1.4.7

Performance & Accessibility Optimization

March 30, 2026

What Changed

  • Mobile Lighthouse: 76 → 91 (+15 points), LCP halved (6.6s → 3.1s), TBT -80% (100ms → 20ms)
  • RevenueCat deferred: billing SDK removed from app boot path, only loads on billing screen
  • Accessibility: 100/100 score achieved — heading order, footer contrast, icon button labels
  • Mobile footer fixed: resolved viewport issues on small screens and address bar show/hide

Why It Mattered

Made ReFinEd fast and accessible for all users, meeting WCAG standards and ensuring the app loads quickly even on slow networks.

v1.4.6

Firebase Removal & PWA Launch

March 29, 2026

What Changed

  • Web PWA launched at refined.intotheeye.work (Cloudflare Pages) — first web deployment since migrating off Firebase Hosting
  • Firebase completely removed: eliminated ~479 dead dependencies, Firebase package, and legacy auth/data services
  • HuggingFace FastAPI confirmed as sole AI and market data backend (kode-animator-refined-backend.hf.space)
  • Google Sign-In migrated to @capgo/capacitor-social-login — stable on Android
  • Self-hosted fonts: Google Fonts chain replaced with next/font (eliminated ~750ms render-blocking delay)
  • Mobile performance: 53 → 76, FCP: 6.7s → 0.9s
  • Privacy policy and terms of service rewritten to reflect actual tech stack (no Firebase references)
  • RevenueCat web billing (purchases-js) integrated alongside Android native billing

Why It Mattered

Completed the full migration to a self-contained architecture: local SQLite identity, Cloudflare for hosting/CDN/analytics, HuggingFace for AI, RevenueCat for subscriptions. Nothing left from the original Firebase stack. This cleanup is what made the v1.5 gamification layer possible.

v1.4.5

RevenueCat Billing Integration

February 23, 2026

What Changed

  • RevenueCat native Google Play Billing UI — production-grade subscription management
  • Pro access entitlement gating: lessons 11–20 locked behind active subscription check
  • Android deployment scripts inject -i com.android.vending for sandbox billing testing
  • Google Sign-In integrated for secure authentication with cross-device recognition

Why It Mattered

Established the subscription model and billing infrastructure that funds continued development. RevenueCat handles all billing complexity across Android and web from a single entitlement check.

v1.4.1 – 1.4.3

Stability Patches

February 19–20, 2026

What Changed

  • Three rapid patch releases (build 19, 21, 23) addressing stability issues discovered after the v1.4 portfolio overhaul
  • Auth flow stability improvements before RevenueCat billing integration
  • Build configuration corrections for consistent Android release signing

Why It Mattered

Small but necessary stabilization work between the v1.4 feature push and the v1.4.5 billing integration.

v1.4.0

Quest System & Portfolio Overhaul

January 22, 2026

What Changed

  • Quest-based onboarding: 6-stage guided narrative flow for new users (quest_stage 0–6 in SQLite)
  • Market Command page (/portfolio/market): Featured Top Movers, category sections (Big Tech, etc.), A-Z universe browse, ticker search, live ticker tape
  • Performance/Risk HUD (/portfolio/performance): You vs. Market benchmark chart (1M/3M/1Y), Coach Insight AI commentary, Risk Check panel (Alpha, Beta, Volatility, Max Drawdown)
  • Portfolio holdings, wallet, and trade execution pages rebuilt
  • API client wired to HuggingFace backend for all market data and AI chat
  • SVG badge frames added; legacy images moved to Cloudflare R2 CDN

Why It Mattered

Structured user progression from signup through first lesson to first trade. The Market Command and Performance/Risk HUD connected the learning side of the app to actual market data for the first time, making the portfolio simulator feel real rather than academic.

v1.3.4

Android Resurrection

December 3, 2025

What Changed

  • Ghost ID Authentication: local-first identity system that bypasses Firebase Auth restrictions on Android
  • SQLite schema migration fix: resolved 'duplicate column' errors with robust migration scripts
  • One-click build loop via debug-android.ps1
  • Node.js heap increased to 4GB (prevents out-of-memory errors during production build)
  • Safe area handling for camera notch on Android devices
  • Settings navigation fixed and asset fallbacks added for broken avatar images

Why It Mattered

Firebase Auth was creating auth loops on Android that blocked users from entering the app. Ghost ID — a local SQLite-based identity — solved this permanently and became the foundation for ReFinEd's local-first architecture going forward.

v1.3.3

Identity Schema Fix

December 2, 2025

What Changed

  • SQLite users table updated with missing profile columns (display_name, email, etc.)
  • ALTER TABLE migration scripts added for users already on older schema versions
  • Error logging added to initIdentity and updateProfile for easier debugging

Why It Mattered

Prevented user profile data from silently failing to save on Android after the v1.3 launch.

v1.3.2

Auth Preflight & Stability

December 2, 2025

What Changed

  • Preflight auth check script added (scripts/preflight-auth.ts)
  • AuthContext updated with refreshUser for post-login state sync
  • LoginPage routing fixed: refreshUser + router.push instead of stale redirect

Why It Mattered

Addressed auth state sync issues that caused users to land on blank screens after sign-in on Android.

v1.3.1

Android Auth Loop Hotfix

December 1, 2025

What Changed

  • Static export re-enabled for Capacitor compatibility
  • Client-side AuthGuard implemented to prevent redirect loops
  • localStorage session persistence added to survive app backgrounding
  • Home button reverted to standard style

Why It Mattered

v1.3 shipped with an auth loop that prevented many Android users from getting past the login screen. Hotfixed same night.

v1.3.0

The Identity & Mastery Update

December 1, 2025

What Changed

  • Account page: profile, learning history, settings, achievements
  • 5-tier badge rarity system: Bronze (common) through Mythic (rare)
  • Lore badges: The Eye, Golden Eye, Into The Eye — narrative achievements tied to the brand story
  • Achievement tab: public badge gallery with SVG frames and descriptions

Why It Mattered

Introduced the concept of persistent identity and achievement visibility. Set the stage for making badges actually meaningful with real tracking in v1.5.

v1.2.0

Android Build & Deployment Automation

December 1, 2025

What Changed

  • Android app configured: Capacitor integration, Google Play build pipeline
  • Deployment automation: Cloud Build + cloudbuild.yaml for CI/CD
  • Documentation: deployment checklist, guardrails, quick reference guides

Why It Mattered

Made ReFinEd deployable to both web and Android from a single codebase. Automated deployment pipeline enabled rapid iteration.

v1.1.0

Mobile Launch & AI Upgrade

November 28, 2025

What Changed

  • Native Android APK/AAB built, signed, and published to Google Play Store
  • AI Expert Chat upgraded: 5 tools (lesson topics, lesson content, search, stock education, lesson recommendation)
  • Multi-turn conversation memory: AI remembers session context across questions
  • Anti-hallucination safeguards: explicit lesson list injected into system prompt
  • SQLite chat history persistence: conversations survive app restart
  • Express AI server on port 3400, tunneled via Cloudflare to api.pantheonladderworks.net
  • 155 tests passing across 7 suites

Why It Mattered

Put ReFinEd in users' hands for the first time as a real Android app. The AI upgrade made the Expert Chat genuinely useful — it could now look up specific lessons and give investment advice grounded in the actual curriculum rather than hallucinated general knowledge.

v1.0.0

Initial Launch — Investor Prep → ReFinEd

October 9, 2025

What Changed

  • Android APK and web app launched simultaneously — built Android-first from inception
  • Rebranded from 'Investor Prep' (working title, July 2025) to ReFinEd at launch
  • 20-lesson curriculum: 10 free (Beginner → Advanced) + 10 Pro tier built from 533KB of original research synthesized Oct 5–6
  • Quiz system with per-question feedback and explanations
  • Portfolio simulator: basic buy/sell with paper trading
  • AI Expert Chat powered by 'The Investor Gem' (Genkit/Firebase backend — migrated to HuggingFace in v1.4.6)
  • Google Authentication via Firebase Auth (migrated to @capgo/capacitor-social-login in v1.4.6)
  • Tech at launch: Next.js 15 static export, Firebase Auth + Firestore, Genkit AI (Express server), Cloudflare Tunnel for mobile API access

Why It Mattered

The app had been in design since July 2025 under the 'Investor Prep' name, with ACE (Gemini) co-authoring the original spec. The curriculum research — 8 documents, ~80,000 words — was synthesized in a 48-hour window before the first commit. Launch proved the concept: financial education on both web and Android from a single codebase, with AI grounded in the actual curriculum rather than general knowledge.

Origin

Investor Prep — Concept Phase

July 2025 — three months before the first line of code

How It Started

  • Working title: 'Investor Prep' — a financial literacy engine for absolute beginners, designed to teach before allowing trades
  • Core premise: most investment apps give users a way to spend money without the knowledge to use it properly. Investor Prep made education the product, not a feature
  • Co-designed by Kryssie and Nick with ACE (Gemini) as architectural collaborator — full application spec written July 5, 2025
  • Design philosophy established: calm and confidence-inspiring, never casino-like; the UI should feel like a library, not a ticker tape
  • 8 research documents synthesized in the 48 hours before the first commit — ~80,000 words covering fixed income, derivatives, behavioral finance, portfolio theory, macroeconomics, ethics, and equity valuation
  • Rebranded to ReFinEd at launch, October 9, 2025

Why It Matters

ReFinEd wasn't slapped together. The architecture, the pedagogy, and the monetization model were all worked out on paper before a single component was written. Every version since has been building toward the same vision that was sketched in July 2025.

Building toward measurable learning at scale.

What's Coming Next

v1.7 turns that new behavioral trail into governed adaptation. The AI Learning Steward is planned as an observer, not a chaos goblin: it will read the full state produced by v1.6 — quiz performance, scenario outcomes, directive engagement, badges, streaks, and completion history — and select a single typed intervention that actually fits the learner's recent behavior. The point is not to nag harder. The point is to respond with memory, judgment, and restraint.

Explore ReFinEd Today