A gamified educational platform for K-12 learning with adaptive skill mastery.
src/
├── app/ # App entry point
│ ├── App.tsx # Main app component with routing
│ └── main.tsx # React entry point
├── features/ # Feature-based modules
│ ├── admin/ # Admin panel (Dashboard, User Management, Library)
│ ├── auth/ # Authentication (Login, SignUp, RoleSelection)
│ ├── student/ # Student game view
│ ├── teacher/ # Teacher curriculum builder
│ ├── parent/ # Parent monitoring view
│ └── offline/ # Offline mode support
├── shared/ # Shared components
│ └── components/
│ ├── ui/ # UI primitives (Button, Card, Modal, Badge, etc.)
│ ├── layout/ # Layout components (Navbar, RoleCard)
│ └── renderers/ # Question renderers (VerticalMath, Numpad)
├── stores/ # Zustand/localStorage state management
├── services/ # External services (Gemini AI, registries)
├── types/ # TypeScript type definitions
├── theme/ # Theme provider and configuration
└── lib/ # Firebase and config utilities
Prerequisites: Node.js 18+
- Install dependencies:
npm install - Set
GEMINI_API_KEYin.env.local - Run the app:
npm run dev - Build for production:
npm run build
See DESIGN_STANDARDS.md for styling conventions and dark mode implementation.
