Updates
Every update to Claritii is designed to make studying easier, more effective, and more rewarding. Here's what's changed.
Background Job System & Production Reliability
Production reliability pass for the roadmap system: background_jobs table with full lifecycle (enqueue, retry with exponential backoff, max retry cap, failure tracking), cron API routes now process pending jobs, idempotent content generation, structured logging, and safe fallback to on-demand generation when the job system is unavailable.
- background_jobs table with migration, RLS, and lifecycle management for content generation retries
- Daily cron-push route now processes pending background jobs with exponential backoff (1min, 2min, 4min up to 1hr max)
- Weekly cron route also resets recoverable failed jobs and cleans stale completed jobs older than 7 days
- Stuck 'processing' jobs (30+ min without completion) are automatically detected and retried
- Idempotent generation: ensureContentForSessions always checks existing content before generating, preventing duplicates
- generateRoadmap now logs lifecycle events (start, session count, job enqueue count, any failures) for observability
- Failed content generation gracefully falls back to on-demand generation when job queue is unavailable
- New cron.functions.ts module with processBgJobs, retryStuckBgJobs, resetFailedBgJobs, cleanStaleBgJobs server functions
- Verifiable cron execution via /api/cron-push returning detailed results including jobs processed, succeeded, failed, deferred
Stabilisation & Production Hardening
Safety, performance, and reliability pass across the roadmap generation system. Pre-generation failures are now tracked and queued for background retry, duration jitter is deterministic per session, scheduling blocks are consistently ordered, derived state is memoised to avoid wasted renders, and hover visuals match the dashboard exactly.
- Failed AI content generations are now tracked and written to a background_jobs queue for automatic retry — no silent data loss
- Duration jitter is now fully deterministic: same session, same user, same date always produces identical durations
- Schedule blocks are now explicitly ordered by id within each day, ensuring consistent multi-session ordering
- Overlapping schedule blocks on the same day are sorted largest-first to maximise time utilisation
- Deduplication now checks assessment_id in addition to date+subject+topic, preventing more duplicate patterns
- All derived session computations in RoadmapView are now memoised with useMemo, eliminating wasted recalculations
- Subject lookups in RoadmapView use an internal cache to avoid repeated object creation on every render
- Roadmap hover effects now match the dashboard exactly (hoverGlowVariants - y:-3, scale:1.03, boxShadow)
- Pre-generation now correctly catches and logs individual content type failures per session
Roadmap System Overhaul - Demo + Production Parity
The roadmap system has been completely overhauled: the landing page demo now uses the exact same component as the production roadmap, session content is pre-generated for the full horizon, generation quality no longer degrades over time, session durations are varied realistically, and the visual design has been polished with a curved connector path and subtler hover effects.
- Specific scheduling mode - roadmap now supports multiple disjoint sessions per day when users provide specific time ranges
- Curved flowing connector line between date groups replaces the old straight-line divider for a more guided visual path
- Landing page roadmap demo now uses the same component as the production roadmap - identical visuals, logic, and behaviour. Demo data is shaped identically to real session data.
- Session durations are now varied with jitter - no more repeated '45 min' or '63 min' values across sessions
- Content generation rotation expanded to 20-28 patterns per urgency band, up from 7-15, ensuring variety across the full horizon
- AI session planning now covers up to 300 slots (was 60), so all sessions get AI-optimised plans not just rule-based fallback
- Pre-generated session content now covers the full roadmap horizon instead of only the next 3 days
- Hover effects reduced in intensity to match the dashboard - replaced 3D translateZ hover with simple lift effect
- Removed aggressive 3D perspective transforms from roadmap date cards that caused blurriness and visual noise
Landing Page Demo Refresh & Quality Improvements
All landing page demos have been refreshed with better animations, interactive controls, and visual polish. The Squad demo now includes Friends leaderboard, the Diagram demo shows SVG and AI generation paths, and all demo interactions are more responsive.
- AI Diagram Generation demo now shows both SVG generation (fast, structured) and AI generation (complex visuals) paths
- Squad demo restored with Friends leaderboard tab alongside Global and Australia leaderboards
- Fixed assessment demo auto-advance - animation now starts only when the section enters your viewport
- Subject-Specific Settings demo now has fully working Auto/Manual toggle controls
- Pre-Generated Content demo now includes typing animation simulation showing AI-generated feedback
- Roadmap demo visual quality improved - better scaling, typography, and spacing
- Mind Map demo no longer uses framer-motion height animation that caused visual glitches
- Fixed version label from v2.3.3 to v2.3.0
- Added entrance animations to leaderboard entries, feed items, and friends list in Squad demo
Custom Domain, Encoding Fixes & Changelog Standardisation
Claritii has moved to its own custom domain, making it easier to find and access. This release also fixes encoding issues across the changelog and standardises the format for future updates.
- Custom domain - Claritii is now at getclaritii.com; update your bookmarks
- All sitemap URLs, canonical links, and SEO metadata updated to the new domain
- Improved local environment configuration with VITE_APP_URL
- Fixed an issue where update entries appeared empty after closing and reopening an accordion group
- Fixed garbled encoding characters across version ranges and changelog text
- Updated changelog format with standardised New Features and Improvements sections for all future releases
System-Wide Stability & Reliability Improvements
Every part of Claritii got a thorough polish pass — sign-in is more reliable, AI responses are more resilient, navigation is smoother, and the whole app feels more consistent.
- Improved sign-in reliability and account stability — no more unexpected redirects or session issues
- More resilient AI-powered study generation with better error handling and recovery
- Push notifications now correctly respect your preferences
- Fixed an issue that could prevent study sessions from loading correctly
- Improved visual consistency across all pages with cleaner layouts and spacing
- Mobile navigation now includes the Squad tab so you can check leaderboards on the go
- Footer links are faster and smoother with instant page transitions
- Better protection against unexpected crashes — the app stays up even when individual sections have issues
- Cleaner, more consistent forms and confirmation dialogs throughout the app
- Removed outdated Coming Soon items that have already shipped (AI Diagram Generation, Practice Paper Generation)
- Cleaned up and reorganised version history for easier browsing
- General performance improvements and behind-the-scenes maintenance
Polish Pass, Encoding Fixes & Updates Page Rework
Cleaned up encoding issues across the app, merged the assessment upload into a single card, upgraded Active Recall with a 3-attempt retry loop, and overhauled the updates page with version-range sections.
- Active Recall mode now has a structured 3-attempt retry loop with attempt tracking, key points reference, and gap review panel
- Updates page reorganised into version-range sections (v2.0+, v1.6-1.9, v1.1-1.5) for easier browsing
- Fixed garbled encoding characters across login placeholders, analytics emoji, review checkmarks, and assessment quiz answers
- Assessment Materials + Notification merged into a single unified upload card with inline text paste, file drag-drop, and combined save
- Landing page hero spacing improved with balanced padding
- Version bumped to v2.5.1
Feynman Reimagined, Mind Maps & Squad Leaderboards
Biggest study techniques update yet. Feynman is now a 'teach a beginner' workflow, Mind Mapping gets its own visual mode, and Squad tiers go global with country leaderboards and seasonal resets.
- Mind Mapping as a fourth study technique - connected visual diagrams with expandable branches
- Country-specific leaderboards and a new Global tab in Squad, with season/cycle resets
- New Squad tiers: Bronze (1 min), Silver, Gold, Platinum, Diamond, Elite, Legend - each with its own colour and badge
- Auto-carousel on all landing page demos with typing animations, pauses on manual click
- Feynman Technique overhauled to the 'teach a beginner' 4-step model: choose a concept, explain it simply, find gaps in your understanding, refine with analogies
- Diagrams now default to SVG generation; Gemini AI path added for complex diagrams with DB caching architecture
- Session Feynman mode now has a full interactive 4-step editor with gap logging and rewrite workspace
- Quiz corrections now highlight specifically what you selected vs the correct answer with misconception hints
Coming Soon
Smarter Spaced Repetition
An adaptive review system that schedules flashcards at the perfect time for your brain.
Mobile Apps
Native iOS and Android apps so you can study anywhere, even offline.
Advanced Study Analytics
Deep insights into your learning patterns, weak topics, and predicted performance.
Syllabus-Aware Learning
Upload your syllabus and Claritii will align every session to exactly what you need to know for your exams.
Collaborative Study Groups
Study with classmates in real time. Share notes, quiz each other, and track group progress.