EducationCAN I VIBECODE
Brilliant?
BUILD FIRST
- A non-sensitive or read-only version of the core experience
- A manual review step wherever correctness or trust matters
- A narrow companion tool that removes a real piece of work
LEAVE FOR LATER
- Regulated decisions, payments, or irreversible actions
- Claims of correctness, compliance, or uptime that the MVP cannot support
- Sensitive integrations until security, support, and auditability are ready
RESEARCH NOTES
What this tool actually does.
Brilliant is an interactive learning platform focused on math, coding, data science, and science. It replaces passive video lectures with visual, step-by-step problem-solving: users play with concepts, receive instant feedback, and build intuition. Content is organized into individual courses and Learning Paths — guided, sequential curricula from foundational to advanced topics (e.g., Foundational Math, Programming & CS, Python Data Analysis, Logical Reasoning, Everyday Math). Each path mixes explanations with hands-on practice and periodic checkpoints. Motivational mechanics include XP (experience points) earned from lessons and problems, weekly Leagues leaderboards, streaks, levels, and daily goals. Free users may start any course but must progress sequentially with limited daily access; Premium subscription provides unlimited access to all paths plus extra content. The core loop is le
RESEARCHED BUILD PROMPT
Give this to your coding agent.
Build 'ConceptSpark' — a focused replacement for Brilliant's interactive practice-learning workflow, not a copy of its brand, logo, or UI.
Workflow: A learner picks a learning path (e.g., Foundational Math), sees a guided sequence of short lessons. Each lesson presents a concept with a short visual/animatable explanation, then 3–6 interactive multiple-choice or numeric-answer problems with instant feedback and hints. Correct answers advance the lesson; mistakes show a worked explanation and optionally repeat. Completing lessons awards XP; a weekly league board ranks all active users by XP and resets each week. Daily goals and streaks encourage return visits.
User-facing requirements:
1. Path/course catalog with prerequisite ordering; free users must follow the sequence, premium (mock flag) users can jump anywhere.
2. Lesson player with progress bar, step-by-step feedback, hint button, and a visual simulation area (simple animated diagrams — e.g., number lines, bar charts).
3. XP ledger, streak counter, daily goal progress, and weekly league ranking with auto-reset.
4. Admin CSV import for courses, lessons, questions, and hints.
Technical requirements:
- React (Vite) frontend; Node/Express or Supabase backend; Postgres/SQLite storage.
- REST API endpoints: /paths, /paths/:id/progress, /lessons/:id, /answers/check, /xp, /league.
- JWT auth with mock billing flag for 'premium'.
- Seed data with one complete math path (≥3 lessons, ≥15 questions) and one partial CS path.
Implementation approach: server-side strict lesson sequencing and XP validation; client-side animations via CSS/Canvas (no heavy game engine); league computed from XP events table grouped by ISO week.
Out of scope: real payments, mobile apps, video, community forums, AI tutor, multiplayer, accessibility beyond basic labels.
Deliverables: source code plus README with setup steps (env vars, seed command), test commands, and limitations (no production auth, naive fraud protection, sample data only).
Do not copy the original brand, proprietary assets, or UI; create an original visual system.