EduGenius is a modern, scalable, AI-driven platform designed to revolutionize online education by providing personalized learning experiences, streamlined course management, and actionable insights for students, instructors, and administrators.
- Project Overview
- Features
- Technical Stack
- Installation
- Usage
- Project Workflow
- Deployment
- Contributors
- Troubleshooting
- Roadmap
- License
EduGenius aims to enhance the learning ecosystem by integrating Artificial Intelligence to deliver:
- Personalized Learning Paths: Adaptive content tailored to student performance.
- Automated Feedback: Instant grading and suggestions powered by AI.
- Actionable Insights: Analytics for instructors and administrators to optimize outcomes.
The platform supports three user roles: Students, Instructors, and Administrators, each with tailored functionalities to streamline education delivery.
- Course Enrollment: Browse, enroll, and view course details.
- Progress Tracking: Visualize progress with charts.
- Quizzes & Assignments: Submit work and receive AI-driven feedback.
- AI Recommendations: Personalized course and lesson suggestions.
- Adaptive Learning: Dynamic content adjustments based on performance.
- Discussion Forum: Engage with peers and instructors.
- Notifications: Stay updated on deadlines and announcements.
- Certificates: Earn certificates upon completion.
- Course Creation: Build courses with multimedia content.
- Student Management: Monitor progress and provide feedback.
- Grading: Evaluate assignments with AI insights.
- AI Insights: Identify student weaknesses and optimize content.
- Announcements: Communicate updates to students.
- User Management: Oversee accounts and approvals.
- Course Oversight: Approve and monitor course quality.
- Analytics: Access platform-wide performance metrics.
- AI Analytics: Predict trends and suggest improvements.
- Promotions: Manage campaigns and discounts.
- Personalized recommendations and adaptive learning paths.
- Automated feedback and predictive analytics.
- AI chatbot for real-time student support.
- Gamification: Badges, points, and leaderboards.
- Peer Learning: Group projects and peer reviews.
- Virtual Labs: Hands-on practice environments.
- Next.js: v15.2.1 - React framework for SSR and static site generation.
- Tailwind CSS: v4 - Utility-first CSS with
tailwindcss-animate. - React: v19.0.0 - UI components with
react-dom. - Framer Motion: v12.5.0 - Animations.
- Radix UI: Accessible, unstyled components (e.g., dialogs, tooltips).
- Next Themes: v0.4.6 - Theme management.
- Node.js + Express.js: Server-side logic (via Next.js API routes).
- MongoDB: Database with
mongoosev8.12.1 for schema modeling. - Clerk: v6.12.5 - Authentication and user management with
JWT.
- TensorFlow.js: v4.22.0 - On-device AI for recommendations and analytics.
- (Note: DeepSeek API mentioned in SRS is not in
package.json; confirm usage.)
- Stripe: Payment processing (not in
package.json; to be added if used). - Axios: v1.8.4 - HTTP requests.
- Zod: v3.24.2 - Schema validation with
react-hook-formv7.54.2. - Lucide React: v0.479.0 - Icon library.
- Swiper: v11.2.5 - Carousel components.
- ESLint: v9 - Linting with
eslint-config-nextv15.2.1. - Prettier: v3.5.3 - Code formatting with Tailwind plugin.
- PostCSS: v4 - CSS processing.
- Node.js: v18.x or later
- MongoDB: Local or cloud instance (e.g., MongoDB Atlas)
- npm: v9.x or later
- Git: For version control
-
Clone the Repository:
git clone https://github.com/tariqul/EduGenius.git cd EduGenius -
Install Dependencies:
npm install
-
Configure Environment Variables: Create a
.env.localfile in the root directory and add the following:NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY= CLERK_SECRET_KEY= WEBHOOK_SECRET= NEXT_PUBLIC_CLERK_SIGN_IN_URL=/sign-in NEXT_PUBLIC_CLERK_SIGN_UP_URL=/sign-up NEXT_PUBLIC_CLERK_AFTER_SIGN_IN_URL=/ NEXT_PUBLIC_CLERK_AFTER_SIGN_UP_URL=/ MONGODB_DATABASE_URL= MONGODB_DATABASE_USERNAME= MONGODB_DATABASE_PASSWORD=
-
Run the Development Server:
npm run dev
-
Build for Production:
npm run build npm run start
- Students: Sign up via Clerk, browse courses, and start learning.
- Instructors: Log in, create courses, and manage students.
- Admins: Access the admin dashboard to oversee platform operations.
Run npm run lint to check code quality before commits.
- Course Creation: Instructors design courses; admins approve.
- Enrollment: Students join courses and track progress.
- Learning: Students complete tasks with AI support; instructors grade.
- Certification: Students earn certificates upon completion.
-
Build and run:
npm run build npm run start
-
Install Vercel CLI:
npm install -g vercel
-
Deploy:
vercel
-
Set environment variables in Vercel dashboard matching
.env.local.
- Use MongoDB Atlas for a cloud-hosted database.
- Update
MONGODB_URIin your environment variables.
| Name | Role | Github | Contributions | |
|---|---|---|---|---|
| Tariqul Islam | MERN Stack Developer | github/tariqul | in/tariqul | Built the UI, integrated APIs |
| Jahidul Islam | MERN Stack Developer | github/jahidul | in/jahidul | Built the UI |
| Rashadul Islam | Full Stack Developer | github/Rashad | in/rashad | Integrated AI features (recommendations) |
| Md.Munna | MERN Stack Developer | github/munna | in/munna | Built the UI |
- MongoDB Connection Error: Verify
MONGODB_URIand network access. - Clerk Auth Issues: Check Clerk keys in
.env.local. - Build Fails: Run npm run lint and fix errors; ensure dependencies match
package.json.
- Core features (enrollment, course creation, AI recommendations).
- Advanced features (gamification, virtual labs).
- Scalability improvements and mobile app integration.
This project is licensed under the .