KeentoLearn - AI-Powered Education Platform

Learn smarter with personalized AI-generated quizzes, notes and study plans

Demo

KeentoLearn is a modern, AI-powered educational platform that helps students create personalized study materials, take adaptive quizzes, and track their learning progress. Built with cutting-edge technologies including Google's Gemini AI, Next.js, and MongoDB.

✨ Features

🧠 Smart Study Notes

• Multiple Format Options: Outline, detailed notes, concise summaries, flashcard format
• AI-Generated Content: Powered by Google Gemini for comprehensive, accurate notes
• PDF Export: Download your notes as professionally formatted PDFs
• Key Point Highlights: Automatically extracted important concepts
• Markdown Support: Rich text formatting with full markdown support

📝 Interactive Quizzes

• Adaptive Difficulty: Questions adjust based on your performance
• Multiple Question Types: Multiple choice, true/false, short answer
• Instant Feedback: Real-time scoring and explanations
• Progress Tracking: Monitor your learning journey
• Custom Topics: Generate quizzes on any subject

📚 Personalized Study Plans

• Goal-Oriented Structure: Tailored to your learning objectives
• Adaptive Timelines: Flexible scheduling that adapts to your pace
• Resource Recommendations: Curated study materials
• Progress Monitoring: Track completion and performance metrics

🎨 Modern User Experience

• Dark/Light Theme: Seamless theme switching
• Responsive Design: Perfect experience across all devices
• Clean Interface: Intuitive, distraction-free design
• Fast Performance: Optimized for speed and efficiency

🚀 Tech Stack

Frontend

• Next.js 15.3.2 - React framework with App Router
• TypeScript - Type-safe development
• TailwindCSS - Utility-first CSS framework
• Radix UI - Accessible component primitives
• Lucide React - Beautiful icons

Backend & Database

• MongoDB - NoSQL database
• NextAuth.js - Authentication
• bcryptjs - Password hashing

AI & APIs

• Google Gemini AI - Content generation
• @google/generative-ai - Gemini SDK

Additional Tools

• React Markdown - Markdown rendering
• jsPDF - PDF generation
• Sonner - Toast notifications

🛠️ Installation & Setup

Prerequisites

• Node.js 18+
• npm/yarn/pnpm
• MongoDB database
• Google AI API key

Clone the Repository

git clone KeentoLearn-App
cd KeentoLearn-App

Install Dependencies

npm install
# or
yarn install
# or
pnpm install

Environment Setup

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

# Database
MONGODB_URI=your_mongodb_connection_string

# Authentication
NEXTAUTH_URL=http://localhost:3000
NEXTAUTH_SECRET=your_nextauth_secret

# Google AI
GOOGLE_API_KEY=your_google_gemini_api_key

Run Development Server

npm run dev
# or
yarn dev
# or
pnpm dev

Open http://localhost:3000 in your browser.

📁 Project Structure

keentolearn/
├── app/                          # Next.js App Router
│   ├── layout.tsx               # Root layout with providers
│   ├── page.tsx                 # Landing page
│   ├── globals.css              # Global styles
│   ├── about/                   # About page
│   ├── api/                     # API routes
│   ├── dashboard/               # User dashboard
│   ├── login/                   # Authentication pages
│   ├── notes/                   # Notes pages
│   │   ├── page.tsx            # Notes listing
│   │   ├── create/             # Create notes
│   │   └── [id]/               # Individual note view
│   └── quizzes/                # Quiz pages
├── components/                  # Reusable UI components
│   ├── ui/                     # Base UI components
│   ├── auth-provider.tsx       # Authentication provider
│   ├── navbar.tsx              # Navigation component
│   └── theme-provider.tsx      # Theme provider
├── lib/                        # Utilities and actions
│   ├── actions/               # Server actions
│   │   ├── notes-actions.ts   # Notes CRUD operations
│   │   └── quiz-actions.ts    # Quiz operations
│   ├── db/                    # Database utilities
│   └── utils.ts               # Helper functions
├── public/                     # Static assets
└── package.json               # Dependencies and scripts

🎯 Usage Guide

Creating Study Notes

1. Navigate to Notes → Create Notes
2. Enter your topic and select format/length preferences
3. Add optional additional information for context
4. Click Generate Notes and wait for AI processing
5. View, edit, or download your generated notes as PDF

Taking Quizzes

1. Go to Quizzes → Create Quiz
2. Specify topic, difficulty, and question count
3. Take the adaptive quiz with instant feedback
4. Review results and track your progress

Managing Study Plans

1. Access Dashboard for overview
2. Create personalized study schedules
3. Track progress across different subjects
4. Get AI-powered recommendations

🔧 Scripts

# Development
npm run dev          # Start development server

# Production
npm run build        # Build for production
npm run start        # Start production server

# Code Quality
npm run lint         # Run ESLint

🌐 Deployment

Vercel (Recommended)

1. Push your code to GitHub
2. Connect your repository to Vercel
3. Add environment variables in Vercel dashboard
4. Deploy automatically on every push

Manual Deployment

npm run build
npm run start

🔐 Environment Variables

Variable	Description	Required
MONGODB_URI	MongoDB connection string	✅
NEXTAUTH_URL	Application URL	✅
NEXTAUTH_SECRET	NextAuth secret key	✅
GOOGLE_API_KEY	Google Gemini API key	✅

🤝 Contributing

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

📝 API Routes

Notes API

• POST /api/notes - Create new notes
• GET /api/notes - Get user notes
• GET /api/notes/[id] - Get specific note
• DELETE /api/notes/[id] - Delete note

Quiz API

• POST /api/quiz - Generate quiz
• GET /api/quiz/[id] - Get quiz data
• POST /api/quiz/[id]/submit - Submit quiz answers

🔧 Key Features Implementation

AI Content Generation

The platform uses Google's Gemini AI for generating educational content:

const genAI = new GoogleGenerativeAI(process.env.GOOGLE_API_KEY!)
const model = genAI.getGenerativeModel({ model: "gemini-1.5-flash" })

PDF Export

Notes can be exported as PDFs using jsPDF:

import jsPDF from "jspdf"
// PDF generation logic in notes/[id]/page.tsx

Theme System

Dark/light theme support with system preference detection:

<ThemeProvider attribute="class" defaultTheme="dark" enableSystem>

📱 Responsive Design

The application is fully responsive and optimized for:

• 📱 Mobile devices (320px+)
• 📱 Tablets (768px+)
• 💻 Desktop (1024px+)
• 🖥️ Large screens (1280px+)

🐛 Troubleshooting

Common Issues

Authentication Issues

• Verify NEXTAUTH_SECRET is set
• Check MongoDB connection
• Ensure proper environment variables

AI Generation Failures

• Verify Google API key is valid
• Check API quota limits
• Ensure network connectivity

Build Errors

• Clear .next folder: rm -rf .next
• Reinstall dependencies: npm install
• Check TypeScript errors: npm run lint

📊 Performance

• Core Web Vitals: Optimized for excellent scores
• Code Splitting: Automatic route-based splitting
• Image Optimization: Next.js Image component
• Caching: Strategic caching for better performance

🔒 Security

• Authentication: Secure session management
• Input Validation: Server-side validation
• SQL Injection: MongoDB prevents SQL injection
• XSS Protection: Content sanitization

Screenshots

👨‍💻 Author

Built with ❤️ by cyrixninja

🙏 Acknowledgments

• Next.js for the amazing React framework
• Google AI for powerful AI capabilities
• Vercel for seamless deployment
• TailwindCSS for beautiful styling
• Radix UI for accessible components

---

Ready to revolutionize your learning experience? Start with KeentoLearn today! 🚀