Smarter Planning & Better Analytics
We rebuilt Claritii’s engine to make everything faster, smarter, and more consistent. Every demo you see on the landing page now matches the real app exactly — because they share the same code. Your analytics update in real time, your roadmap adapts as you learn, and study demos finally show you exactly what you’ll get when you sign up.
New Features
- A single shared /core module that drives both the production app and every landing page demo, making analytics calculations instant and eliminating UI-side computation entirely.
- The AI Diagram Generator demo now shows both SVG rendering for simple diagrams (plant cells, circuits) and AI-powered generation for complex ones (human circulatory system, DNA replication), so you understand exactly how each works before signing up.
- The Difficulty Priority Heatmap appears right on your dashboard with real data, colour-coding topics from critical to mastered so you know where to focus.
Improvements
- Study technique demos (Blurting, Active Recall, Feynman) now auto-fill with example writing so you can see how each method works before creating your own sessions. The typing animation walks you through a real study scenario step by step.
- Roadmap sessions stay visible for longer, and content you’ve already generated won’t disappear. We fixed the underlying data model so your study plan persists reliably.
- You can now set exact time blocks for each study session and your roadmap respects them. Tell us you’re free from 3–5pm and 7–8pm, and we’ll build your plan around those slots.
- Every landing page demo now uses the same components and logic as the real app. What you see on the marketing site is exactly what you’ll get after signup — no mockups, no illusions.
- Mind maps are cleaner with better visual hierarchy, bullet-pointed details in each expanded node, and consistent spacing across every branch.
- Squad leaderboards now have a Friends tab so you can compare study time with your actual mates, not just the global leaderboard. Data is unified across all three tabs with consistent animations.
- The diagram decision engine has been centralised: SVG is used for simple diagrams, AI for complex ones. Each state is now explicitly labelled so you know exactly what’s happening at every step.
- Study methods in the carousel are now standardised to the three proven techniques: Feynman, Blurting, and Active Recall. No more confusion about which techniques are available.
- Assessment progress tracking now shows session completion indicators so you can see at a glance how close you are to finishing each assessment’s study plan.
Fixes
- Subject categorisation no longer duplicated across the codebase — a single categoriseSubject() function in /core handles every subject in one place.
- IntersectionObserver logic extracted to a shared hook, removing per-component copy-paste implementations and making scroll-based animations consistent.
- The service worker now properly clears its cache on every deploy, so you’ll never see stale asset errors or broken page loads after an update.
- Sonner toast notifications are rendered client-side only, eliminating a React hydration mismatch that caused console errors on first load.
- Roadmap hover effects now match the rest of the app, using consistent animation curves and durations.
- Email verification is now required before you can access the app, giving you better account security from day one.
- The completion celebration now only triggers when every session for an assessment is actually finished — no false confetti.
Why We Built This
Before v2.5, the Claritii codebase had grown organically across many routes and components. Business logic was duplicated in multiple places. Demos and the real app used different implementations of the same features, which meant they inevitably fell out of sync. Adding a new feature to the demo didn’t mean it worked in the app, and fixing a bug in the app didn’t update the demo.
We took a step back and asked a simple question: what if all the core logic lived in one place? The answer was the /core layer — a set of shared TypeScript modules that both the production app and the landing page demos import and use directly. This single source of truth means analytics calculations, diagram decisions, mindmap structures, and study method rules are all defined once and reused everywhere.
The result is a codebase that’s dramatically easier to maintain and faster to ship improvements to. Analytics recalculate instantly without UI-side computation. Demos match the real app pixel-for-pixel. And when we fix a bug in one place, it’s fixed everywhere. For you, this means a more reliable app that improves faster — every release from here on out benefits from this foundation.
The Complete v2.5 Journey
v2.5 was our most ambitious release cycle yet, spanning 12 sub-releases from v2.5.0 through v2.5.12. Here's how it came together.
v2.5.0 kicked things off with the Feynman Technique overhaul — transforming it from a simple explainer into a full 4-step 'teach a beginner' workflow. We also shipped mind mapping as a fourth study technique, country-specific Squad leaderboards with seasonal tiers (Bronze through Legend), and auto-carousel landing page demos with typing animations. Diagrams defaulted to SVG generation, with an AI path added for complex visuals.
v2.5.1 cleaned up encoding issues across the app, merged the assessment upload into a single unified card, and gave Active Recall a structured 3-attempt retry loop with attempt tracking and a gap review panel. The updates page was reorganised into version-range sections for easier browsing.
v2.5.2 was our stability and reliability push — improved sign-in, more resilient AI generation, push notification preferences, mobile Squad tab, smoother footer links, and better crash protection. We also removed 'Coming Soon' items that had already shipped.
v2.5.3 brought the custom domain (getclaritii.com), updated all sitemap URLs and SEO metadata, and fixed garbled encoding characters in several places. This was also when we standardised the changelog format.
v2.5.4 refreshed the landing page demos: the AI Diagram demo showed both SVG and AI paths, Squad gained a Friends leaderboard tab, and the roadmap demo's visual quality improved significantly. We also added entrance animations to leaderboard entries and feed items.
v2.5.5 overhauled the roadmap system with specific scheduling mode (exact time blocks), curved connector lines between date groups, and content generation rotation expanded to 20-28 patterns per urgency band. The landing page roadmap demo now used the same component as production with identical visuals.
v2.5.6 added the Difficulty Priority Heatmap to the dashboard with real data, assessment progress tracking with session completion indicators, and nine performance improvements including deterministic duration jitter, ordering for schedule blocks by ID, deduplication checks on assessment IDs, and useMemo memoisation.
v2.5.7 was our production reliability pass. We built a full background job system with enqueue, retry with exponential backoff (1min to 1hr), max retry cap, and failure tracking. Cron routes process pending jobs daily and weekly, stuck jobs are auto-detected and retried after 30 minutes, and content generation is idempotent with graceful fallback to on-demand when the queue is unavailable.
v2.5.8 introduced study techniques to the landing page with typing effects and step-by-step navigation. The demos were redesigned to show real-life feature usage rather than abstract animations.
v2.5.9 shipped the Stripe Customer Portal for self-service subscription management, consolidated the duplicate EditSubjectModal into a shared component, replaced all 'as any' Supabase casts with proper type aliases across 17 modules, and replaced hardcoded hex colours with CSS variables across the entire UI.
v2.5.10 through v2.5.12 polished the experience further — the AI diagram demo gained explicit state labels, Squad data was unified across tabs, mindmap structures were standardised, the changelog was restored, service worker caching was fixed, hydration errors were eliminated, and the entire codebase was consolidated under the /core single-source-of-truth architecture.
Across every sub-release, the philosophy was the same: ship fast, listen to users, and make each version genuinely better than the last. v2.5 took Claritii from a functional study tool to a polished, reliable platform.