Cortex Conquest 🧠

A personalized brain training app with puzzles and games targeting memory, attention, and problem-solving. Compete with friends through social challenges and progress with adaptive training.

Features

🎮 Brain Training Games

• Memory Games: Test and improve your short and long-term memory with increasingly challenging puzzles
• Attention Challenges: Enhance focus and concentration through targeted exercises
• Problem-Solving Puzzles: Build logical thinking and analytical skills with diverse puzzle types

🏆 Personalized Adaptation

• Adaptive Difficulty: Games adjust difficulty based on your performance
• Progress Tracking: Monitor improvements over time with detailed statistics
• Personalized Recommendations: Get suggestions for games targeting your weak areas

👥 Social Features

• Multiplayer Challenges: Compete with friends in real-time or asynchronous modes
• Leaderboards: Track your performance against other players
• Social Sharing: Share achievements and challenge friends to beat your scores

📊 Analytics & Insights

• Performance Dashboard: Visualize your progress across different game categories
• Detailed Stats: Track accuracy, speed, and consistency metrics
• Weekly Reports: Receive personalized insights on your training performance

Tech Stack

• Frontend: React + TypeScript + Vite
• Styling: Tailwindcss + Vite
• Build Tool: Vite
• Linting: ESLint

Getting Started

Prerequisites

• Node.js (v16 or higher)
• npm or yarn

Installation

1. Clone the repository

git clone https://github.com/pman369/cortex-conquest.git
cd cortex-conquest

2. Install dependencies

npm install

3. Start the development server

npm run dev

4. Open your browser and navigate to http://localhost:5173

Available Scripts

• npm run dev - Start the development server
• npm run build - Build for production
• npm run preview - Preview the production build locally
• npm run lint - Run ESLint to check code quality

Project Structure

cortex-conquest/
├── src/
│   ├── components/        # React components
│   ├── pages/            # Page components
│   ├── hooks/            # Custom React hooks
│   ├── utils/            # Utility functions
│   ├── types/            # TypeScript type definitions
│   ├── App.tsx           # Main App component
│   └── main.tsx          # Entry point
├── public/               # Static assets
├── index.html            # HTML entry point
├── tsconfig.json         # TypeScript configuration
├── vite.config.ts        # Vite configuration
└── package.json          # Project dependencies

Game Categories

Memory

• Card Matching
• Sequence Recall
• Number Memory
• Story Memory

Attention

• Spot the Difference
• Speed Focus
• Pattern Recognition
• Visual Search

Problem-Solving

• Logic Puzzles
• Pattern Completion
• Maze Navigation
• Strategy Games

Contributing

Contributions are welcome! Please follow these steps:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Roadmap

• Multiplayer real-time gameplay
• AI-powered personalization engine
• Mobile app (React Native)
• Offline mode support
• Advanced analytics dashboard
• API integration for third-party games
• Achievement system and badges

Support

For support, email slappeycasuse42@hotmail.com or open an issue on GitHub.

Authors

• pman369 - Initial work

---

Happy training! May your brain conquer all challenges! 🚀