diff --git a/README.MD b/README.MD
index db0dc78..da8b51f 100644
--- a/README.MD
+++ b/README.MD
@@ -1,15 +1,40 @@
 # Livrets
 
-### Android
-To run the application on android device/emulator:  
- - open project in Android Studio and run imported android run configuration  
+Jeu d'entraînement aux tables de multiplication (Kotlin Multiplatform, Android + iOS).
 
-To build the application bundle:  
- - run `./gradlew :androidApp:assembleDebug`  
- - find `.apk` file in `androidApp/build/outputs/apk/debug/androidApp-debug.apk`  
+## Règles du jeu
+
+- Au lancement, on configure : le **nombre de questions** (5–50), le **temps par question** (3–30 s)
+  et la **table maximum** (1–12).
+- Chaque question est une multiplication tirée au hasard dans les tables 1 à la table maximum :
+  soit `a × b = ?`, soit `a × ? = b`. On répond avec le pavé numérique.
+- Temps écoulé = réponse comptée comme fausse (une saisie en cours est auto-validée).
+- Après chaque réponse, un feedback (vert/rouge) s'affiche 1,5 s puis la question suivante arrive.
+- À la fin : score, taux de réussite, temps moyen et résumé de chaque réponse fausse.
+- L'**Historique** conserve les parties passées et le taux de réussite cumulé par table.
+
+## Lancer l'application
+
+### Android
+
+```bash
+./gradlew :androidApp:installDebug    # appareil/émulateur connecté
+# ou générer l'APK :
+./gradlew :androidApp:assembleDebug   # androidApp/build/outputs/apk/debug/
+```
 
 ### iOS
-To run the application on iPhone device/simulator:  
- - Open `iosApp/iosApp.xcproject` in Xcode and run standard configuration  
- - Or use [Kotlin Multiplatform Mobile plugin](https://plugins.jetbrains.com/plugin/14936-kotlin-multiplatform-mobile) for Android Studio  
 
+Ouvrir `iosApp/iosApp.xcodeproj` dans Xcode et lancer le scheme `iosApp` sur un simulateur.
+
+## Tests
+
+```bash
+./gradlew :sharedUI:jvmTest           # logique de jeu, générateur, persistance
+```
+
+## Structure
+
+- `sharedUI/` : logique de jeu (`game/`), persistance (`data/`), UI Compose (`ui/`), thème (`theme/`)
+- `androidApp/` : hôte Android
+- `iosApp/` : hôte iOS (Xcode)