Lettres Magiques — jeu de prénoms HTML5 (mobile+ordi)

README.md

@@ -0,0 +1,41 @@
+# ✨ Lettres Magiques
+
+Jeu web pour enfants (4+) pour apprendre les lettres en s'amusant.
+Réécriture HTML5 du jeu pygame « Super Lettres Magiques » — fonctionne **au clavier sur ordinateur** et **au toucher sur téléphone/tablette**.
+
+## Jouer
+
+Ouvre `index.html` dans un navigateur, ou va sur l'URL publique :
+**https://laboratoire.freeboxos.fr/lettres-magiques/**
+
+## Comment ça marche
+
+- L'enfant tape/touche les lettres pour écrire les **prénoms de la famille** affichés (PEPE, JULIE, LILWENN, BAPTISTE, TRUFFE le chien…), chacun avec sa petite phrase magique. La liste se personnalise en haut de `game.js` (`NAMES` / `NAME_PHRASES`).
+- Mascotte « Blob » qui parle et encourage (voix française via Web Speech API).
+- Confettis, bulles, étoiles, arc-en-ciel à chaque réussite.
+- Autocollants à collectionner (1 tous les 3 mots).
+- Mini-jeux bonus (éclate les ballons / attrape les étoiles) toutes les ~30 s.
+- Aucune pression temporelle, aide permanente (liste des mots + indice après quelques secondes).
+
+## Technique
+
+- 100 % statique : HTML + CSS + JS, aucune dépendance, aucun build.
+- PWA : installable sur l'écran d'accueil et jouable hors-ligne (`manifest.webmanifest` + `sw.js`).
+- Sons synthétisés en WebAudio (pas de fichiers audio lourds).
+
+## Fichiers
+
+| Fichier | Rôle |
+|---|---|
+| `index.html` | Structure de la page |
+| `style.css` | Style responsive (mobile + desktop) |
+| `game.js` | Logique du jeu, mascotte, effets, mini-jeux |
+| `manifest.webmanifest`, `sw.js` | PWA |
+| `icons/` | Icônes de l'app |
+| `make_icons.py` | (dev) régénère les icônes |
+
+## Régénérer les icônes
+
+```bash
+python make_icons.py
+```