Skip to main content

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.

Sealearn is an open-source gamified learning platform that adapts to each student’s performance. It combines structured subject curricula with real-time competition, XP progression, streaks, and an AI engine that generates and evaluates questions using Groq and Google Gemini — all powered by a Node.js/Express backend and a React frontend.

Introduction

Understand what Sealearn is, who it’s for, and how the platform is structured.

Quickstart

Clone, configure, and run the full stack locally in minutes.

Architecture

Explore the backend, frontend, database, and real-time layers in depth.

API Reference

Complete REST API and Socket.IO event documentation for every endpoint.

​
Core Features

Adaptive Learning

The engine adjusts question count and difficulty in real time based on activity score.

Gamification

XP, levels, hearts, streaks, gems, achievements, and daily goals keep students engaged.

Real-Time Duels

Challenge friends to live PvP quiz battles with modifiers via Socket.IO.

Competitive Leagues

Nine tiers from Bronze to Heroic with weekly automated promotion and demotion.

Social Features

Friend requests, leaderboards, public profiles, and a real-time chat system.

Admin Panel

Full CRUD for subjects, units, lessons, questions, shop items, and user management.

​
Get Running in 3 Steps

1

Clone and install dependencies

Clone the repo and install both backend and frontend dependencies.
git clone https://github.com/DerBasilisk/SEA-ServicioEvaluaconAsistida.git
cd SEA-ServicioEvaluaconAsistida/backend && npm install
cd ../frontend/sea && npm install
2

Configure environment variables

Copy the environment template and fill in your MongoDB URI, JWT secret, and AI API keys. See the Environment Variables reference for every required key.
3

Start the servers

# Terminal 1 — backend
cd backend && npm run dev

# Terminal 2 — frontend
cd frontend/sea && npm run dev
The API starts on http://localhost:3000 and the frontend on http://localhost:5173.

Build docs developers (and LLMs) love

Get started for freeTalk to us