Changelog

v0.10.0

Grade System + Onboarding

February 19, 2026

Grade-Specific Curriculum

  • Student Grade Field - Students now have an assigned grade level stored on their profile. This determines which subjects, assessments, and curriculum they see
  • Grade-Filtered Dashboard - The student dashboard now uses `getSubjectsByGrade` to only show subjects matching the student's registered grade, ensuring assessments and lessons are always grade-appropriate
  • Updated Add Student Dialog - The parent dashboard's "Add Student" dialog now requires grade selection with a dropdown, plus displays a grade badge on each student card

Parent Onboarding Flow

  • 4-Step Onboarding - New parents with no students are automatically redirected to `/parent/onboarding` with a guided Welcome → Student Info → Grade Select → Confirm flow
  • Grade Selection Cards - Visual grade picker with grade numbers, labels, and age ranges (Grade 1-6) plus a reassuring note about placement assessments fine-tuning the level
  • Confirmation Summary - Final step shows all details with a clear "What happens next" section explaining the curriculum assignment and assessment flow
  • Reusable for Additional Students - Parents can always add more students later using the updated dialog on the parent dashboard, which includes the same grade selection

v0.9.0

Placement Assessment

February 19, 2026

Placement Assessment Flow

  • Assessment Gate - Students must complete a placement assessment before accessing any subject. The subject page now checks for baseline and redirects to a branded assessment prompt with info cards
  • Assessment UI - Multi-question placement test with progress bar, question counter, answer selection with color-coded feedback, and auto-advance on correct answers
  • Results + Plan - Assessment results page shows overall score, per-subtopic breakdown with mastery classification (needs work / on track / strong), and auto-generates an adaptive student plan
  • Student Plan Generation - `createPlanFromPlacement` in adaptive.ts builds an 18-week learning plan with week scheduling, adaptive lesson allocation (5 for remediation, 3 for on-track, 1 for mastered topics), and sets the first active subtopic
  • Dashboard Integration - Subject cards now show "Assessment Required" or "Baseline: X%" badges with progress bars reflecting placement scores

Comprehensive Seed Data

  • Full Lesson Content - `convex/seedLessons.ts` generates real Grade 2 Math lessons for all subtopics with instruction, practice (5 questions each), and review lessons containing real educational content
  • Placement Questions - 2-3 placement assessment questions per subtopic with real math problems, answer options, and detailed explanations
  • Admin Seed Page - New buttons to seed lessons and placement questions separately from the curriculum structure

v0.8.0

Learning Experience

February 19, 2026

Lesson System

  • Topic Detail Page - New page at `/student/subjects/[id]/topics/[id]` showing all subtopics in an expandable accordion with difficulty indicators, estimated time, and inline lesson listings
  • Lesson Viewer - Full lesson experience with step-through content blocks, progress bar, and sticky navigation. Supports headings, text, math expressions, and multiple-choice practice questions
  • Practice Questions - Interactive multiple-choice with answer selection, check-answer reveal, correct/incorrect feedback with explanations, and color-coded option states
  • Lesson Completion - Tracks progress via Convex lessonProgress table, shows score summary on completion with correct/total/percentage breakdown

Backend

  • Convex Lessons API - New `convex/lessons.ts` with queries for lesson retrieval and progress tracking, plus mutations for starting and completing lessons
  • Seed Lessons - Grade 2 Math A.1.1 (Counting Review) now seeds with 3 sample lessons: instruction, practice (5 questions), and review
  • Subject Page Wiring - All topic rows now link to the topic detail page; Start Learning button routes to the first topic

v0.7.0

Dashboard Overhaul

February 19, 2026

Premium Dashboard Redesign

  • Gradient Header Cards - All dashboards now feature rich gradient hero sections with radial overlays, inline stats, and contextual actions
  • Admin Curriculum - Tabbed interface with Curriculum and Users views, full curriculum tree drill-down (units > topics > subtopics), user management table with role badges and status indicators
  • Student Dashboard - Two-column layout with subject cards showing unit/topic counts and progress bars, sidebar with activity feed and quick actions, time-of-day greeting
  • Parent Dashboard - Rich student cards with progress footers showing assessment and time stats, curriculum sidebar, activity feed with student creation events

Live Simulation Previews

  • Functional Student Preview - Navigate into subjects, explore the full curriculum tree with units/topics/subtopics, and see Start buttons on each topic
  • Functional Parent Preview - Create real simulated students in the database, view them with full student cards, and test the parent-student workflow end-to-end
  • Role Switcher Banner - Quick-switch between Student and Parent previews with a persistent sticky banner showing the current simulation context

Bug Fixes

  • Changelog Back Button - Now routes to `/dashboard` instead of the home page, keeping logged-in users in the correct context

v0.6.0

Role Preview

February 19, 2026

Admin Role Preview

  • Preview Dropdown - Super admins can now preview the Student and Parent dashboards directly from the navigation bar without logging into separate accounts
  • Preview Banner - Sticky banner on preview pages clearly indicates read-only mode with one-click back-to-admin
  • Role-Specific Views - Student preview shows enrolled subjects with stats; Parent preview shows mock student list with management controls

v0.5.0

Dashboard Redesign

February 19, 2026

Premium Dashboard Experience

  • New Navigation Bar - Compact Vercel-style top nav with logo, breadcrumb role label, nav links, user name/email display, and blurred backdrop
  • Admin Curriculum - Redesigned with gap-px stat cells, collapsible subject rows with animated state badges, and clean unit listings
  • Student Dashboard - Welcome header with learning hub branding, subject cards with hover accent lines and continue-learning CTAs
  • Parent Dashboard - Personalized greeting, student list with avatar initials, creation dates, and streamlined add-student dialog
  • Subject Detail - Learning path view with numbered unit cards, topic previews with lesson counts, and start-here badges
  • Seed Data Page - Clean card layout with status banners, step-by-step next actions, and view-curriculum link

Technical

  • Added `convex/auth.config.ts` for Clerk JWT authentication provider with Convex
  • Fixed admin setup API route to create Convex client at request time instead of module scope
  • Dashboard now auto-syncs user to Convex on first sign-in with 8-second timeout and helpful error state
  • Consistent design language: gap-px stat grids, rounded-xl cards, 11px uppercase tracking-wider labels

v0.4.0

Premium Redesign

February 19, 2026

Complete Landing Page Rebuild

  • Dark Cinematic Hero - Full-bleed dark hero with ambient purple/blue glows, oversized kinetic typography, and parallax scroll transforms
  • Adaptive Engine Visualization - Interactive node graph showing the adaptive algorithm in action with animated connections, pulsing active nodes, and color-coded mastery levels
  • Asymmetric Feature Grid - Mixed 2-col/1-col layout with cards instead of uniform grids
  • Animated Stats Bar - Spring-physics counter animations triggered on scroll
  • Full Framer Motion - Every section uses scroll-triggered reveals, parallax, scale transforms, and staggered animations

New Features

  • Super Admin Setup - Added `/admin/setup` page with secret-based promotion flow so the first admin can self-promote securely
  • Proper Authentication Flow - Fixed middleware to use standard Clerk middleware with public routes for landing page, sign-in/up, and changelog
  • Clear CTAs - Sign-up and sign-in buttons throughout the landing page and navigation for easy account creation

Technical

  • Added Framer Motion (motion package) for scroll-triggered animations
  • Added `promoteToSuperAdmin` mutation with env-var secret verification and single-admin enforcement
  • Added `ADMIN_SETUP_SECRET` environment variable for secure admin promotion

v0.2.0

Quality Audit

February 19, 2026

Bug Fixes

  • Adaptive Algorithm TypeScript Errors - Fixed invalid `as const` on ternary expression by introducing `SubtopicStatus` type alias
  • Assessment-to-Adaptive Wiring - Connected `completeAssessment` to trigger `triggerAdaptiveRebalancing` via scheduler
  • Dashboard Routing - Fixed routing to use actual route paths
  • Navigation Role Detection - Reads role from Convex instead of empty Clerk publicMetadata
  • Next.js 16 Params - Fixed subject page to await params

Improvements

  • Removed all hardcoded mock data across all dashboards
  • Added `getCurriculumStats` query for real aggregate counts
  • Removed duplicate headers in favor of shared Navigation
  • Standardized all colors to semantic design tokens

v0.1.0

Initial Release

February 19, 2026

Features

  • Convex schema with full curriculum data model
  • Clerk authentication with multi-role support
  • Grade 2 Math seed data (6 units, 20+ subtopics)
  • Adaptive algorithm with mastery classification and prerequisite resolution
  • Role-based dashboards for students, parents, and admins
  • Assessment engine with scoring and subtopic analytics

Coming Next

  • Lesson content player with rich media
  • Assessment UI with interactive question types
  • Math diagram components (number lines, base-ten blocks)
  • Student progress reports and analytics
  • ELA curriculum content