🧠 BotSensei LMS — AI-Powered Learning Management System

A revolutionary AI-powered Learning Management System that transforms how students learn by generating personalized study materials, interactive content, and providing real-time AI assistance for any subject.

🚀 Live Demo

https://botsensei-ai-lms.vercel.app/

🎯 Overview

BotSensei LMS represents the next generation of educational technology, combining the power of Google Gemini AI with modern web development practices to create an intelligent, adaptive learning platform. The system automatically generates comprehensive study materials tailored to individual learning preferences and provides real-time AI assistance across multiple subjects.

🌟 What Makes BotSensei Special

Instant Course Generation: Transform any topic into a complete learning course with structured chapters, notes, and assessments
AI-Powered Math Assistant: Get step-by-step solutions to complex mathematical problems with detailed explanations
Adaptive Content Creation: Generate personalized flashcards, quizzes, and Q&A sessions based on your learning style
Gamified Learning Experience: Interactive elements including swipeable flashcards and timed quizzes to enhance engagement
Real-time Progress Tracking: Monitor learning progress with detailed analytics and performance insights

🚀 Key Features

🎓 AI-Powered Learning Engine

Smart Course Generation: Input any topic and receive a structured course outline with chapters and learning objectives
Multi-Format Content: Automatically generates notes, flashcards, quizzes, and Q&A materials
Difficulty Adaptation: Choose from Easy, Medium, or Hard difficulty levels for personalized learning paths
Real-time Content Creation: Generate study materials on-demand without waiting times

🧮 MathAI Assistant

Step-by-Step Solutions: Solve complex mathematical problems with detailed explanations
Interactive Problem Solving: Ask follow-up questions and get clarifications on mathematical concepts
Multi-Subject Support: Covers algebra, calculus, geometry, statistics, and more
Visual Learning: Clear formatting and mathematical notation for better understanding

🎮 Gamified Learning Experience

Interactive Flashcards: Swipeable card interface with flip animations for active recall
Timed Quizzes: Engaging quiz system with immediate feedback and scoring
Progress Tracking: Visual progress indicators and achievement systems
Adaptive Difficulty: Questions adjust based on performance and learning progress

💾 Advanced Data Management

Persistent Learning: All generated content is saved and accessible across sessions
User Profiles: Personalized dashboards with learning history and preferences
Course Organization: Structured course management with chapter-based navigation
Cross-Device Sync: Access your learning materials from any device

🛠️ Technology Stack

Frontend Architecture

Technology	Purpose	Version
Next.js	Full-stack React framework with App Router	15.0.3
React	Component-based UI library	18.0
TypeScript	Type-safe JavaScript development	5.7.2
Tailwind CSS	Utility-first CSS framework	3.4.1
Framer Motion	Animation and gesture library	11.12.0
Lucide React	Beautiful icon library	0.461.0

Backend & Database

Technology	Purpose	Integration
Drizzle ORM	Type-safe database toolkit	PostgreSQL integration
Neon Database	Serverless PostgreSQL	Cloud-native scaling
Clerk	Authentication & user management	Social login, JWT tokens
Google Gemini AI	Advanced language model	Content generation, math solving

UI/UX Libraries

Library	Purpose	Features
RippleUI	Component library	Pre-built UI components
DaisyUI	Tailwind CSS components	Theme system, dark mode
React Card Flip	Interactive card animations	Flashcard functionality
Swiper.js	Touch slider component	Mobile-friendly navigation
Next Themes	Theme management	Light/dark mode switching

Development Tools

ESLint: Code linting and formatting
PostCSS: CSS processing and optimization
Drizzle Kit: Database migration and studio
Vercel: Deployment and hosting platform

🏗️ Architecture

BotSensei LMS follows a modern, scalable architecture designed for performance and maintainability:

System Architecture

graph TB
    A[Client Browser] --> B[Next.js Frontend]
    B --> C[Clerk Authentication]
    B --> D[API Routes]
    D --> E[Google Gemini AI]
    D --> F[Drizzle ORM]
    F --> G[Neon PostgreSQL]
    B --> H[Real-time UI Updates]

Project Structure

📁 BotSensei-AI-LMS/
├── 📁 app/ ---------------------------------# Next.js App Router
│   ├── 📁 (auth)/ --------------------------# Authentication routes
│   │   ├── 📁 sign-in/                      # Sign-in page
│   │   └── 📁 sign-up/                      # Sign-up page
│   ├── 📁 api/ -----------------------------# API endpoints
│   │   ├── 📄 courses/                      # Course management
│   │   ├── 📄 generate-course-outline/      # AI course generation
│   │   ├── 📄 generate-study-content/       # Study material creation
│   │   ├── 📄 mathai/                       # Math AI assistant
│   │   └── 📄 study-type-content/           # Content type management
│   ├── 📁 course/[courseId]/----------------# Dynamic course pages
│   │   ├── 📁 flashcards/                   # Interactive flashcards
│   │   ├── 📁 notes/                        # Course notes
│   │   ├── 📁 quiz/                         # Gamified quizzes
│   │   └── 📁 qa/                           # Q&A sessions
│   ├── 📁 create/---------------------------# Course creation wizard
│   ├── 📁 dashboard/------------------------# User dashboard
│   │   ├── 📁 analytics/                    # Learning analytics
│   │   ├── 📁 courses/                      # Course management
│   │   ├── 📁 mathai/                       # Math AI interface
│   │   └── 📁 profile/                      # User profile
│   ├── 📄 layout.js                         # Root layout
│   ├── 📄 page.js                           # Landing page
│   └── 📄 provider.js                       # Context providers
├── 📁 configs/------------------------------# Configuration files
│   ├── 📄 AiModel.js                        # Gemini AI configuration
│   ├── 📄 db.js                             # Database connection
│   └── 📄 schema.js                         # Database schema
├── 📁 components/---------------------------# Reusable components
│   └── 📁 ui/                               # UI component library
├── 📁 hooks/--------------------------------# Custom React hooks
└── 📁 public/-------------------------------# Static assets

Data Flow Architecture

User Authentication: Clerk handles secure user authentication and session management
Course Generation: User input → API → Google Gemini AI → Structured course content
Content Storage: Generated content → Drizzle ORM → Neon PostgreSQL
Real-time Updates: Database changes → UI updates via React state management
AI Assistance: User queries → MathAI API → Gemini processing → Formatted responses

🚀 Installation

Prerequisites

Node.js 18.0 or higher
npm or yarn package manager
Git for version control

Quick Start

Clone the Repository

git clone https://github.com/Hrishubh/BotSensei-AI-LMS.git
cd BotSensei-AI-LMS

Install Dependencies

npm install
# or
yarn install

Environment Setup Create a .env.local file in the root directory:

# Clerk Authentication
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=pk_test_your_clerk_key
CLERK_SECRET_KEY=sk_test_your_clerk_secret

# Database Configuration
DATABASE_CONNECTION_STRING=postgresql://username:password@host/database

# AI Integration
GEMINI_API_KEY=your_google_gemini_api_key

# Optional: Development Settings
NODE_ENV=development

Database Setup

# Push database schema
npm run db:push

# Open Drizzle Studio (optional)
npm run db:studio

Start Development Server

npm run dev
# or
yarn dev

Visit http://localhost:3000 to see the application running.

📡 API Documentation

Core Endpoints

Endpoint	Method	Description	Parameters
`/api/courses`	GET/POST	Course management	`userId`, `courseId`
`/api/create-user`	POST	User registration	`name`, `email`
`/api/generate-course-outline`	POST	AI course generation	`topic`, `difficulty`, `courseType`
`/api/generate-study-content`	POST	Study material creation	`courseId`, `contentType`
`/api/mathai`	POST	Math problem solving	`question`, `context`
`/api/study-type-content`	GET/POST	Content type management	`courseId`, `type`
`/api/generation-status`	GET	Check generation progress	`courseId`

Request/Response Examples

Generate Course Outline

// POST /api/generate-course-outline
{
  "courseId": "uuid-string",
  "topic": "Machine Learning Basics",
  "difficultyLevel": "Medium",
  "courseType": "Exam",
  "createdBy": "user@example.com"
}

// Response
{
  "success": true,
  "courseId": "uuid-string",
  "outline": {
    "chapters": [...],
    "objectives": [...],
    "estimatedTime": "4 hours"
  }
}

MathAI Query

// POST /api/mathai
{
  "question": "Solve: 2x + 5 = 15",
  "showSteps": true
}

// Response
{
  "solution": "x = 5",
  "steps": [
    "2x + 5 = 15",
    "2x = 15 - 5",
    "2x = 10",
    "x = 5"
  ],
  "explanation": "..."
}

🗄️ Database Schema

Core Tables

-- Users Table
CREATE TABLE users (
  id SERIAL PRIMARY KEY,
  name VARCHAR NOT NULL,
  email VARCHAR NOT NULL UNIQUE,
  isMember BOOLEAN DEFAULT FALSE,
  created_at TIMESTAMP DEFAULT NOW()
);

-- Study Materials Table
CREATE TABLE studyMaterial (
  id SERIAL PRIMARY KEY,
  courseId VARCHAR NOT NULL,
  courseType VARCHAR NOT NULL,
  topic VARCHAR NOT NULL,
  difficultyLevel VARCHAR DEFAULT 'Easy',
  courseLayout JSON,
  createdBy VARCHAR NOT NULL,
  status VARCHAR DEFAULT 'Generating',
  created_at TIMESTAMP DEFAULT NOW()
);

-- Chapter Notes Table
CREATE TABLE chapterNotes (
  id SERIAL PRIMARY KEY,
  courseId VARCHAR NOT NULL,
  chapterId INTEGER NOT NULL,
  notes TEXT,
  created_at TIMESTAMP DEFAULT NOW()
);

-- Study Type Content Table
CREATE TABLE studyTypeContent (
  id SERIAL PRIMARY KEY,
  courseId VARCHAR NOT NULL,
  content JSON,
  type VARCHAR NOT NULL,
  status VARCHAR DEFAULT 'Generating',
  created_at TIMESTAMP DEFAULT NOW()
);

Relationships

studyMaterial.createdBy → users.email
chapterNotes.courseId → studyMaterial.courseId
studyTypeContent.courseId → studyMaterial.courseId

🤝 Contributing

We welcome contributions from developers of all skill levels! Here's how you can help:

Getting Started

Fork the repository
Create a feature branch: git checkout -b feature/amazing-feature
Make your changes and commit: git commit -m 'Add amazing feature'
Push to the branch: git push origin feature/amazing-feature
Open a Pull Request

🙏 Acknowledgments

Google Gemini AI for providing advanced language model capabilities
Clerk for seamless authentication and user management
Neon Database for reliable serverless PostgreSQL hosting
Vercel for excellent deployment and hosting platform
Next.js Team for the amazing React framework
Open Source Community for the incredible tools and libraries

📞 Contact & Support

Portfolio: https://hrishubh.github.io
LinkedIn: https://www.linkedin.com/in/hrishubh-bhandari/
Email: bhandarihrishubh@gmail.com
GitHub: https://github.com/Hrishubh

Project Links

Live Demo: https://BotSensei-AI-LMS.vercel.app
Repository: https://github.com/Hrishubh/BotSensei-AI-LMS

Built with ❤️ by HRISHUBH BHANDARI

Transforming education through the power of AI

Name		Name	Last commit message	Last commit date
Latest commit History 4 Commits
app		app
components		components
configs		configs
hooks		hooks
pages		pages
public		public
scripts		scripts
.eslintrc.json		.eslintrc.json
.gitattributes		.gitattributes
.gitignore		.gitignore
LICENSE		LICENSE
LICENSE.txt		LICENSE.txt
README.md		README.md
drizzle.config.js		drizzle.config.js
jsconfig.json		jsconfig.json
mdx-components.js		mdx-components.js
middleware.js		middleware.js
next.config.mjs		next.config.mjs
package-lock.json		package-lock.json
package.json		package.json
postcss.config.mjs		postcss.config.mjs
tailwind.config.js		tailwind.config.js
test-button.js		test-button.js
tsconfig.json		tsconfig.json
vercel.json		vercel.json
warmup.mjs		warmup.mjs

Folders and files

Latest commit

History

Repository files navigation

🧠 BotSensei LMS — AI-Powered Learning Management System

🚀 Live Demo

📋 Table of Contents

🎯 Overview

🌟 What Makes BotSensei Special

🚀 Key Features

🎓 AI-Powered Learning Engine

🧮 MathAI Assistant

🎮 Gamified Learning Experience

💾 Advanced Data Management

🛠️ Technology Stack

Frontend Architecture

Backend & Database

UI/UX Libraries

Development Tools

🏗️ Architecture

System Architecture

Project Structure

Data Flow Architecture

🚀 Installation

Prerequisites

Quick Start

📡 API Documentation

Core Endpoints

Request/Response Examples

🗄️ Database Schema

Core Tables

Relationships

🤝 Contributing

Getting Started

🙏 Acknowledgments

📞 Contact & Support

Project Links

About

Resources

License

Licenses found

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages