![Godot Version](https://img.shields.io/badge/Godot-4.6+-blue)

# 📖 Kalulu — Aprende a leer de forma inteligente

## 🌍 Idiomas disponibles

- 🇬🇧 [English](README.md)
- 🇫🇷 [Français](README.fr.md)
- 🇧🇷 [Português (Brasil)](README.pt-br.md)

---

## 📚 Contenido

- [🧠 ¿Por qué Kalulu?](#por-qué-kalulu)
- [✨ Funcionalidades](#funcionalidades)
- [🚀 Primeros pasos](#primeros-pasos)
  - [1. Clonar el repositorio](#1-clonar-el-repositorio)
  - [2. Instalar Godot Engine](#2-instalar-godot-engine)
- [🧩 Addons integrados](#-addons-integrados)
- [🤝 ¿Quieres ayudar?](#-quieres-ayudar-)
- [❓ FAQ](#faq)

---

## 🧠 ¿Por qué Kalulu?

**Kalulu** no es solo un juego: es una herramienta educativa basada en investigaciones científicas que enseña a leer a los niños mediante el método de decodificación.

Cada lección sigue una progresión lógica basada en datos lingüísticos extraídos de la literatura infantil.

- 🎯 **Objetivo**: Hacer que aprender a leer sea divertido y efectivo  
- 🌟 **Basado en ciencia**: Desarrollado con investigaciones en neurociencia y educación  
- 👶 **Público objetivo**: Niños, pero útil para cualquier principiante en la lectura
- 🔎 **Investigaciones publicadas**: Se han publicado varios artículos sobre el diseño de Kalulu y los resultados de lectura, léelos aquí:  
  https://www.tandfonline.com/doi/pdf/10.1080/00220973.2023.2173129  
  https://hal.science/hal-03015914/document  
  https://hal.science/hal-03702075/document  
  
---

## ✨ Funcionalidades

- Lecciones interactivas de lectura grafema-fonema
- Progresión adaptativa de dificultad
- Interfaz amigable para niños con visuales atractivos

---

## 🚀 Primeros pasos

### 1. 📥 Clonar el repositorio

```bash
# Clona tu fork del repositorio
git clone https://github.com/TU_USUARIO/Kalulu-Frontend.git
# O bien
git clone git@github.com:YOUR_USERNAME/Kalulu-Frontend.git

cd Kalulu-Frontend
```

🔁 _Reemplaza `TU_USUARIO` con tu nombre de usuario._

---

### 2. 🎮 Instalar Godot Engine

- Descarga desde [godotengine.org](https://godotengine.org/)
- Elige tu sistema operativo y abre el editor

---

## 🧩 Addons integrados

- 🔄 **EnvironmentSwitcher** – Cambia entre entornos fácilmente
- 📤 **export_tool_manager** – Facilita exportar a múltiples plataformas
- ✅ **godot-form-validator** – Plugin para validar formularios en Godot 4
- 🗃️ **godot-sqlite** – Soporte SQLite

> ⚠️ Debe descargarse manualmente desde el AssetLib.

---

## 🤝 ¿Quieres ayudar?

¡Tu colaboración es bienvenida!

1. **Configura el proyecto**  
   Consulta la [sección de Primeros pasos](#primeros-pasos) para aprender a bifurcar y clonar el repositorio.

2. **Crea una nueva rama**
```bash
git checkout -b feature/nombre-de-tu-funcion
```

3. **Haz tus cambios**  
   Implementa tus mejoras o correcciones.

4. **Confirma y sube tus cambios**
```bash
git add .
git commit -m "Describe tus cambios"
git push origin feature/nombre-de-tu-funcion
```

5. **Abre una Pull Request**  
   Ve a tu repositorio bifurcado en GitHub y haz clic en **Compare & pull request** para enviar tus cambios.

Asegúrate de que tu código siga nuestras convenciones de codificación e incluya las pruebas o actualizaciones de documentación necesarias cuando corresponda.

---

## ❓ FAQ

### 📱 ¿Está Kalulu disponible en móviles?

¡Sí! Kalulu está disponible para:

- [![Android](https://img.shields.io/badge/PlayStore-Kalulu-green?logo=google-play)](https://play.google.com/store/apps/details?id=org.godotengine.kalulu)
- [![iOS](https://img.shields.io/badge/AppStore-Kalulu-blue?logo=apple)](https://apps.apple.com/fr/app/kalulu-education/id1639075967)

### 💻 ¿Está Kalulu disponible en escritorio?

¡Sí! Las versiones para Windows, Mac y Linux están disponibles en la sección [Releases](https://github.com/Excello-Recherche-Education/Kalulu-Frontend/releases).

### 🌐 ¿Está Kalulu disponible directamente en la web?

¡Estamos trabajando en ello, mantente atento!