Zuka

Tus sueños merecen un camino. Zuka presenta programas de PreICFES, preuniversitario, preingeniero y cursos de ingeniería organizados por escuelas, además de tutorías y asesorías en trabajos y exámenes. Su plataforma de aprendizaje es una PWA con lecciones cortas de matemáticas y estadística, retos con respuesta inmediata, XP y rachas. Se instala en el celular o el computador y sigue disponible sin conexión.

Está pensada para estudiantes de secundaria, preuniversitarios y primeros semestres. Autor: Carlos Hurtado. (El proyecto se llamó antes MathBrain y luego Euly; el repositorio y los identificadores internos conservan el nombre original).

Empezar

Necesitas Node.js 20 o superior. No hay dependencias que instalar.

npm run dev

Abre http://localhost:4173. Para verla en tu celular Android, sigue docs/PRUEBAS_ANDROID.md.

Comando	Qué hace
npm run dev	Compila y sirve la app en este equipo
npm run dev:movil	Igual, accesible desde el celular por Wi-Fi
npm test	Compila y ejecuta las pruebas
npm run build	Comprueba la sintaxis y genera dist/ para publicar

Qué incluye

• 5 cursos: Fundamentos de Matemáticas (31 lecciones en 5 unidades), Cálculo diferencial, Probabilidad, Inferencia estadística y Cálculo integral.
• 51 lecciones escritas en Markdown con LaTeX (KaTeX), video opcional de YouTube y 155 retos interactivos.
• Lecciones paso a paso: un concepto o un reto por pantalla, con retroalimentación de la mascota y la opción de leer la lección completa.
• Camino de niveles por curso, repasos de cada nivel, 6 simulaciones y 6 ejercicios resueltos.
• Progreso: XP, niveles, racha diaria y perfil del estudiante con su semana, sus cursos y sus logros.
• Bienvenida: explorar la plataforma o crear una cuenta con correo y contraseña. Sin cuenta se puede probar la primera lección de cada curso; con una sesión activa se accede a todas las lecciones, repasos, simulaciones y ejercicios, y el progreso se sincroniza con Supabase.
• PWA: instalable, sin conexión tras la primera visita y con aviso de actualización.
• Tema claro (por defecto), oscuro o del sistema.

Estructura

src/       código de la app        content/  lecciones (.md)
scripts/   compilación             tests/    pruebas
docs/      documentación           dist/     salida compilada (generada)

Documentación

• Visión · Requisitos · Hoja de ruta
• Arquitectura · Datos · Sistema de diseño
• Escribir lecciones y programas
• Probar en un celular Android
• Cuentas y base de datos (Supabase)
• CLAUDE.md: reglas para trabajar en el proyecto con Claude Code

Publicación

Cada push a main en CarlosHurtado2024/mathbrain se publica en Vercel, que ejecuta npm run build y sirve dist/ (configurado en vercel.json). Detalles en docs/ARCHITECTURE.md.

KaTeX 0.16.22 (vendor/katex/, src/vendor/katex/) y supabase-js 2.117.3 (src/vendor/supabase/) se distribuyen con licencia MIT.