An AI-powered learning platform that automatically detects Markdown lessons and converts them into interactive study cards with quizzes and progress tracking.

🧠 AI-Generated Quizzes - Automatically creates questions from your lesson content 📚 Interactive Study Cards - Flip-card interface for active learning 📊 Progress Tracking - Comprehensive analytics and learning insights ⚡ Real-time Updates - Automatically detects new lesson files 🎯 Spaced Repetition - Smart scheduling for optimal retention 📱 Responsive Design - Works seamlessly on all devices

# Install backend dependencies
npm install

# Install frontend dependencies
cd client
npm install
cd ..

Place your Markdown (.md) files in the root directory. The system will automatically detect and import them.

Example lessons are already included:

• chatgpt-developer-productivity-guide.md
• programming-projects-job-guide.md

Option A: Use the start script (Windows)

start.bat

Option B: Manual start

# Terminal 1 - Backend
npm run dev:server

# Terminal 2 - Frontend  
cd client
npm run dev

• Frontend: http://localhost:3000
• Backend API: http://localhost:3001/api

The system watches for .md files and automatically:

• Parses the content structure
• Extracts key concepts and examples
• Creates searchable sections
• Generates study materials

For each lesson, the system:

• Analyzes content to identify key concepts
• Creates multiple choice, true/false, and fill-in-the-blank questions
• Provides explanations for each answer
• Adapts difficulty based on content complexity

1. Lesson View: Read the full content with progress tracking
2. Study Mode: Interactive flashcards with flip animations
3. Quiz Mode: Test knowledge with AI-generated questions
4. Progress Dashboard: Analytics and learning insights

Your Markdown lessons should follow this structure for best results:

# Lesson Title

## Overview
Brief introduction and learning objectives

## Key Concepts Explained Simply
Main concepts with clear explanations

## Code or Command Examples
Practical examples with code blocks

## What I Should Try Next
Action items and next steps

• GET /api/lessons - Get all lessons
• GET /api/lessons/:id - Get specific lesson
• POST /api/lessons/:id/progress - Update progress

• POST /api/quizzes/:lessonId/generate - Generate quiz
• GET /api/quizzes/:lessonId/questions - Get questions
• POST /api/quizzes/:lessonId/submit - Submit answer

• GET /api/progress/dashboard - Overall stats
• GET /api/progress/analytics - Detailed analytics

The system uses SQLite for storage with these main tables:

• lessons - Lesson content and metadata
• lesson_sections - Structured content sections
• quiz_questions - AI-generated questions
• user_progress - Learning progress tracking
• quiz_attempts - Quiz performance history

Extend QuizService.js to support additional question formats.

Modify the analytics in Progress.jsx to track specific learning goals.

Customize the UI by editing Tailwind classes in the React components.

Backend:

• Node.js + Express
• SQLite database
• Markdown parsing (gray-matter, marked)
• File watching (chokidar)

Frontend:

• React 18 + Vite
• Tailwind CSS
• React Router
• Recharts (analytics)
• Axios (API calls)

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Test thoroughly
5. Submit a pull request

MIT License - Feel free to use this for personal or commercial projects.

If you encounter any issues:

1. Check the console for error messages
2. Verify your lesson files are valid Markdown
3. Ensure all dependencies are installed
4. Try restarting the servers

For bugs or feature requests, please open an issue with detailed information.

Happy Learning! 🚀