Home
Softono
lets-learn-lms

lets-learn-lms

Open source TypeScript
GitHub
12
Stars
5
Forks
5
Issues
1
Watchers
1 week
Last Commit
LMS

About lets-learn-lms

LMS built with Next, Tailwind, NestJS and Prisma

Platforms

Web Self-hosted

Languages

TypeScript

Links

Source Code
a
Published by
aialvi
Visit View Profile

README.md

View on GitHub

Let's Learn LMS

A full-stack learning management system built with Next.js, NestJS, Prisma, and SQLite. The product includes course delivery, video progress tracking, admin management, learner dashboards, and AI-powered study coach.

Features

Learners

  • Browse courses and view course details.
  • Enroll in courses and continue lessons from the dashboard.
  • Track video watch time, completed lessons, and course progress.
  • Use the learner cockpit for skill readiness, microlearning drills, and recent activity.
  • Ask the AI study coach for lesson-aware guidance, quizzes, study plans, and proof-of-learning prompts.

Growth LMS Features

  • Skills-based learning paths and recommended next actions.
  • AI coach workflow backed by OpenRouter.
  • Microlearning drills for recall and retention.
  • Learner health signals based on progress and completion activity.
  • Credential and social-learning positioning on the homepage.

Admin

  • Manage users, courses, and lessons.
  • View platform-level dashboard stats.
  • Role-based access for students, instructors, and admins.

Tech Stack

Frontend

  • Next.js 15 App Router
  • React 19
  • TypeScript
  • Tailwind CSS
  • Radix UI primitives
  • NextAuth.js
  • Axios

Backend

  • NestJS
  • TypeScript
  • Prisma ORM
  • SQLite for local development
  • Passport JWT authentication
  • Swagger/OpenAPI docs
  • OpenRouter chat completions API

Project Structure

lets-learn/
├── backend/
│   ├── prisma/
│   ├── src/
│   │   ├── admin/
│   │   ├── ai/
│   │   ├── auth/
│   │   ├── courses/
│   │   ├── enrollments/
│   │   ├── lessons/
│   │   ├── progress/
│   │   ├── prisma/
│   │   └── users/
│   ├── .env.example
│   └── package.json
├── frontend/
│   ├── app/
│   ├── components/
│   ├── lib/
│   ├── .env.example
│   └── package.json
└── README.md

Prerequisites

  • Node.js 18 or newer
  • npm for the backend
  • pnpm or npm for the frontend
  • OpenRouter API key for live AI coach responses

Environment Setup

Create local env files from the examples:

cp backend/.env.example backend/.env
cp frontend/.env.example frontend/.env.local

Backend .env

PORT=3001
FRONTEND_URL=http://localhost:3000
JWT_SECRET=change-me-in-production
OPENROUTER_API_KEY=
OPENROUTER_MODEL=openrouter/auto

Set OPENROUTER_API_KEY to a real key from https://openrouter.ai/keys to enable the AI study coach. Keep real keys out of git.

Frontend .env.local

NEXT_PUBLIC_API_URL=http://localhost:3001
NEXTAUTH_URL=http://localhost:3000
NEXTAUTH_SECRET=change-me-in-production

Install

cd backend
npm install

cd ../frontend
pnpm install

If you prefer npm in the frontend, use npm install; the repo currently includes a pnpm lockfile.

Database

cd backend
npx prisma generate
npx prisma migrate deploy

For local schema changes during development:

npx prisma migrate dev

Run Locally

Start the backend:

cd backend
npm run start:dev

Start the frontend:

cd frontend
pnpm dev

Local URLs:

AI Study Coach

The dashboard AI Coach tab calls:

POST /ai/study-coach

The endpoint:

  • Requires JWT authentication.
  • Reads OPENROUTER_API_KEY and OPENROUTER_MODEL from backend env.
  • Enriches the learner prompt with enrolled courses, lessons, video progress, and watch time.
  • Sends a bounded chat completion request to OpenRouter.
  • Returns the coach response, model, generation id, and token usage when provided.

The default model is:

OPENROUTER_MODEL=openrouter/auto

You can replace it with a specific OpenRouter model id.

Main API Areas

Auth

  • POST /auth/register
  • POST /auth/login

Courses

  • GET /courses
  • GET /courses/:id
  • POST /courses
  • PATCH /courses/:id
  • DELETE /courses/:id

Lessons

  • GET /lessons
  • POST /lessons
  • PATCH /lessons/:id
  • DELETE /lessons/:id

Enrollments

  • POST /enrollments
  • GET /enrollments/my-courses
  • PUT /enrollments/progress
  • GET /enrollments/:courseId/status

Progress

  • GET /progress/video/:courseId
  • GET /progress/video/lesson/:lessonId
  • PUT /progress/video

AI

  • POST /ai/study-coach

Admin

  • GET /admin/dashboard
  • GET /admin/users
  • POST /admin/users
  • GET /admin/courses
  • POST /admin/courses
  • GET /admin/lessons
  • POST /admin/lessons

Scripts

Backend

npm run start:dev
npm run build
npm run start:prod
npm run test
npm run lint

Frontend

pnpm dev
pnpm build
pnpm start
pnpm lint

Verification

Run both builds before shipping:

cd backend
npm run build

cd ../frontend
pnpm build

Deployment Notes

  • Set production JWT_SECRET, NEXTAUTH_SECRET, NEXTAUTH_URL, FRONTEND_URL, and OPENROUTER_API_KEY.
  • Run npx prisma migrate deploy during backend deployment.
  • Restart the backend after changing OpenRouter env values.
  • Do not expose OPENROUTER_API_KEY to the frontend. The frontend should call the protected backend AI endpoint.