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

# 📖 Kalulu — Apprends à lire intelligemment

## 🌍 Langues disponibles

- 🇬🇧 [English](README.md)
- 🇪🇸 [Español](README.es.md)
- 🇧🇷 [Português (Brasil)](README.pt-br.md)

---

## 📚 Contenu

- [🧠 Pourquoi Kalulu ?](#pourquoi-kalulu-)
- [✨ Fonctionnalités](#fonctionnalités)
- [🚀 Commencer](#commencer)
  - [1. Cloner le dépôt](#1-cloner-le-dépôt)
  - [2. Installer Godot Engine](#2-installer-godot-engine)
- [🧩 Addons intégrés](#-addons-intégrés)
- [🤝 Envie d'aider ?](#-envie-daider-)
- [❓ FAQ](#faq)

---

## 🧠 Pourquoi Kalulu ?

**Kalulu** est plus qu’un jeu — c’est une aventure éducative fondée sur la recherche scientifique qui aide les enfants à apprendre à lire grâce à la méthode de décodage.

Chaque leçon suit une séquence structurée basée sur des données linguistiques issues de la littérature jeunesse. Les enfants commencent par les voyelles, puis progressent vers des sons plus complexes.

- 🎯 **Objectif** : Rendre l'apprentissage de la lecture amusant et efficace  
- 🌟 **Basé sur la science** : Développé grâce aux recherches en éducation et en neurosciences  
- 👶 **Public cible** : Enfants, mais utile à tous ceux qui veulent apprendre à lire
- 🔎 **Recherches publiées** : Plusieurs articles ont été publiés sur la conception de Kalulu et les résultats en lecture, à lire ici :  
  https://www.tandfonline.com/doi/pdf/10.1080/00220973.2023.2173129  
  https://hal.science/hal-03015914/document  
  https://hal.science/hal-03702075/document  

---

## ✨ Fonctionnalités

- Leçons interactives de lecture graphème-phonème
- Progression adaptative de la difficulté
- Interface adaptée aux enfants avec des visuels attrayants

---

## 🚀 Commencer

### 1. 📥 Cloner le dépôt

```bash
# Clonez votre fork du dépôt
git clone https://github.com/VOTRE_UTILISATEUR/Kalulu.git
# Ou
git clone git@github.com:YOUR_USERNAME/Kalulu.git

cd Kalulu
```

🔁 _Remplacez `VOTRE_UTILISATEUR` par votre nom d'utilisateur GitHub._

---

### 2. 🎮 Installer Godot Engine

- Téléchargez depuis [godotengine.org](https://godotengine.org/)
- Choisissez votre système d’exploitation et lancez l’éditeur

---

## 🧩 Addons intégrés

- 🔄 **EnvironmentSwitcher** – Basculer facilement entre les environnements dev/prod
- 📤 **export_tool_manager** – Gère les exports multi-plateformes
- ✅ **godot-form-validator** – Plugin Godot 4 pour valider les éléments d’interface
- 🗃️ **godot-sqlite** – Intégration SQLite

> ⚠️ Téléchargez `godot-sqlite` manuellement depuis l’AssetLib.

---

## 🤝 Envie d'aider ?

Toute aide est la bienvenue !

1. **Configurer le projet**  
   Consultez la [section Commencer](#commencer) pour apprendre à forker et cloner le dépôt.

2. **Créer une nouvelle branche**
```bash
git checkout -b feature/nom-de-votre-fonctionnalite
```

3. **Apporter vos modifications**  
   Implémentez vos améliorations ou corrections.

4. **Valider et pousser les changements**
```bash
git add .
git commit -m "Décrivez vos modifications"
git push origin feature/nom-de-votre-fonctionnalite
```

5. **Ouvrir une Pull Request**  
   Allez sur votre dépôt forké sur GitHub et cliquez sur **Compare & pull request** pour soumettre vos changements.

Veuillez vous assurer que votre code respecte nos conventions de codage et inclut les tests ou mises à jour de documentation pertinents lorsque cela est nécessaire.

---

## ❓ FAQ

### 📱 Kalulu est-il disponible sur mobile ?

Oui ! Kalulu est disponible pour :

- [![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)

### 💻 Existe-t-il une version pour ordinateur ?

Une version pour Windows, Mac et Linux est en cours de développement expérimental. Restez à l’écoute !