📒JIT Learning - Full-Stack Learning Management System

LMS-MERN: A full-stack Learning Management System with Authentication, Role-based Access, Notes Management, Cloudinary Integration, and Syllabus Uploads.

Built with the tools and technologies:

---

💣 Live Demo: https://lms-learning-management-system.netlify.app/

---

🔗 Quick Links

• 📍 Overview
• 👾 Features
• 🧠 Tech Stack
• 📁 Project Structure
• 🚀 Getting Started
  • ☑️ Prerequisites
  • ⚙️ Installation
  • 🤖 Usage
  • 🧪 Testing
• 📌 Project Roadmap
• 🔰 Contributing
• 🎗 License
• 🙌 Acknowledgments
• 🤝 Connect

---

📍 Overview

LMS-MERN is a full-featured Learning Management System for students and educators. It supports:

• Role-based access (Student, Teacher, Admin)
• Secure authentication (JWT, refresh tokens, OTP)
• Notes upload & approval
• Dynamic syllabus filters
• PDF previews with Cloudinary integration
• Dark/light theme support

---

👾 Features

• 👤 User Authentication: Secure login/signup with JWT, OTP verification.
• 🧑‍🏫 Role Management: Admin, Teacher, Student support.
• 🗂 Notes Uploading & Downloading with unit structure.
• 📚 Syllabus Filters: Based on branch, year, semester.
• 🖼 PDF Preview Modal (Cloudinary-hosted)
• 🔒 Protected Routes with refresh token auto-renewal.
• ☁️ Cloudinary structured uploads.

---

🧠 Tech Stack

Layer	Tech Used
Frontend	React.js + Vite, Tailwind CSS
Backend	Node.js, Express.js
Database	MongoDB + Mongoose
Auth	JWT (Access + Refresh) + Cookies
Cloud Storage	Cloudinary SDK
Email	Gmail for OTP mails

📁 Project Structure

See complete file tree in repo: LMS-MERN

LMS-MERN/
├── Backend/
│   ├── routes/, models/, config/, middleware/, utils/
│   └── index.js
├── Frontend/
│   ├── src/components/* (Admin, Notes, Auth, etc.)
│   ├── public/, assets/, context/
│   └── main.jsx, App.jsx
└── README.md

🚀 Getting Started

☑️ Prerequisites

Before getting started with LMS-MERN, ensure your runtime environment meets the following requirements:

• Programming Language: JavaScript
• Package Manager: Npm
• Node.js ≥ 18
• npm ≥ 9
• MongoDB instance
• Cloudinary credentials

⚙️ Installation

Install LMS-MERN using one of the following methods:

Build from source:

1. Clone the LMS-MERN repository:

❯ git clone https://github.com/abhishekkalme/LMS-MERN

2. Navigate to the project directory:

❯ cd LMS-MERN

3. Install the project dependencies:

Using npm  

❯ cd Backend && npm install
> cd Frontend && npm install

🤖 Usage

Run LMS-MERN using the following command: Using npm  

❯ # In one terminal
cd Backend && npm run dev

# In another
cd Frontend && npm run dev

Visit http://localhost:5173 in your browser.

🧪 Testing

Run the test suite using the following command: Using npm  

❯ npm test

---

📌 Project Roadmap

• Setup Authentication (JWT + OTP + Email)

• PDF Uploading (Cloudinary with folder structure)

• Admin Approval + Feedback

• Role-based UI rendering

• AI-based note summaries (Upcoming 🚀)

• Download Analytics Dashboard

---

🔰 Contributing

• 💬 Join the Discussions: Share your insights, provide feedback, or ask questions.
• 🐛 Report Issues: Submit bugs or feature requests.
• 💡 Submit Pull Requests: Review open PRs and submit your own.

Contributing Guidelines

1. Fork the Repository: Start by forking the project repository to your github account.

2. Clone Locally: Clone the forked repository to your local machine using a git client.

   git clone https://github.com/abhishekkalme/LMS-MERN.git
   cd LMS-MERN

3. Create a New Branch: Always create a new branch for your changes.

   git checkout -b feature/your-feature-name
   

4. Make Your Changes: Implement the changes or fix the issue. Test thoroughly before committing.

5. Commit Your Changes: Commit with a clear message describing your updates.

   git add . 
   git commit -m "Add: Implemented feature XYZ"

6. Push to Your Fork on GitHub: Push your branch to your GitHub repository:

   git push origin feature/your-feature-name
   

7. Open a Pull Request:

• Go to the original LMS-MERN repository.
• Click "Compare & pull request".
• Provide a meaningful PR title and description.
• Submit the pull request.

8. Get Reviewed & Merged: Wait for maintainers to review your PR. Once approved, it will be merged into the main branch.. ✅Congratulations on your contribution!

Contributor Graph

---

🎗 License

This project is protected under the SELECT-A-LICENSE License. For more details, refer to the LICENSE file.

---

🙌 Acknowledgments

List any resources, contributors, inspiration, etc. here. React

• React
• Node.js
• MongoDB
• Cloudinary
• Render
• Netlify
• RGPV Syllabus Data

---

🤝 Connect

• LinkdIn

• Email

---