Revolutionizing education through intelligent course creation and gamified learning experiences
LearnSphere is a cutting-edge, AI-powered learning platform that democratizes education by enabling anyone to create comprehensive, structured courses on any topic within minutes. Built with modern web technologies and powered by Google's Gemini AI, it combines intelligent content generation with gamification to deliver an engaging learning experience.
- 🤖 AI-Powered Course Generation: Create complete courses with structured chapters and lessons using advanced AI
- 🎮 Gamified Learning: XP system, levels, daily streaks, and global leaderboards
- 🔐 Secure Authentication: Robust user management with Clerk integration
- 📱 Responsive Design: Beautiful, modern UI that works seamlessly across all devices
- 🏆 Progress Tracking: Comprehensive learning analytics and achievement system
- 🎯 Personalized Content: Adaptive difficulty levels and customized learning paths
Sagar Bhadra , Arpan Sarkar , Subhamoy Datta , Barshan Majumdar , Indrajit Bhowmik
- 🤖 Intelligent Course Creation: Generate comprehensive courses on any topic with customizable difficulty levels
- 📚 Structured Learning: Organized chapters, lessons with rich HTML content, and interactive quizzes
- 🎮 Gamification Engine: XP points, level progression, daily streaks, and competitive leaderboards
- 📊 Analytics Dashboard: Track learning progress, completion rates, and performance metrics
- 🔍 Smart Search: Find courses quickly with intelligent search and filtering
- 🔐 Secure Login: Multi-provider authentication via Clerk (Google, email)
- 👤 User Profiles: Personalized dashboards with progress tracking
- 🛡️ Data Protection: Industry-standard security practices and data encryption
- 📱 Responsive Design: Optimized for desktop, tablet, and mobile devices
- ⚡ Fast Loading: Optimized performance with lazy loading and caching
- 🌐 Accessibility: WCAG compliant with screen reader support
graph TB
A[React Frontend] --> B[Express API]
B --> C[MongoDB Atlas]
B --> D[Google Gemini AI]
A --> E[Clerk Auth]
B --> F[Course Generator]
F --> G[Content Parser]
G --> H[Quiz Engine]
- ⚛️ React 18 with TypeScript for type-safe development
- ⚡ Vite for lightning-fast build and development
- 🎨 Tailwind CSS for modern, responsive styling
- 🔐 Clerk for authentication and user management
- 📡 Axios for API communication
- 🎭 Lucide React for beautiful icons
- 🟢 Node.js with Express.js framework
- 🍃 MongoDB with Mongoose ODM
- 🤖 Google Gemini AI for content generation
- 🔒 JWT for secure token management
- 🌐 CORS for cross-origin resource sharing
- 📦 npm/yarn for package management
- 🔧 ESLint & Prettier for code quality
- 🚀 Vercel/Netlify ready deployment
- 📊 MongoDB Atlas for cloud database
Before you begin, ensure you have the following installed:
- 📦 Node.js (v18.x or later)
- 🍃 MongoDB (local instance or MongoDB Atlas)
- 🔑 Clerk Account (for authentication)
- 🤖 Google Gemini API Key
-
Clone the Repository
git clone https://github.com/SagarBhadra01/ai-learning-platform.git cd ai-learning-platform -
Backend Setup
cd backend npm installCreate a
.envfile in the backend directory:PORT=5001 MONGO_URI=your_mongodb_connection_string GEMINI_API_KEY=your_google_gemini_api_key CLERK_SECRET_KEY=your_clerk_secret_key NODE_ENV=development
-
Frontend Setup
cd ../frontend npm installCreate a
.env.localfile in the frontend directory:VITE_CLERK_PUBLISHABLE_KEY=your_clerk_publishable_key VITE_API_BASE_URL=http://localhost:5001 VITE_GEMINI_API_KEY=your_frontend_gemini_api_key
-
Start Development Servers
Backend (Terminal 1):
cd backend npm run devFrontend (Terminal 2):
cd frontend npm run dev -
🎉 Access the Application
Open your browser and navigate to
http://localhost:5173
ai-learning-platform/
├── 📁 backend/ # Express.js API Server
│ ├── 📁 models/ # MongoDB Models (User, Course, Progress)
│ ├── 📁 routes/ # API Routes (auth, courses, users)
│ ├── 📁 middleware/ # Custom Middleware (auth, validation)
│ ├── 📁 services/ # Business Logic (AI, gamification)
│ ├── 📁 config/ # Configuration Files
│ ├── 📄 server.js # Main Server Entry Point
│ └── 📄 .env # Environment Variables
├── 📁 frontend/ # React Frontend Application
│ ├── 📁 src/
│ │ ├── 📁 components/ # Reusable UI Components
│ │ ├── 📁 pages/ # Route Components
│ │ ├── 📁 hooks/ # Custom React Hooks
│ │ ├── 📁 services/ # API Service Layer
│ │ ├── 📁 utils/ # Helper Functions
│ │ ├── 📁 types/ # TypeScript Definitions
│ │ └── 📄 main.tsx # Application Entry Point
│ ├── 📄 index.html # HTML Template
│ ├── 📄 vite.config.ts # Vite Configuration
│ └── 📄 .env.local # Environment Variables
├── 📄 README.md # Project Documentation
├── 📄 LICENSE # MIT License
└── 📄 package.json # Root Package Configuration
POST /api/auth/register # User Registration
POST /api/auth/login # User Login
GET /api/auth/profile # Get User Profile
PUT /api/auth/profile # Update ProfileGET /api/courses # Get All Courses
POST /api/courses # Create New Course
GET /api/courses/:id # Get Course by ID
PUT /api/courses/:id # Update Course
DELETE /api/courses/:id # Delete CourseGET /api/progress/:userId # Get User Progress
POST /api/progress/complete # Mark Lesson Complete
GET /api/leaderboard # Global LeaderboardFor comprehensive API documentation with examples, visit our API Documentation
- 📖 Course Completion: 100-500 XP based on difficulty
- ✅ Lesson Completion: 10-50 XP per lesson
- 🎯 Quiz Performance: 5-25 XP based on score
- 🔥 Daily Streaks: Bonus XP for consecutive learning days
- 🏅 Achievements: Special XP rewards for milestones
We welcome contributions from the community! Here's how you can help:
- Fork the Repository on GitHub
- Clone your Fork locally
- Create a Feature Branch:
git checkout -b feature/amazing-feature - Make your Changes with proper commit messages
- Test Thoroughly - ensure all tests pass
- Submit a Pull Request with detailed description
- 🐛 Bug Reports: Use GitHub Issues with detailed reproduction steps
- ✨ Feature Requests: Propose new ideas with clear use cases
- 💻 Code Style: Follow ESLint and Prettier configurations
- 🧪 Testing: Add tests for new features and bug fixes
- 📚 Documentation: Update docs for any API or feature changes
- 🌐 Internationalization: Multi-language support
- 📱 Mobile App: React Native implementation
- 🤖 AI Improvements: Enhanced course generation algorithms
- 🎨 UI/UX: Design improvements and animations
- ⚡ Performance: Optimization and caching strategies
This project is licensed under the MIT License - see the LICENSE file for details.
MIT License
Copyright (c) 2025 Sagar Bhadra
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
- 🤖 Google Gemini Team for providing powerful AI capabilities
- ⚛️ React Community for the amazing ecosystem
- 🔐 Clerk Team for seamless authentication solutions
- 🌍 Open Source Community for inspiration and resources
- 🌐 Multi-language Support - Global accessibility
- 📱 Mobile Application - Native iOS/Android apps
- 🤝 Collaborative Learning - Group courses and study rooms
- 🎥 Video Integration - YouTube and custom video support
- 🔊 Audio Lessons - Text-to-speech and podcasts
- 🧠 Advanced AI - Personalized learning paths
- 📈 Analytics Dashboard - Detailed learning insights
- 💳 Monetization - Premium features and course marketplace
Made with ❤️ by Sagar Bhadra , Arpan Sarkar , Subhamoy Datta , Barshan Majumdar , Indrajit Bhowmik | Powered by AI 🤖
"Education is the most powerful weapon which you can use to change the world." - Nelson Mandela