diff --git a/README.md b/README.md
index 46fa363..8e0ee5a 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,99 @@
-# ha-cookcli
+# CookCLI Recipes Strategy pour Home Assistant
 
-Home Assistant Integration for CookCLI Server
\ No newline at end of file
+Stratégie de tableau de bord Home Assistant qui génère automatiquement **une page par recette** à partir des recettes exposées par l'intégration [ha-cookcli](https://git.thethomaas.net/TheThomaas/ha-cookcli).
+
+Chaque page de recette affiche les **ingrédients** et les **étapes de préparation**, offrant une navigation fluide depuis un tableau de bord dédié à vos recettes de cuisine.
+
+## ✨ Fonctionnalités
+
+- 🗂️ **Génération automatique** d'une page par recette
+- 📋 Affichage des **ingrédients** de chaque recette
+- 👨‍🍳 Affichage des **étapes** de préparation
+- 🧭 Navigation facilitée entre les recettes via la carte [ha-cookcli-card](https://git.thethomaas.net/TheThomaas/ha-cookcli-card)
+- 🎨 Intégration native aux tableaux de bord Home Assistant (YAML généré dynamiquement)
+
+## 🧩 Architecture
+
+Cette stratégie fait partie d'un ensemble de trois composants qui fonctionnent ensemble :
+
+| Composant | Rôle | Dépôt |
+|---|---|---|
+| **Intégration** | Se connecte au serveur CookCLI et expose les recettes à Home Assistant | [ha-cookcli](https://git.thethomaas.net/TheThomaas/ha-cookcli) |
+| **Stratégie de tableau de bord** | Crée automatiquement une page par recette (ingrédients + étapes) | *ce dépôt* |
+| **Carte personnalisée** | Liste toutes les recettes et permet de naviguer vers le détail d'une recette | [ha-cookcli-card](https://git.thethomaas.net/TheThomaas/ha-cookcli-card) |
+
+## 📦 Installation
+
+### Prérequis
+
+- Une instance **Home Assistant** fonctionnelle (version récente recommandée)
+- L'intégration **[ha-cookcli](https://git.thethomaas.net/TheThomaas/ha-cookcli)** installée et configurée
+- La carte **[ha-cookcli-card](https://git.thethomaas.net/TheThomaas/ha-cookcli-card)** installée (pour la navigation)
+- **[HACS](https://hacs.xyz/)** installé (recommandé)
+
+### Installation via HACS
+
+1. Ouvrez **HACS** dans Home Assistant.
+2. Allez dans **Tableaux de bord** → menu (⋮) → **Dépôts personnalisés**.
+3. Ajoutez l'URL du dépôt :
+   ```
+   https://git.thethomaas.net/TheThomaas/ha-cookcli-strategy
+   ```
+   Catégorie : **Dashboard** (ou **Lovelace**)
+4. Recherchez **CookCLI Strategy** dans HACS et installez-le.
+5. **Videz le cache du navigateur** ou rechargez les ressources Lovelace.
+
+### Installation manuelle
+
+1. Téléchargez ou clonez ce dépôt.
+2. Copiez le fichier `dist/cookcli-recipe-strategy.js` dans votre répertoire `config/www/`.
+3. Ajoutez la ressource dans **Paramètres** → **Tableaux de bord** → **Ressources** :
+   ```yaml
+   url: /local/cookcli-recipe-strategy.js
+   type: module
+   ```
+4. Rechargez les ressources Lovelace.
+
+## ⚙️ Configuration
+
+### Création d'un tableau de bord avec la stratégie
+
+1. Allez dans **Paramètres** → **Tableaux de bord**.
+2. Cliquez sur **+ Ajouter un tableau de bord**.
+3. Choisissez **Nouveau tableau de bord à partir d'une stratégie** (ou équivalent selon votre version de HA).
+4. Sélectionnez la stratégie **CookCLI Recipe**.
+5. Validez : le tableau de bord est généré automatiquement avec une page par recette.
+
+### Exemple de configuration YAML
+
+Si vous préférez définir le tableau de bord en YAML :
+
+```yaml
+strategy:
+  type: custom:cookcli-recipe
+  title: Mes recettes
+```
+
+> Adaptez les options selon la version de la stratégie. Consultez le fichier `dist/cookcli-recipe-strategy.js` pour la liste exacte des paramètres supportés.
+
+## 🚀 Utilisation
+
+Une fois le tableau de bord créé :
+
+1. La **page d'accueil** du tableau de bord liste les recettes (via la carte `cookcli-card`).
+2. Cliquer sur une recette **navigue vers sa page de détail** générée par la stratégie.
+3. Chaque page de détail présente :
+   - les **ingrédients** nécessaires,
+   - les **étapes** de préparation dans l'ordre.
+
+## 📄 Licence
+
+Ce projet est distribué sous licence présente dans le fichier [LICENSE](./LICENSE) du dépôt.
+
+## 🔗 Liens
+
+- **Intégration** : https://git.thethomaas.net/TheThomaas/ha-cookcli
+- **Stratégie** : https://git.thethomaas.net/TheThomaas/ha-cookcli-strategy
+- **Carte** : https://git.thethomaas.net/TheThomaas/ha-cookcli-card
+- **CookCLI** : https://github.com/cooklang/CookCLI
+- **Cooklang** : https://cooklang.org/