Learnify

A modern, full-stack Learning Management System (LMS) built with Next.js 15 and NestJS

---

🎯 Overview

Learnify is a production-ready Learning Management System that enables course creators to build, manage, and sell online courses with integrated video streaming, payment processing, and certificate generation.

✨ Key Features

Feature	Description
📚 Course Management	Create courses with chapters, lessons, and rich content using a TipTap-based editor
🎬 Video Streaming	HLS video delivery via Mux with playback tracking and resume functionality
💳 Payment Integration	Razorpay payment gateway with refund support
🎓 Certificates	Auto-generated PDF certificates upon course completion
👥 Multi-Role System	Admin, Instructor, Student, and Support roles with granular permissions
📊 Analytics Dashboard	Track enrollments, revenue, and student progress
🔔 Notifications	In-app notification system for course updates
⭐ Reviews & Ratings	Student review system with moderation

---

🏗️ Architecture

learnify/
├── api/                    # NestJS Backend API
│   ├── src/
│   │   ├── core/           # Core utilities, guards, decorators
│   │   ├── features/       # Feature modules
│   │   │   ├── admin/              # Admin operations
│   │   │   ├── assets/             # File/media asset management
│   │   │   ├── auth/               # Authentication (Better Auth)
│   │   │   ├── course-management/  # Courses, chapters, lessons
│   │   │   ├── mux/                # Video processing & streaming
│   │   │   ├── payment/            # Razorpay integration
│   │   │   ├── review/             # Course reviews
│   │   │   ├── notification/       # In-app notifications
│   │   │   └── support/            # Contact & feedback
│   │   └── infrastructure/  # Database, email, storage
│   └── prisma/              # Database schema & migrations
│
└── app/                     # Next.js Frontend
    └── src/
        ├── app/
        │   ├── (admin)/     # Admin dashboard
        │   ├── (auth)/      # Login, signup, password reset
        │   ├── (landing)/   # Public pages (home, courses, about)
        │   ├── (student)/   # Student portal
        │   └── course/      # Course player & consumption
        ├── components/      # Reusable UI components
        ├── hooks/           # Custom React hooks
        ├── services/        # API client services
        └── lib/             # Utilities & configurations

---

🛠️ Tech Stack

Backend (API)

Technology	Purpose
NestJS	Node.js framework with modular architecture
Prisma	Type-safe ORM with PostgreSQL
Better Auth	Authentication library with session management
Mux	Video encoding, hosting & HLS streaming
Razorpay	Payment processing (India-focused)
Cloudflare R2	Object storage for assets
Resend	Transactional email service
Pino	Structured logging
Swagger/Scalar	API documentation

Frontend (App)

Technology	Purpose
Next.js 15	React framework with App Router
React 19	UI library
TailwindCSS	Utility-first CSS
Radix UI	Accessible component primitives
TanStack Query	Server state management
React Hook Form	Form handling with Zod validation
TipTap	Rich text editor for content
Mux Player	Video player component
Recharts	Dashboard charts
Zustand	Client state management

Observability

Tool	Purpose
Sentry	Error tracking & performance monitoring
PostHog	Product analytics
Better Stack	Log management

---

🚀 Quick Start

Prerequisites

• Node.js 18+
• pnpm (recommended) or npm
• PostgreSQL database (or Neon serverless)
• Cloudflare R2 bucket
• Mux account
• Razorpay account

1. Clone & Install

git clone https://github.com/yourusername/learnify.git
cd learnify

# Install API dependencies
cd api && pnpm install

# Install App dependencies
cd ../app && pnpm install

2. Configure Environment

# API configuration
cp api/.env.example api/.env

# App configuration
cp app/.env.example app/.env

Edit both .env files with your credentials:

API Environment Variables

Variable	Description
DATABASE_URL	PostgreSQL connection string
CLOUDFLARE_ACCOUNT_ID	Cloudflare account ID
R2_ACCESS_KEY_ID / R2_SECRET_ACCESS_KEY	R2 storage credentials
MUX_TOKEN_ID / MUX_TOKEN_SECRET	Mux API credentials
RAZORPAY_KEY_ID / RAZORPAY_KEY_SECRET	Razorpay API keys
RESEND_API_KEY	Email service API key
BETTER_AUTH_SECRET	Auth session secret

App Environment Variables

Variable	Description
NEXT_PUBLIC_APP_URL	Frontend URL (e.g., http://localhost:3002)
NEXT_PUBLIC_BACKEND_URL	API URL (e.g., http://localhost:3001)
NEXT_PUBLIC_RAZORPAY_KEY_ID	Public Razorpay key
SENTRY_DSN	Sentry error tracking
NEXT_PUBLIC_POSTHOG_KEY	PostHog analytics key

3. Setup Database

cd api

# Generate Prisma client
pnpm prisma:generate

# Push schema to database
pnpm prisma:push

# (Optional) Seed with sample data
pnpm prisma:seed

4. Run Development Servers

# Terminal 1: API (runs on port 3001)
cd api && pnpm dev

# Terminal 2: App (runs on port 3002)
cd app && pnpm dev

Visit:

• App: http://localhost:3002
• API Docs: http://localhost:3001/docs

---

📁 Database Schema

The Prisma schema defines these core models:

Model	Description
User	Users with roles (Admin, Instructor, Student, Support)
Course	Courses with pricing, categories, and metadata
CourseChapter	Ordered chapters within a course
Lesson	Video or document lessons with content
Enrollment	Student enrollments with progress tracking
Payment	Payment records with Razorpay integration
Certificate	Generated certificates with PDF storage
CourseReview	Student reviews and ratings
Asset	Media files stored in R2 with Mux integration
Notification	In-app notifications

---

📜 Available Scripts

API (/api)

Script	Command	Description
Dev	pnpm dev	Start in watch mode
Build	pnpm build	Compile for production
Start	pnpm start	Run production build
Lint	pnpm check:fix	Lint & fix with Biome
Test	pnpm test	Run unit tests
DB Studio	pnpm prisma:studio	Open Prisma Studio
Migrate	pnpm migrate	Create new migration

App (/app)

Script	Command	Description
Dev	pnpm dev	Start Next.js dev server
Build	pnpm build	Build for production
Analyze	pnpm analyze	Analyze bundle size
Lint	pnpm check:fix	Lint & fix with Biome

---

🐳 Docker

Both services include production-ready Dockerfiles:

# Build API
cd api && docker build -t learnify-api .

# Build App
cd app && docker build -t learnify-app .

---

🔐 User Roles & Permissions

Role	Capabilities
Admin	Full access: manage users, courses, payments, analytics
Instructor	Create/edit courses, view enrollments, manage content
Student	Browse courses, enroll, track progress, get certificates
Support	Handle contact messages and feedback

---

🔗 API Documentation

The API is documented with Swagger/OpenAPI and rendered using Scalar:

• Development: http://localhost:3001/docs
• API Prefix: /api/v1

---

📄 License

This project is unlicensed and intended for private use.

---

Built with ❤️ using modern web technologies