12 scientifically-designed cognitive games. Professional ELO rating system. Comprehensive brain training for the modern mind.
"The mind is not a vessel to be filled, but a fire to be kindled." - Plutarch
BrainiumX is a comprehensive brain training application that challenges your cognitive abilities through 12 carefully crafted games. Each game targets specific mental domains - from lightning-fast reaction times to complex problem-solving skills.
Unlike casual brain games, BrainiumX uses a professional ELO rating system (adapted from chess) to accurately track your cognitive performance over time. Watch your mental fitness improve as you train!
Test your reaction time and focus with rapid-fire challenges.
| Game | Description | Key Skills |
|---|---|---|
| Speed Tap | Tap targets as fast as possible | Reaction time, hand-eye coordination |
| Go/No-Go | Respond to targets, ignore distractors | Impulse control, selective attention |
| Focus Shift | Switch between different task rules | Cognitive flexibility, task switching |
Challenge your working memory and recall abilities.
| Game | Description | Key Skills |
|---|---|---|
| Memory Grid | Remember and recall visual patterns | Visual memory, spatial recall |
| Pattern Sequence | Reproduce increasingly complex sequences | Sequential memory, pattern recognition |
Exercise your logical reasoning and strategic thinking.
| Game | Description | Key Skills |
|---|---|---|
| Arithmetic Sprint | Solve math problems under time pressure | Mental arithmetic, processing speed |
| Trail Connect | Connect numbers and letters in sequence | Planning, visual scanning |
| Spatial Rotation | Identify rotated shapes | Spatial reasoning, mental rotation |
Train your brain to adapt and switch between different mental tasks.
| Game | Description | Key Skills |
|---|---|---|
| Stroop Match | Match colors while ignoring conflicting text | Interference control, selective attention |
| Color Match | Identify matching colors quickly | Visual processing, decision making |
| Color Dominance | Find the most frequent color in a grid | Visual analysis, counting |
| Word Chain | Build word associations under time pressure | Verbal fluency, semantic memory |
- ELO Rating System: Chess-inspired rating that adapts to your skill level
- Detailed Statistics: Track progress across all cognitive domains
- Best Score Recording: See your personal records for each game
- Performance Graphs: Visualize your improvement over time
- Three Difficulty Levels: Easy, Medium, Hard for each game
- Dynamic Challenges: Games adjust complexity based on your performance
- Progressive Training: Start easy, master harder challenges
- Game Tutorials: Learn how to play each game
- Cognitive Science: Understand what each game trains
- ELO Explanation: Learn how your rating is calculated
- Strategy Tips: Improve your performance with expert advice
- Material Design 3: Beautiful, intuitive UI
- Dark/Light Themes: Choose your preferred visual style
- Smooth Animations: Polished, professional experience
- Responsive Layout: Works perfectly on all screen sizes
- Privacy First: All data stored locally on your device
- No Account Required: Start playing immediately
- Offline Support: Train your brain anywhere, anytime
- Data Export: Share your progress (coming soon)
BrainiumX/
├── lib/
│ ├── core/
│ │ ├── base/ # Base game engine
│ │ ├── constants/ # App-wide constants
│ │ ├── providers/ # Riverpod state management
│ │ ├── services/ # Core services (data, error, performance)
│ │ ├── theme/ # Material Design 3 theming
│ │ ├── utils/ # Utilities (scoring, difficulty, RNG)
│ │ └── widgets/ # Reusable UI components
│ ├── data/
│ │ └── models/ # Hive data models
│ ├── features/
│ │ ├── games/ # 12 game implementations
│ │ ├── help/ # Help & tutorial screens
│ │ ├── home/ # Main dashboard
│ │ ├── legal/ # Privacy, terms, about
│ │ ├── onboarding/ # First-time user experience
│ │ ├── settings/ # App settings
│ │ └── splash/ # Splash screen
│ └── main.dart # App entry point
├── android/ # Android platform code
├── assets/ # Images, icons, animations
└── test/ # Unit & widget tests
- Flutter SDK 3.5.0 or higher
- Dart SDK 3.5.0 or higher
- Android Studio / VS Code with Flutter extensions
- Android SDK (for Android builds)
# Clone the repository
git clone https://github.com/Khanna-Aman/BrainiumX.git
cd BrainiumX
# Install dependencies
flutter pub get
# Generate Hive adapters
flutter pub run build_runner build --delete-conflicting-outputs
# Run the app
flutter runflutter build apk --releaseflutter build appbundle --releaseThe output files will be in:
- APK:
build/app/outputs/flutter-apk/app-release.apk - AAB:
build/app/outputs/bundle/release/app-release.aab
# Run all tests
flutter test
# Run with coverage
flutter test --coverage
# Run specific test file
flutter test test/widget_test.dart- Flutter 3.5+: Cross-platform UI framework
- Dart 3.5+: Programming language
- Riverpod 2.5+: Reactive state management
- Provider Pattern: Dependency injection
- Hive 2.2+: Fast, lightweight NoSQL database
- Hive Flutter: Flutter integration for Hive
- Shared Preferences: Simple key-value storage
- Material Design 3: Modern design system
- Google Fonts: Custom typography
- FL Chart: Beautiful data visualization
- Go Router: Declarative routing
- Build Runner: Code generation
- Hive Generator: Model adapters
- Flutter Lints: Code quality
- Flutter Launcher Icons: App icon generation
BrainiumX uses a modified ELO rating system (originally from chess) to track your cognitive performance:
- All players start at 1200 ELO
- This represents average cognitive performance
- Win (good performance): Rating increases
- Loss (poor performance): Rating decreases
- K-Factor: Determines how much ratings change (32 for new players, 16 for experienced)
Each game has its own scoring criteria:
- Speed games: Based on reaction time and accuracy
- Memory games: Based on recall accuracy and speed
- Problem-solving: Based on correct answers and time taken
- 🥉 Bronze (< 1200): Beginner
- 🥈 Silver (1200-1400): Intermediate
- 🥇 Gold (1400-1600): Advanced
- 💎 Diamond (1600-1800): Expert
- 👑 Master (1800+): Elite
- No Data Collection: We don't collect any personal information
- Local Storage Only: All data stays on your device
- No Ads: Clean, distraction-free experience
- No Tracking: No analytics or third-party trackers
- Open Source: Code is transparent and auditable
- Cloud sync for progress backup
- Multiplayer challenges
- Daily brain training streaks
- Achievement system
- Custom training plans
- More games (15+ total)
- Advanced statistics and insights
- Social features (leaderboards, friends)
- Personalized difficulty adjustment
- Export progress reports
- AI-powered training recommendations
- Voice-controlled games
- Accessibility improvements
- iOS version
- Web version
Contributions are welcome! Here's how you can help:
- Fork the repository
- Create a feature branch:
git checkout -b feature/amazing-feature - Commit your changes:
git commit -m 'Add amazing feature' - Push to the branch:
git push origin feature/amazing-feature - Open a Pull Request
- Follow the existing code style
- Write tests for new features
- Update documentation as needed
- Keep commits atomic and well-described
This project is licensed under the MIT License - see the LICENSE file for details.
- Chess.com - Inspiration for the ELO rating system
- Lumosity - Cognitive game design principles
- Material Design - UI/UX guidelines
- Flutter Community - Amazing framework and support
Aman Khanna
- GitHub: @Khanna-Aman
Built with ❤️ and cognitive science
Flutter • Dart • Riverpod • Hive • Material Design 3
⭐ Star this repo if BrainiumX helped sharpen your mind!