- 🧠 AI-Powered Learning: Personalized course recommendations using OpenAI GPT-4
- 📚 Interactive Courses: Rich content with sections, code examples, and resources
- 📊 Progress Analytics: Detailed tracking with charts and insights using Recharts
- 🏆 Achievement System: Gamified learning with badges and rewards
- 🎯 Adaptive Paths: AI adjusts difficulty based on your performance
- 📱 PWA Support: Install as native app on mobile/desktop
- 🌙 Dark/Light Theme: Comfortable learning in any environment
- 🔄 Real-time Sync: Progress synced across all devices
- 🔐 Secure Authentication: Supabase-powered user management
- 🎨 Modern UI: Beautiful interface with Framer Motion animations
- ♿ Accessibility: WCAG compliant design for all users
- 🌐 Open Source: 100% open source and community-driven
- Sign up and create your learning profile
- Take assessment to determine your skill level
- Get recommendations from our AI tutor
- Learn and progress through personalized courses
- Track achievements and unlock badges
- Fork the repository and set up locally
- Choose an issue from our GitHub issues
- Contribute code following our guidelines
- Submit PR and get feedback from maintainers
- Become part of our open source community
Prerequisites:
- Node.js 18+ and npm
- Supabase account (optional)
- OpenAI API key (optional, for AI features)
-
Clone the repository:
git clone https://github.com/S-YED/atlas-mind.git cd atlas-mind -
Install dependencies:
npm install
-
Environment Setup:
cp .env.example .env.local
-
Start the Application:
npm run dev
-
Open your browser: Navigate to
http://localhost:8080 -
Database Setup (Optional):
# Set up Supabase project and run migrations # See CONTRIBUTING.md for detailed setup
-
Run the application locally:
npm run dev
-
Test features:
- AI-powered recommendations
- Course progress tracking
- Achievement system
- Responsive design
-
Run linting and tests:
npm run lint npm test
| 🏠 Landing Page 🏠 | 🎓 Learning Dashboard 🎓 |
|---|---|
Immersive landing page with AI focus |
Personalized learning dashboard |
| 🤖 AI Recommendations 🤖 | 📊 Progress Analytics 📊 |
|---|---|
AI-powered personalized recommendations |
Detailed progress tracking and analytics |
atlas-mind/
├── src/
│ ├── components/ # Reusable UI components
│ ├── pages/ # Page components
│ ├── hooks/ # Custom React hooks
│ ├── lib/ # Utility functions
│ └── integrations/ # External services
├── supabase/ # Database & functions
├── docs/ # Documentation
└── public/ # Static assets
| 🧠 The Architect 🧠 |
 S-YED 🚀 Project Creator & Lead Developer |
- 🍴 Fork the repository
- 🌿 Create feature branch (
git checkout -b feature/amazing-feature) - 💾 Commit changes (
git commit -m 'Add amazing feature') - 📤 Push to branch (
git push origin feature/amazing-feature) - 🔄 Open Pull Request
Check the 📜 CONTRIBUTING.md 📜 file for detailed contribution guidelines!
We welcome contributors of all skill levels to join our mission of making AI-powered education accessible to everyone.
For SWOC 2025 Participants: This project is part of Social Winter of Code 2025! We welcome contributors of all skill levels. Check our CONTRIBUTING.md for beginner-friendly issues and mentorship opportunities.
Check the 📜 CONTRIBUTING.md 📜 file for detailed information on how you can contribute to this open source project.
This project is licensed under the MIT License - see the LICENSE file for details.
🗄️ Supabase • 🤖 OpenAI • 🎨 shadcn/ui • 🎯 Lucide Icons • 📊 Recharts • ✨ Framer Motion
Connect with us: