🌙Toggle Theme
HomeAboutServices Products Textile ERP Bakery Smart POS Restaurants Matrimony Billing Software NeoInvoice LMS Contact
🏫 Education & Training Platform

The complete
Learning Management
System

Connect students and instructors through structured courses, live sessions, auto-graded quizzes, and verified certificates — fully self-hosted, no external dependencies, entirely yours.

A
My Learning Dashboard
3 courses in progress
📚
Textile Business Management
12 lessons · 4h 30m
72%
📊
GST & Compliance Basics
8 lessons · 2h 15m
🎓 Done
🅾
POS & Billing Training
6 lessons · 1h 45m
35%
🎓 2 Certificates
⛳ 48 hrs Completed
🏆 Top Learner
3
User Roles
16
Pages / Views
28+
API Endpoints
12
DB Tables
4
Content Types

CrunkTechSoft LMS is a full-featured Learning Management System that connects students with instructors through structured course content, live sessions, quizzes, and certified learning paths. Completely self-hosted — all videos, documents, and thumbnails stored on your own server with zero external CDN or streaming platform dependency.

Three distinct roles — each with a dedicated navigation experience, permission set, and dashboard.

🏫
Student
Default role on signup
Learner Access
  • Register & login via JWT-secured session
  • Browse and search all published courses
  • Enrol in any published course for free — one click
  • Access video lessons, read documents, view text content
  • Preview free lessons without enrolling
  • Take timed, auto-graded quizzes with instant feedback
  • Track lesson-by-lesson progress with visual progress bar
  • Join live sessions via Zoom/Meet link
  • Auto-receive certificate on 100% course completion
  • View and download certificates with unique number
  • Personal dashboard: stats, continue-learning cards, upcoming live sessions
  • Edit own profile name and bio
👨‍🏫
Instructor
Created by Admin or self-registered
Course Creator
  • Dedicated dashboard: student count and course stats
  • Create courses: title, description, category, level, duration
  • Upload thumbnail (JPG/PNG/WebP, max 5 MB)
  • Organise content into Sections (chapters/modules)
  • Add Lessons — 4 types: Video, Document, Live, Quiz
  • Upload videos (MP4/WebM, up to 500 MB)
  • Upload documents (PDF/DOCX, up to 50 MB)
  • Mark individual lessons as "Free Preview"
  • Create multi-question quizzes with A/B/C/D options
  • Set quiz time limits and pass percentage threshold
  • Schedule live sessions with Zoom/Meet URL
  • Update status: Scheduled → Live → Ended
  • Publish or unpublish courses at any time
  • Delete courses — cascades to all sections, lessons, enrolments
🛡
Admin
Full platform control
Full Access
  • Platform-wide stats: users, courses, enrolments, certificates
  • Create accounts for any role: Student, Instructor, Admin
  • Edit any user: name, role, bio, reset password, activate/suspend
  • Delete any user account permanently
  • Search users by name/email, filter by role
  • View all courses across all instructors
  • Publish or unpublish any course on the platform
  • Delete any course from the platform
  • Full Instructor capabilities — create and manage own courses
  • Role breakdown charts and quick-action shortcuts on overview

Complete platform lifecycle — from user registration through course completion and certificate issuance.

🏫 Student Journey
01
Onboarding
Register & Login
Student visits /register, enters name, email, password. System creates account and issues JWT token (24h). Redirected to Dashboard.
POST /auth/registerJWT issued
02
Discovery
Explore Courses
Browse /explore — search by keyword, filter by level (beginner / intermediate / advanced). See course cards with instructor name, lesson count, enrolment count.
GET /coursesPublic route
03
Enrolment
Enrol in Course
Student clicks "Enrol Free" on the course detail page. System records enrolment. Access to all lessons granted immediately.
POST /courses/:id/enrollRequires JWT
04
Learning
Watch & Complete Lessons
Works through sections and lessons. Videos stream from server. Each lesson has a "Mark Complete" button. Progress saved per lesson.
POST /lessons/:id/completeProgress tracked
05
Assessment
Take Quiz
Countdown timer presents multiple-choice questions. Submit to instantly receive score, pass/fail result, and correct-answer review.
POST /quizzes/:id/submitAuto-graded
06
Completion
Earn Certificate
When all lessons are marked complete, system auto-issues a certificate with unique ID (CERT-userId-courseId-timestamp). View and download on /certificates.
Auto-issuedUnique cert number
👨‍🏫 Instructor Journey
01
Setup
Login as Instructor
JWT contains role=instructor. Sidebar shows instructor-specific nav: Dashboard, Create Course, Schedule Live.
Role-based UIJWT payload
02
Creation
Create Course
Fill form: title, description, category, level, duration. System generates unique slug. Course starts as Draft (unpublished).
POST /coursesDraft state
03
Build
Add Sections & Lessons
Add sections (chapters), then lessons inside each. Upload videos or documents via the built-in file uploader. Set free-preview flags per lesson.
POST /lessons/sectionsPOST /upload/:type
04
Assessment
Create Quiz
2-step wizard: set title, time limit, pass percentage → add questions with 4 options each, mark correct answer. Quiz attaches to a quiz-type lesson.
POST /quizzesMulti-question
05
Live
Schedule Live Class
Create live session: title, course link, date/time, duration, Zoom/Meet URL. Update status: Scheduled → Live → Ended.
POST /liveStatus lifecycle
06
Launch
Publish Course
Click Publish toggle — course becomes visible in Explore. Students can now enrol. Instructor can unpublish anytime to hide from new enrolments.
is_published = truePUT /courses/:id
🛡 Admin Operations
📊

Platform Monitoring

Total users, courses, enrolments, certificates. Recent signups and role breakdown with percentage bars.

👥

User Management

Create any role account. Edit name, role, bio, password. Suspend, activate, or delete permanently.

📋

Content Oversight

View all courses across all instructors. See enrolment counts and published vs draft ratio platform-wide.

⚙️

Course Control

Publish or unpublish any course. Delete any course from the platform. Full instructor access for admin-owned content.

Detailed breakdown of every module, screen, and capability available in the platform.

📚

Course Management

Create, edit, delete courses. Thumbnail upload. Publish/draft toggle. Category + level + duration metadata. Slug auto-generated from title.

📁

Curriculum Builder

Organise content into Sections. Each section holds unlimited Lessons. 4 lesson types: Video, Document, Live, Quiz. Order-indexed for sequence control.

🎬

Video Lessons

Upload MP4/WebM up to 500 MB. Stored in /uploads/videos/. HTML5 video player with full controls. Served via Express static — no external streaming needed.

📄

Document Lessons

Upload PDF/DOCX up to 50 MB. Students get a direct download/open link. Supports text notes alongside documents.

✏️

Quiz System

Countdown timer. Multiple choice A/B/C/D. Auto-graded on submit. Pass/fail by instructor-set threshold. Best attempt tracked. Full answer review shown after.

📡

Live Sessions

Schedule with date, time, duration, and Zoom/Meet URL. Status lifecycle: Scheduled → Live → Ended. Students see upcoming sessions on their dashboard.

📈

Progress Tracking

Per-lesson completion stored in DB. Per-course progress % calculated from completed/total lessons. Progress bar on course cards and detail page.

🏆

Auto Certificates

On 100% lesson completion, system auto-issues a certificate with unique number (CERT-userId-courseId-timestamp). Displayed as visual certificate cards — downloadable.

🔍

Explore & Search

Full-text search on course title and instructor name (PostgreSQL ILIKE). Filter by level. Paginated results (12 per page). Open to non-enrolled users.

🔒 Free Preview Feature

Instructors can mark individual lessons as "Free Preview" — accessible by anyone without enrolling. Students sample content before committing, significantly increasing enrolment conversion.

📁 File Storage Architecture

All files stored on the server under /backend/uploads/videos/, /documents/, and /thumbnails/. Served as Express static assets. Naming convention: {type}_{userId}_{timestamp}.{ext} to prevent collisions.

JWT-based stateless authentication with role-based access control across all API endpoints.

Client (React)
1. Login / Register
POST credentials to /api/auth/login
2. Store Token
JWT saved in localStorage as "lms_token"
3. Every API Request
Axios interceptor adds Authorization: Bearer <token>
4. 401 Received
Token cleared, user redirected to /login
⇇
Server (Node.js)
1. Hash Password
bcryptjs with salt rounds = 10
2. Sign JWT
HS256, payload: {id, email, role, name}, expires: 24h
3. protect() Middleware
Verifies token, checks expiry, attaches req.user
4. authorize(...roles)
Checks req.user.role against allowed roles array
🔐

Password Security

All passwords hashed with bcryptjs (10 salt rounds). Plain passwords never saved in the database. Admin can reset any user's password at any time.

⏱️

Token Expiry

JWT tokens expire after 24 hours. Axios response interceptor catches 401, clears localStorage, and redirects to login. Configurable via JWT_EXPIRES_IN env variable.

🛡

Role Guards

Every sensitive endpoint uses protect() + authorize() middleware. Frontend Route Guards also prevent navigation to restricted pages without the correct role in the JWT payload.

Complete REST API surface. All endpoints return JSON. Authenticated routes require Authorization: Bearer <jwt> header.

Authentication
Method + Route Auth Description
POST /api/auth/register Public Register new user — returns JWT + user object
POST /api/auth/login Public Authenticate with email/password — returns JWT + user object
GET /api/auth/me JWT Get current authenticated user with enrolled course count
PUT /api/auth/me JWT Update own profile name and bio
Courses
Method + Route Auth Description
GET /api/courses Public List published courses — supports ?search, ?level, ?page, ?limit
GET /api/courses/my JWT Get student's enrolled courses with progress % each
GET /api/courses/:id Public Get single course with full sections and lessons curriculum
GET /api/courses/:id/progress JWT Get lesson completion status for a course (student)
POST /api/courses Instructor Create a new course (starts as draft)
PUT /api/courses/:id Instructor Update course fields including publish/unpublish toggle
DELETE /api/courses/:id Instructor Delete own course — cascades all sections, lessons, enrolments
POST /api/courses/:id/enroll Student Enrol authenticated student in course (idempotent)
GET /api/courses/instructor/mine Instructor Get all courses created by the authenticated instructor
Lessons & Sections
Method + Route Auth Description
GET /api/lessons/sections JWT Get all sections with nested lessons for a course (?course_id=)
POST /api/lessons/sections Instructor Add new section to a course
GET /api/lessons/:id JWT Get lesson with content URL, prev/next nav, completion status
POST /api/lessons Instructor Add lesson to section — type: video | document | live | quiz
POST /api/lessons/:id/complete JWT Mark lesson complete; auto-issues certificate if course finished
Quizzes · Live Sessions · Uploads · Dashboard · Admin
Method + Route Auth Description
GET /api/quizzes/:id JWT Get quiz with questions (correct answers hidden) + best attempt
POST /api/quizzes Instructor Create quiz with questions array attached to a lesson
POST /api/quizzes/:id/submit JWT Submit answers — returns score, passed bool, answer review
GET /api/live JWT List live sessions — ?upcoming=1 for future only
POST /api/live Instructor Schedule new live session
PUT /api/live/:id Instructor Update session status: scheduled → live → ended
POST /api/upload/:type Instructor Upload file — type: video | document | thumbnail (multipart/form-data)
GET /api/dashboard/student JWT Student stats: enrolled, completed, lessons done, avg score, certs
GET /api/dashboard/instructor Instructor Instructor stats: course count, total students
GET /api/dashboard/certificates JWT Get all certificates earned by authenticated user
GET /api/dashboard/admin Admin Platform stats + recent users list
GET /api/admin/users Admin Get all users (all roles)
POST /api/admin/users Admin Create new user with any role
PUT /api/admin/users/:id Admin Edit user: name, role, bio, is_active, password reset
DELETE /api/admin/users/:id Admin Permanently delete user account
GET /api/admin/courses Admin Get all courses with enrolment counts
PUT /api/admin/courses/:id Admin Update any course (publish/unpublish)
DELETE /api/admin/courses/:id Admin Delete any course from platform
GET /api/categories Public Get all categories (for dropdowns)

12-table PostgreSQL schema with foreign key constraints, cascading deletes, and JSONB for quiz answer storage.

👤 users
id · name · email · password · role · avatar · bio · is_active · created_at · updated_at
🏷 categories
id · name · slug (UNIQUE) · icon · created_at
📚 courses
id · title · slug · description · thumbnail · instructor_id → users · category_id → categories · level · duration_hours · is_published
📁 sections
id · course_id → courses · title · order_index · created_at
📘 lessons
id · section_id · course_id · title · type · content_url · content_text · duration_minutes · order_index · is_preview
🏫 enrollments
id · user_id → users · course_id → courses · enrolled_at · completed_at
UNIQUE(user_id, course_id)
✅ lesson_progress
id · user_id · lesson_id · course_id · is_completed · completed_at
UNIQUE(user_id, lesson_id)
✏️ quizzes
id · lesson_id → lessons · course_id · title · time_limit_minutes · pass_percentage
❓ quiz_questions
id · quiz_id · question · option_a · option_b · option_c · option_d · correct_option · order_index
📝 quiz_attempts
id · user_id · quiz_id · score · passed · answers (JSONB) · attempted_at
📡 live_sessions
id · course_id · instructor_id · title · description · meeting_url · scheduled_at · duration_minutes · status
🏆 certificates
id · user_id → users · course_id → courses · certificate_number (UNIQUE) · issued_at

🔄 Cascade Delete Strategy

Deleting a Course cascades to: Sections → Lessons → Enrolments → Lesson Progress → Quiz Attempts → Certificates. Deleting a User cascades to all their enrolments, progress, quiz attempts, certificates, and courses. All foreign keys use ON DELETE CASCADE.

Modern, production-ready stack with zero external service dependencies for core functionality — deploy on any VPS with Node.js and PostgreSQL.

Frontend
React 18UI — component-based, hooks
Vite 5Build tool + dev server with HMR
React Router 6Client-side routing + nested routes
AxiosHTTP client + auth interceptors
CSS VariablesDesign system — no framework needed
Backend
Node.js + Express 4REST API server
PostgreSQL + pgDatabase + connection pool
jsonwebtokenJWT sign + verify (HS256)
bcryptjsPassword hashing (10 salt rounds)
multerFile upload middleware
cors + dotenvSecurity + config management
📁

File Storage

Server-local under /uploads/. Videos 500 MB, Documents 50 MB, Thumbnails 5 MB. Served as Express static. Filename collision-safe.

🔒

No External Dependencies

No AWS S3, no Stripe, no Firebase, no Cloudinary. Fully self-contained. Runs on any VPS with Node.js and PostgreSQL.

🚀

Deployment Ready

Frontend builds to static files. Backend runs as a Node process. Compatible with Render, Railway, DigitalOcean, or any Linux server.

Product Info

At a glance

Platform Self-hosted LMS
Roles Student, Instructor, Admin
Content Types Video, Document, Live, Quiz
Database PostgreSQL
Auth JWT HS256 — 24h expiry
File Storage Server-local (no CDN)
Certificates Auto-issued, unique ID + QR
Frontend React 18 + Vite 5
Backend Node.js + Express 4
Support Phone, Email & WhatsApp
Languages Tamil & English

See It Live

Book a free 30-minute demo. We will walk you through setting up your first course, enrolling learners, and issuing certificates — in Tamil or English.

Book Free Demo

Quick Contact

📞
Phone / WhatsApp
+91 9597773308, +91 8526952230
📧
📍
Address
1/3D Thillai Nagar, Rathnapuri,
Coimbatore - 641027, India

Also From CrunkTechSoft

Explore Other Products

🧵 Textile ERP 🥐 Bakery Smart POS 🍽 Restaurants 💍 Matrimony 🧾 Billing Software 📄 NeoInvoice