mint-build

byALOK KUMAR

Build a fully functional, production-quality web app called **MindWave**. ## PRODUCT MindWave is an adaptive cognitive-training platform combining neurofeedback, gamification, cognitive games, analytics, and personalized training. Core loop: **Measure → Analyze → Adapt → Train → Measure again** Target users: students, professionals, biohackers, gamers, developers, and people interested in improving focus and cognitive performance. Do NOT make medical, diagnostic, disease-treatment, or unsupported health claims. Brain-derived values must be described as estimates. ## DESIGN Create a premium futuristic interface inspired by Apple, modern AI products, and neurotechnology. Dark mode by default, subtle gradients/glows, glassmorphism, rounded cards, clean typography, smooth animations, excellent spacing, responsive desktop/tablet/mobile design. Navigation: * Dashboard * Train * Games * Brain Signals * Progress * Insights * Profile * Settings ## AUTH + ONBOARDING Implement real authentication with signup, login, logout, password reset, persistent sessions, and profile creation. Onboarding asks: 1. Main goals: Focus, Attention, Memory, Reaction Speed, Mental Flexibility, Relaxation, General Cognitive Performance. 2. Experience: Beginner / Intermediate / Advanced. 3. Training time: 5 / 10 / 15 / 20+ minutes. 4. EEG device: Yes / No / Not sure. Generate a personalized initial training profile. ## DASHBOARD Create a polished dashboard with: * Greeting * Today's Focus Estimate * Personal baseline comparison * Training streak * Today's mission * Cognitive snapshot * Weekly progress chart * Personalized insight * Start Training button Metrics can include: * Attention estimate * Engagement estimate * Relaxation estimate * Reaction consistency * Memory performance * Training consistency Always label brain-derived metrics as estimates. ## ADAPTIVE ENGINE Build a reusable **MindWave Adaptive Engine**. Inputs: historical performance, score, accuracy, reaction time, difficulty, session duration, estimated cognitive state, user goals. Outputs: next difficulty, recommended game, training duration, training focus, recovery recommendation. Logic: * Strong performance → gradually increase difficulty. * Weak performance → slightly reduce difficulty. * Unstable performance → maintain difficulty and recommend recovery. * Never make sudden/extreme difficulty changes. Store adaptation decisions. ## EEG / NEUROFEEDBACK Create a Brain Signals page with: * Device status * Connection status * Signal quality * Live waveform * Estimated attention * Estimated engagement * Estimated relaxation * Delta/Theta/Alpha/Beta/Gamma visualization when data supports it Create a device abstraction layer so different EEG devices can be integrated later. IMPORTANT: If no physical EEG is available, implement **Demo/Simulation Mode** that generates synthetic signal data. Clearly display **SIMULATION — NOT REAL EEG DATA**. The entire application must work without hardware. ## GAMES Create at least 5 fully playable games: 1. **Focus Flow** — maintain stable performance while controlling a moving object. 2. **Memory Matrix** — remember and reproduce increasingly complex patterns. 3. **Reaction Pulse** — react to targets; measure reaction time, accuracy, consistency. 4. **Cognitive Switch** — rapidly switch rules such as color/shape classification. 5. **Calm Core** — interactive relaxation/focus experience influenced by estimated state or simulated data. Every game must report: score, accuracy, reactionTime, difficulty, duration, mistakes, completionRate. Games must use adaptive difficulty. ## TRAINING Every training session stores: * User * Game * Duration * Score * Accuracy * Reaction time * Difficulty * Cognitive estimates * Signal quality * Timestamp Session flow: Start → Train → Adaptive difficulty → Results → Save → Update progress → Recommendation. ## PROGRESS Create analytics for: * Focus * Reaction time * Memory * Consistency * Session duration * Difficulty progression * Personal bests Time filters: 7 days / 30 days / 90 days / All time. Prioritize comparison against the user's own baseline rather than arbitrary population averages. ## INSIGHTS Create an AI-style insights page based ONLY on stored user data. Examples: "Your attention stability improved over your last 5 sessions." "You perform most consistently during shorter sessions." Never invent statistics. If insufficient data: "Complete more sessions to unlock personalized insights." ## GAMIFICATION Implement: * XP * Levels * Training streaks * Achievements * Personal records * Daily missions * Weekly goals Achievements: First Session, 7-Day Streak, Focus Explorer, Reaction Master, Memory Builder, Consistency Champion. ## DAILY MISSION Generate a personalized daily mission based on previous performance. Example: "Today's Mission: Stabilize — 7 minutes — Improve attention consistency." Mission progress must update from real training data. ## PROFILE Show: name, avatar, goals, level, XP, streak, total sessions, total training time, personal records. ## SETTINGS Include: account, notifications, privacy, data export, connected devices, theme, accessibility, delete account. ## DATABASE Use a proper relational database. Tables/entities: users user_preferences devices games training_sessions cognitive_metrics achievements user_achievements daily_missions insights Use proper relationships, indexes, validation, and user-level data isolation. ## API / ARCHITECTURE Create modular services for: auth, users, devices, games, sessions, metrics, progress, insights, missions, achievements. Separate: UI business logic database access adaptive engine device integrations. Use TypeScript and React/Next.js or the strongest equivalent stack supported by the platform. Use real persistence, not local-only fake state. ## LANDING PAGE Create a premium landing page. Hero: **Train Your Focus. Understand Your Mind.** Subtitle: "MindWave combines adaptive cognitive training, neurofeedback, and gamification to create a personalized training experience." Sections: How It Works, Neurofeedback, Adaptive Training, Games, Progress, Insights, Devices, FAQ, CTA. CTA: **Start Training** ## SESSION RESULTS After each session show: * Score * Accuracy * Reaction time * Difficulty * Duration * Change vs personal baseline * Short data-based explanation * Next recommended session Buttons: Train Again / View Progress. ## UX Add polished but subtle: hover effects, transitions, chart animations, XP animations, achievement unlocks, session completion animation. Implement loading states, empty states, error states, reconnect states, and responsive layouts. ## SECURITY + PRIVACY Use secure authentication, authorization, validation, protected APIs, and user data isolation. Treat brain/device data as sensitive personal data. Provide data export and deletion. ## DEMO DATA Provide realistic seed/demo data for dashboards and charts, clearly labeled as demo data. ## FINAL REQUIREMENT DO NOT build a static mockup. Build a genuinely functional application. Every major button must work. Games must actually be playable. Authentication must work. Data must persist. Sessions must save. Progress must update. Achievements must unlock. Daily missions must update. Adaptive difficulty must function. Demo EEG must stream simulated data. Navigation must work. Mobile layout must work. Test the complete user flow: Signup → Onboarding → Dashboard → Start Training → Play Game → Complete Session → Save Results → Update Progress → Unlock Achievement → Generate Insight → Start Next Mission. Fix runtime errors, broken navigation, empty states, and obvious UI issues before completing the build. Brand: **MindWave** **Train Your Focus. Understand Your Mind.**