diff --git a/README.md b/README.md
index 26b792c..ad49312 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,74 @@
-# neovim
+# 🚀 Max's Neovim Configuration (v0.11-dev)
 
-NeoVim config file 
\ No newline at end of file
+Bienvenue dans ma configuration Neovim personnalisée, optimisée pour le développement Python, C, Bash et l'administration système. Cette configuration privilégie la vitesse, l'intelligence (LSP) et une interface moderne.
+
+## 🛠️ Architecture du Projet
+Les fichiers sont structurés de manière modulaire pour une maintenance facile :
+- `init.lua` : Point d'entrée principal.
+- `lua/core/` : Options de base et raccourcis clavier globaux.
+- `lua/plugins/` : Un fichier par plugin (chargement via Lazy.nvim).
+
+---
+
+## 📦 Gestionnaire de Plugins : [Lazy.nvim](https://github.com/folke/lazy.nvim)
+Toute la configuration est gérée de manière asynchrone pour un démarrage ultra-rapide.
+- **Commande :** `:Lazy` pour gérer les mises à jour.
+
+---
+
+## 🧠 Intelligence & Code (LSP)
+Propulsé par le moteur natif de Neovim 0.11 et configuré via `nvim-lspconfig`.
+- **Mason.nvim** : Gestionnaire d'installation pour serveurs LSP, Linters et Formatters.
+- **LSP Config** : Configuration pour `Pyright` (Python), `Clangd` (C/C++), `Bashls` (Bash).
+- **Trouble.nvim** : Vue d'ensemble de toutes les erreurs du projet (`<leader>xx`).
+- **Nvim-cmp** : Auto-complétion de type "IntelliSense" (LSP, Buffers, Chemins).
+
+---
+
+## ⚡ Productivité & Navigation
+- **Telescope.nvim** : Le coeur de la navigation. 
+    - `<leader>ff` : Trouver un fichier.
+    - `<leader>fg` : Recherche de texte (Live Grep).
+- **Flash.nvim** : Téléportation du curseur sur l'écran via la touche `s`.
+- **Nvim-tree** : Explorateur de fichiers latéral classique (`<leader>e`).
+- **Oil.nvim** : Édition du système de fichiers comme un simple buffer texte (`-`).
+- **ToggleTerm** : Terminal flottant persistant (`Ctrl+\`).
+- **Persistence.nvim** : Sauvegarde et restauration automatique des sessions (`<leader>qs`).
+
+---
+
+## ✍️ Édition Avancée
+- **LuaSnip & Friendly-snippets** : Moteur de templates de code (ex: taper `def` en Python génère la structure).
+- **Nvim-surround** : Manipulation des parenthèses/quotes (`ds"`, `cs'(`).
+- **Comment.nvim** : Commentaire rapide de blocs (`gcc`, `gc`).
+- **Todo-comments** : Coloration et recherche des `TODO`, `FIXME`.
+
+---
+
+## 🎨 Interface & UI
+- **Alpha-nvim** : Dashboard d'accueil au démarrage.
+- **Treesitter** : Coloration syntaxique haute performance basée sur l'AST.
+- **Gitsigns** : Visualisation des modifications Git dans la marge.
+- **Indent-blankline** : Guides visuels pour l'indentation (vital pour Python).
+- **Noice.nvim** : Interface moderne pour les messages et la ligne de commande.
+
+---
+
+## ⌨️ Raccourcis Clés (Cheat Sheet)
+
+| Touche | Action |
+| :--- | :--- |
+| `<leader>ff` | Rechercher un fichier |
+| `<leader>e` | Ouvrir l'explorateur (Arbre) |
+| `K` | Afficher la documentation (Hover) |
+| `gd` | Aller à la définition |
+| `gcc` | Commenter / Décommenter |
+| `Ctrl + \` | Ouvrir le terminal flottant |
+| `<leader>qs` | Restaurer la session du projet |
+| `s` | Sauter (Flash) vers un mot |
+| `<leader>f` | Formater le code proprement |
+
+---
+
+## 🔧 Installation sur une nouvelle machine
+1. Installer **Neovim