Skip to content

letsbegincode/Masterly--personalised-learning

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

2 Commits
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸš€ Masterly – Personalized Learning Platform

Masterly is a modern, fast, and interactive learning platform that offers personalized paths to master skills. Built with the MERN stack and tailored for developers and learners seeking structure and engagement.

🌐 Access it live here:: Masterly

πŸ–ΌοΈ Homepage Preview

Here's a quick look at the Masterly homepage

Homepage Interactive UI


✨ Features

🎯 Core Learning Features

  • πŸ” Secure Authentication (Email/Password + Google OAuth)
  • 🧠 Interactive DSA Course with video lectures, quizzes, and coding problems
  • πŸ“ˆ User Progress Tracking (concept-wise + topic-wise)
  • 🎯 Personalized dashboards with statistics & quick actions
  • πŸ§‘β€πŸ« Instructor profiles & course ratings
  • πŸ—‚οΈ Modular & scalable course structure (concepts β†’ topics β†’ content)

πŸ§ͺ Assessment & Testing

  • πŸ“ Adaptive Quiz System with anti-cheating measures
  • 🎯 Mock Tests and Course Assessments
  • ⏱️ Timed Assessments with real-time monitoring
  • πŸ“Š Detailed Performance Analytics
  • πŸ”„ Retake Options with different question sets

πŸ’» Coding Platform

  • πŸ–₯️ Integrated Code Editor with syntax highlighting
  • 🐍 Multi-language Support (Python, Java, C++, JavaScript)
  • βœ… Automated Test Execution
  • πŸ“‹ Problem-solving Interface
  • 🎯 Real-time Code Validation

πŸ“Š Analytics & Insights

  • πŸ“ˆ Progress Visualization with charts and graphs
  • 🎯 Learning Path Recommendations
  • πŸ“Š Performance Metrics and mastery scores
  • πŸ“… Study Time Tracking
  • πŸ† Achievement System with badges and rewards

πŸ€– AI-Powered Features

  • 🧠 Personalized Learning Paths based on user progress
  • 🎯 Adaptive Content Recommendations
  • πŸ“š Smart Concept Sequencing
  • πŸ” Intelligent Search across courses and concepts
  • πŸ“ˆ Predictive Analytics for learning outcomes

πŸ› οΈ Tech Stack

Tech Purpose
Next.js 15 App Router + React 19 support
Express.js Backend API & Auth
MongoDB Atlas Data storage (Courses, Users)
Mongoose ODM for MongoDB
Tailwind CSS Styling and UI
Zustand Global state (auth)
Vercel + Render Deployment
React 19 Frontend Framework (UI/UX)
TypeScript Static typing, cleaner codebase
Radix UI Accessible component library
OpenAI API AI-powered recommendations
JWT + Passport Authentication & authorization

πŸ—οΈ Architecture

Frontend Architecture

Masterly/frontend/
β”œβ”€β”€ app/                    # Next.js 15 App Router
β”‚   β”œβ”€β”€ dashboard/         # User dashboard & analytics
β”‚   β”œβ”€β”€ courses/          # Course browsing & enrollment
β”‚   β”œβ”€β”€ quiz/             # Quiz platform & assessments
β”‚   β”œβ”€β”€ coding-platform/  # Code editor & problems
β”‚   β”œβ”€β”€ learning-paths/   # AI-generated learning paths
β”‚   β”œβ”€β”€ admin/            # Admin panel
β”‚   β”œβ”€β”€ auth/             # Authentication pages
β”‚   └── [other routes]    # Profile, settings, help, etc.
β”œβ”€β”€ components/           # Reusable UI components
β”‚   β”œβ”€β”€ ui/              # Radix UI components (50+)
β”‚   β”œβ”€β”€ quiz-platform.tsx # Advanced quiz system
β”‚   β”œβ”€β”€ problem-solver.tsx # Coding interface
β”‚   β”œβ”€β”€ DSAQuizEngine.tsx # DSA-specific quiz engine
β”‚   └── [other components] # Sidebars, auth guards, etc.
β”œβ”€β”€ lib/                 # Utilities & API client
β”œβ”€β”€ hooks/               # Custom React hooks
└── [config files]       # Package.json, configs, etc.

Backend Architecture

Masterly/backend/
β”œβ”€β”€ src/
β”‚   β”œβ”€β”€ models/          # MongoDB schemas (12 models)
β”‚   β”‚   β”œβ”€β”€ userModel.ts # Comprehensive user model
β”‚   β”‚   β”œβ”€β”€ courseModel.ts # Course & content model
β”‚   β”‚   └── [other models] # Progress, assessment, etc.
β”‚   β”œβ”€β”€ routes/          # API endpoints (12 routes)
β”‚   β”‚   β”œβ”€β”€ authRoutes.ts # Authentication
β”‚   β”‚   β”œβ”€β”€ courseRoutes.ts # Course management
β”‚   β”‚   └── [other routes] # Quiz, admin, dashboard, etc.
β”‚   β”œβ”€β”€ controllers/     # Business logic
β”‚   β”œβ”€β”€ middlewares/     # Auth & validation
β”‚   β”œβ”€β”€ config/          # Configuration files
β”‚   └── utils/           # Helper functions
└── [config files]       # Package.json, scripts, etc.

πŸš€ Getting Started

Prerequisites

  • Node.js 18+
  • MongoDB Atlas account
  • OpenAI API key (for AI features)

Frontend Setup

cd Masterly/frontend
npm install
npm run dev

Backend Setup

cd Masterly/backend
npm install
npm run dev

Environment Variables

# Frontend (.env.local)
NEXT_PUBLIC_API_URL=http://localhost:5000

# Backend (.env)
PORT=5000   //The port for your local Express server
MONGO_URI=  // The connection string to your cloud database on MongoDB Atlas
JWT_SECRET=your_super_secret_and_long_string_for_jwt
CLIENT_URL=http://localhost:3000

# --- NEW OAUTH 2.0 VARIABLES ---
GOOGLE_CLIENT_ID=
GOOGLE_CLIENT_SECRET=
GOOGLE_CALLBACK_UR=http://localhost:5000/api/auth/google/callback

# --- EMAIL VARIABLES ---
# These are the credentials from your Mailtrap Sandbox inbox
EMAIL_HOST=
EMAIL_PORT=
EMAIL_USER=
EMAIL_PASSWORD=
EMAIL_FROM=

πŸ“Š Database Schema

User Model

  • Profile: Personal info, avatar, bio, social links
  • Subscription: Plan details, billing, payment methods
  • Stats: Study time, progress, achievements, streaks
  • Preferences: Learning settings, notifications, privacy
  • Enrollments: Course progress, certificates, ratings

Course Model

  • Content: Title, description, instructor, pricing
  • Structure: Concepts, topics, videos, articles
  • Stats: Students, ratings, completion rates
  • Metadata: Tags, requirements, learning outcomes

Assessment Model

  • Quizzes: Questions, answers, explanations
  • Tests: Mock tests, course assessments
  • Progress: User attempts, scores, time tracking
  • Analytics: Performance metrics, mastery scores

πŸ”’ Security Features

  • JWT Authentication with secure token management
  • Google OAuth 2.0 integration
  • Password Hashing with bcrypt
  • CORS Protection with whitelisted origins
  • Input Validation with express-validator
  • Anti-cheating Measures in quiz platform
  • Rate Limiting on API endpoints
  • Secure Cookie Management

πŸ“ˆ Performance Optimizations

  • Next.js 15 with App Router for optimal routing
  • React 19 with concurrent features
  • MongoDB Indexing for fast queries
  • Image Optimization with Next.js Image component
  • Code Splitting and lazy loading
  • CDN Integration for static assets
  • Caching Strategies for API responses

πŸ§ͺ Testing & Quality

  • TypeScript for type safety
  • ESLint for code quality
  • Prettier for code formatting
  • Input Validation on all forms
  • Error Handling with proper logging
  • API Testing with comprehensive endpoints
  • UI Testing with component isolation

πŸš€ Deployment

Frontend (Vercel)

  • Automatic deployments from Git
  • Edge functions for API routes
  • Global CDN for fast loading
  • Environment variable management

Backend (Render)

  • Automatic scaling based on traffic
  • Health checks and monitoring
  • SSL certificate management
  • Database connection pooling

Deployment links

🌐 Live Frontend: https://masterly-deploy-henna.vercel.app/
πŸ”— Live Backend API: https://masterly.onrender.com


πŸ† Acknowledgments

  • Next.js Team for the amazing framework
  • Vercel for seamless deployment
  • MongoDB for reliable database
  • OpenAI for AI capabilities
  • Radix UI for accessible components
  • Tailwind CSS for beautiful styling

Built with ❀️ by the Masterly Team

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages