mosesmarimo/robocode-africa

RoboCode.Africa — learn Robotics, Coding & AI in the browser with an interactive Wokwi-style simulator (Next.js 16, TypeScript, Prisma). # RoboCode.Africa A safe, vibrant, gamified platform where primary and high-school students learn **Robotics, Coding and AI** by building real circuits in an interactive in-browser simulator — **RoboCode Studio**. > Full specification lives in `docs/` (User Requirements + System Specification, `.docx` + `.pdf`). Implementation decisions are in `DECISIONS.md`; progress in `BUILD_PLAN.md`. ## Quick start ```bash pnpm install pnpm db:reset # create the SQLite db + seed demo data pnpm dev # localhost ``` **Demo logins** (password `password123`): | Role | Email | |------|-------| | Student | `tariro@springfield.robocode.africa` | | Teacher | `curie@springfield.robocode.africa` | | School admin | `admin@springfield.robocode.africa` | | Platform admin | `super@robocode.africa` | ## What's inside - **RoboCode Studio** — drag-drop canvas with real Wokwi components (Arduino UNO, ESP32, Raspberry Pi Pico + 35 components), breadboard + pin-to-pin jumper wiring, Monaco editor, serial monitor. - **Live simulation (RVM)** — an in-browser Arduino-subset interpreter (`src/lib/sim`) drives components: LEDs (PWM brightness), **LCD text**, buzzer tones (WebAudio), servos, relays, RGB, with interactive sensor inputs (pot/ultrasonic/buttons). Headless auto-grader for challenges. - **Safety-first identity** — student/school signup, approval-gated activation, parental consent, RBAC, session auth. - **Multi-tenant white-label** — host→tenant routing + per-tenant branding (live editor) + custom-domain guide. - **Learning** (courses → lessons → graded challenges), **Teams** (+ moderated chat), **Competitions**, **Leaderboards**, **Badges**, **Notifications**. - **Admin suites** — Platform, School, and Teacher consoles. - **Marketing site** — landing + features/for-schools/pricing/safety/about. ## Stack Next.js 16 (App Router, React 19) · TypeScript · Tailwind CSS v4 + Radix UI · Prisma + SQLite (Postgres-portable) · jose/bcrypt auth · Three.js / @wokwi/ele …