Spellbound

SpellBound is an iPad-optimized educational web application that helps children master spelling through personalized, adaptive practice sessions. Built with a focus on engagement and learning efficacy, it combines spaced repetition algorithms with progressive difficulty modes.

Key Features

Multi-Child Architecture

• Family accounts support multiple child profiles with avatars and optional PINs
• Cookie-based active child tracking for seamless server/client state synchronization
• Row Level Security ensures complete data isolation between children

Adaptive Learning Engine

• Custom spaced-repetition scheduler that prioritizes words based on performance, streaks, and ease factor
• 5 progressive game modes: from hinted fills to full keyboard spelling
• Real-time difficulty adjustment keeps children in their optimal learning zone

Engagement Systems

• Badge/achievement system with AI-powered icon generation (OpenRouter)
• Mission-based challenges that provide structured goals
• Cartoon game characters with unique avatars for each mode
• Streak tracking and mastery scores for gamification

Content Management

• Admin panel for bulk word import with hints and definitions
• MiniMax text-to-speech integration for audio prompts
• Owner dashboard with site-wide analytics and AI-assisted badge creation

Tech Stack

• Frontend: Next.js 16 (App Router), React 19, TypeScript, Tailwind CSS 4
• Backend: Supabase (PostgreSQL + Auth + RLS), Next.js API Routes
• AI/ML: MiniMax TTS, OpenRouter API (badges, definitions, images)
• Validation: Zod schemas
• Deployment: Docker/Dokploy ready

Technical Highlights

• Type safety throughout with TypeScript and Zod runtime validation
• Security via Supabase Row Level Policies for multi-tenant data isolation
• Performance optimization with audio caching and intelligent word selection
• Developer experience - no build step required for TypeScript verification
• AI integration for content generation (definitions, decoys, images, badges)