Mapulengua

Un prototipo de aprendizaje de mapudungun con una ruta interactiva por Chile.
Lecciones breves, ejercicios variados, progreso local y una experiencia mobile-first acompañada por Pudu.

Caution

El contenido lingüístico actual es material semilla de un prototipo. En el código está marcado como source: "seed" y validated: false; no debe usarse como fuente autoritativa para aprender, enseñar o traducir mapudungun. El siguiente paso necesario es revisarlo con hablantes y especialistas de la lengua.

La experiencia

Mapulengua convierte el avance en un viaje de norte a sur. Cada parada presenta vocabulario y ejercicios dentro de una interfaz inspirada en paisajes chilenos.

• Diez paradas regionales desde Arica hasta Punta Arenas
• Lecciones de saludos, números, familia, comida, naturaleza, animales, vida diaria, relatos y clima
• Opción múltiple, completar, emparejar, banco de palabras y escucha
• XP, vidas, rachas, metas diarias, logros y repaso de vocabulario
• Progreso guardado en localStorage, sin cuenta de usuario
• PWA instalable y diseño adaptable a teléfono y escritorio
• Lectura en voz alta mediante las voces disponibles en Web Speech API

Estado del proyecto

La interfaz, la navegación, la gamificación y el motor de ejercicios están implementados. La validación cultural y lingüística todavía está pendiente.

Área	Estado
Interfaz y viaje regional	Implementado
Tipos de ejercicio y progreso	Implementado
PWA y experiencia responsive	Implementado
Revisión por hablantes de mapudungun	Pendiente
Fuentes y variantes dialectales documentadas	Pendiente
Publicación de una demo canónica de este repositorio	Pendiente

Desarrollo local

git clone https://github.com/VicenteBarrientos/mapulengua.git
cd mapulengua
npm install
npm run dev

Abre http://localhost:3000.

Para metadata social absoluta, copia el ejemplo de entorno y configura el dominio real:

cp .env.example .env.local

NEXT_PUBLIC_APP_URL="http://localhost:3000"

En Windows PowerShell:

Copy-Item .env.example .env.local

Comandos

Comando	Uso
npm run dev	Inicia el servidor de desarrollo.
npm run build	Genera el build de producción.
npm run start	Sirve un build ya generado.

Estructura

src/
  app/                       Páginas, rutas y metadata
  components/
    exercises/               Tipos de ejercicio
    journey/                 Mapa, regiones y meta diaria
    kume/                    Personaje, emociones y escenas
    lesson/                  Flujo de una lección
  lib/
    data/regions.ts          Ruta regional
    data/lessons/            Contenido semilla por región
    review/                  Repaso de vocabulario
    store/                   Progreso local
    achievements.ts          Logros
public/                      Manifest, iconos y recursos visuales

Principios para contribuir contenido

Una contribución lingüística debería indicar, como mínimo:

1. fuente o comunidad de referencia;
2. variante territorial cuando corresponda;
3. persona o equipo responsable de la revisión;
4. fecha de validación;
5. cambio de validated: false a true solo después de esa revisión.

La identidad visual no sustituye la validación cultural. Los cambios que afecten lengua, símbolos o representación deberían revisarse con personas mapuche y hablantes de mapudungun.

English summary

Mapulengua is a mobile-first, gamified Mapudungun learning prototype built with Next.js and TypeScript. Its product experience is implemented, but the current seed language content has not been validated by speakers and must not be treated as an authoritative learning source.