Sealearn (SEA — Servicio de Evaluación Asistida) is an open-source, full-stack e-learning platform designed to make learning any subject genuinely engaging. It combines a powerful adaptive engine, AI-driven content generation, and deep gamification mechanics — streaks, XP, leagues, shop items, and real-time duels — into a single cohesive product. Whether you are a student working through lessons, an educator building question banks, or an admin managing the platform, Sealearn gives every role a first-class experience.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/DerBasilisk/SEA-ServicioEvaluaconAsistida/llms.txt
Use this file to discover all available pages before exploring further.
Why Sealearn?
Traditional e-learning platforms present static content in a fixed order and grade responses with hard-coded answer keys. Sealearn takes a different approach: the adaptive engine adjusts question difficulty and count based on each learner’s historical performance, while two integrated AI providers generate entirely new questions on demand. The result is a platform that grows alongside its learners rather than repeating the same material indefinitely.Adaptive Learning Engine
Per-user difficulty calibration adjusts the ratio of easy-to-hard questions and total question count dynamically, based on stored
UserProgress data.9 Question Types
Multiple choice, true/false, fill-in-the-blank, order items, match pairs, sentence builder, free text, typing, and Python code exercises — all handled by a single flexible
Question model.AI Question Generation
Groq Llama 3.3-70B (with three-key rotation and circuit breaker) and Google Gemini 2.0 Flash act as primary and fallback AI providers, generating contextually relevant questions from any lesson content.
Real-Time Duels
Challenge friends to live head-to-head quiz battles over Socket.IO. Duel state is stored in Redis, supports in-match modifiers (extra questions, reduced time, blackout), and results are persisted to MongoDB.
Competitive Leagues
Weekly league rooms automatically rank learners by XP. A
node-cron job processes promotions and demotions every Monday at midnight (America/Bogotá timezone).OAuth & Secure Auth
Google OAuth 2.0 and Discord OAuth via Passport.js, alongside traditional email/password registration with bcryptjs hashing, JWT sessions, and email verification via Resend.
Gamification & Shop
Learners earn XP, maintain streaks, unlock achievements, spend hearts on mistakes, and purchase cosmetic items from the in-app shop using earned currency.
Real-Time Chat
Persistent conversations with friends on the
/chat Socket.IO namespace, supporting text messages, image uploads via Cloudinary, typing indicators, and read receipts.Tech Stack
Sealearn is a Node.js monorepo with a clear separation between backend and frontend. Every dependency is pinned and battle-tested.| Layer | Technology |
|---|---|
| Backend runtime | Node.js 18+ with Express 5 (express ^5.2.1) |
| Database | MongoDB via Mongoose 9 (mongoose ^9.2.4) |
| Cache / real-time state | Redis via ioredis (ioredis ^5.10.0) |
| WebSockets | Socket.IO 4 (socket.io ^4.8.1) |
| Frontend framework | React 19 + Vite 7 |
| Styling | Tailwind CSS 3 |
| State management | Zustand 5 |
| Routing | React Router v7 |
| AI — primary | Groq SDK (groq-sdk ^1.1.1) — Llama 3.3-70B |
| AI — fallback | Google GenAI (@google/genai ^1.46.0) — Gemini 2.0 Flash |
| OAuth | Passport.js with passport-google-oauth20 and passport-discord |
| Media storage | Cloudinary (cloudinary ^2.9.0) |
Resend (resend ^6.12.4) | |
| Validation | Zod (zod ^3.24.0) |
| Rate limiting | express-rate-limit ^7.5.0 |
| Security headers | Helmet (helmet ^8.0.0) |
| Scheduling | node-cron (node-cron ^4.2.1) |
User Roles
Sealearn is built for three distinct audiences that interact with the platform in complementary ways. Students are the primary consumers of the platform. They enroll in subjects, work through units and lessons, answer adaptive question sets, maintain daily streaks, compete in duels and leagues, and spend XP on shop items. The frontend is optimized around the learner journey from first login through advanced league play. Educators create and curate content. They can build subjects, units, and lessons, write questions manually across all nine types, or trigger AI generation for an entire lesson’s worth of content in seconds. Question review, activation, and bulk CSV import/export are all available from the educator interface. Admins have full platform control via the/api/admin route group — user management, subject oversight, content moderation, and analytics. Admin-guarded endpoints require both a valid JWT and an elevated role flag on the User model.
Sealearn is an open-source project. All source code is available on GitHub. The platform is production-ready and has been deployed on services such as Vercel (frontend) and Railway/Render (backend), with CORS pre-configured for
https://sea-frontend*.vercel.app wildcard origins.