Lms Front

LMS Platform

Open-source, multi-tenant LMS for creators and schools. Every school gets its own subdomain (school.platform.com), its own branding, and its own students. Educators build courses and sell them; students enroll, learn, take exams, and earn verifiable certificates.

[](https://github.com/guillermoscript/lms-front/actions/workflows/ci.yml) [](LICENSE) [](https://nextjs.org) [](https://supabase.com) [](CONTRIBUTING.md)

Live instance: preciopana.com · Setup: [docs/GETTING_STARTED.md](docs/GETTINGSTARTED.md) · Contribute: [CONTRIBUTING.md](CONTRIBUTING.md)

Stack: Next.js 16 · React 19 · TypeScript · Supabase (Postgres + Auth + RLS) · Shadcn UI (base-mira) · Tailwind CSS v4 · Stripe Connect · next-intl (en/es)

What's in it

| | | |--|--| | Multi-tenancy | Subdomain-per-school, tenant theming, per-tenant roles — one deployment, many schools. Isolation is enforced in Postgres with Row Level Security, not in application code. | | Courses | Block-editor lessons with rich MDX components, exercises, checkpoints, exams with AI-assisted grading, progress tracking, FSRS spaced repetition. | | Payments | Stripe Connect (platform fee + revenue split), PayPal, Lemon Squeezy, Solana, Binance, and manual/offline receipts for markets where cards fail. Provider-agnostic contract — adding one is a single module. | | Monetization | One-off products, subscriptions, plan-based feature gating, payouts, invoices, revenue dashboard. Separate platform billing for schools paying you. | | AI tutor | An MCP server (mcp-server/) exposing the LMS as tools + interactive widgets: drill practice, weak-topic remediation, exam readiness, ask-a-teacher. Works from any MCP client, auth'd via Supabase OAuth 2.1 with RLS intact. | | Engagement | XP, levels, streaks, achievements, challenges, weekly leagues, coin store, certificates with public verification, community spaces with polls and moderation. | | Creator tools | AI landing-page generation, drag-and-drop page builder, guided onboarding, guided tours. | | i18n | Full English + Spanish across the app, built for LATAM and English-speaking markets. |

Self-host it, fork it for your own school, or use it as a reference for multi-tenant Supabase + Next.js patterns. MIT licensed.

Prerequisites

• Node.js 20+
• Docker (required for local Supabase)
• Supabase CLI
• Stripe CLI (optional — only for testing webhooks locally)

Quick Start

1. Clone and install

``bash git clone https://github.com/guillermoscript/lms-front.git cd lms-front npm install ``

1. Configure environment

``bash cp .env.example .env.local ` For local Supabase, set these four. Run supabase status (after step 3) and copy its **Publishable** and **Secret** keys — they are local-only dev keys, the same on every machine: `bash NEXT_PUBLIC_SUPABASE_URL=http://127.0.0.1:54321 NEXT_PUBLIC_SUPABASE_PUBLISHABLE_OR_ANON_KEY= SUPABASE_SERVICE_ROLE_KEY= NEXT_PUBLIC_PLATFORM_DOMAIN=lvh.me:3000 ``

1. Start local Supabase (requires Docker)

``bash supabase start npm run db:reset # applies all migrations + seeds tenants, users, courses, products ``

1. Run the dev server

``bash npm run dev ``

1. Open the app at http://lvh.me:3000 — not localhost

Tenant resolution reads the subdomain; lvh.me resolves *.lvh.me to 127.0.0.1. On localhost no tenant resolves and authenticated pages bounce to /join-school.

• http://lvh.me:3000 — Default School (free plan)
• http://code-academy.lvh.me:3000 — Code Academy Pro (enterprise plan)

1. Log in with a seeded account (all passwords password123), on the subdomain matching its tenant:

| Email | Tenant | Role | |--|--|--| | student@e2etest.com | Default School (lvh.me:3000) | student | | owner@e2etest.com | Default School (lvh.me:3000) | admin + super admin | | creator@codeacademy.com | Code Academy (code-academy.lvh.me:3000) | admin | | alice@student.com | Code Academy (code-academy.lvh.me:3000) | student |

Local-dev credentials only — seeded by npm run db:reset.

Full walkthrough — seed contents, migrations, tests, optional services, troubleshooting: [docs/GETTING_STARTED.md](docs/GETTING_STARTED.md).

npm Scripts

| Script | Command | |--------|---------| | npm run dev | Start dev server | | npm run build | Production build (TypeScript + lint) | | npm run lint | Run ESLint | | npm run typecheck | tsc --noEmit | | npm run test:unit | Vitest unit tests | | npm test | Playwright E2E tests (dev server must already be running) | | npm run db:reset | Reset local DB (migrations + seed) | | npm run db:push | Push migrations to cloud Supabase | | npm run db:types | Regenerate lib/database.types.ts | | npm run mcp:build | Build the MCP server sub-project |

Documentation

• [docs/GETTING_STARTED.md](docs/GETTING_STARTED.md) — full local setup guide: env, seed data, migrations, tests, troubleshooting
• [CLAUDE.md](CLAUDE.md) — architecture reference for AI agents and developers
• [docs/DATABASE_SCHEMA.md](docs/DATABASE_SCHEMA.md) — complete DB schema
• [docs/AUTH.md](docs/AUTH.md) — authentication flows
• [docs/MONETIZATION.md](docs/MONETIZATION.md) — billing and payments
• [docs/MCP_SETUP.md](docs/MCP_SETUP.md) — the MCP server and AI tutor tooling

More in [docs/](docs/) — deployment, i18n, gamification, community spaces, the landing-page builder.

Contributing

Contributions are welcome — bug reports, translations, docs fixes, new payment providers, features.

• Read [CONTRIBUTING.md](CONTRIBUTING.md) for the workflow and what reviewers look for
• Browse good first issue and help wanted
• Questions and ideas: Discussions
• Found a vulnerability? [SECURITY.md](SECURITY.md) — please report it privately
• By participating you agree to the [Code of Conduct](CODEOFCONDUCT.md)

License

[MIT](LICENSE) — free to self-host, fork, and build a business on.

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: guillermoscript
• Source: guillermoscript/lms-front
• License: MIT
• Homepage: https://preciopana.com

Install and usage instructions live in the source repository linked above.