diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 0000000..a352baf
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,54 @@
+# Claude - blockchain-flutter
+
+## Projet
+Flutter app pour explorer la blockchain, gérer des wallets, et miner.
+Partie d'un ecosysteme de 3 repos.
+
+## Architecture
+Clean architecture, feature-based :
+```
+lib/
+├── main.dart
+├── core/
+│   ├── network/api_client.dart   # Dio HTTP vers le node
+│   ├── theme/app_theme.dart      # Dark crypto theme
+│   └── utils/formatters.dart     # Hash, amount, date formatting
+├── features/
+│   ├── dashboard/     # Chain stats, recent blocks
+│   ├── blocks/        # Block explorer (list + detail)
+│   ├── wallet/        # Create, balance, list
+│   ├── transactions/  # Send tx, pending list
+│   └── mining/        # Mine button, difficulty
+└── routing/app_router.dart  # GoRouter
+```
+
+## Stack
+- **Riverpod** (state management)
+- **Dio** (HTTP client)
+- **GoRouter** (navigation)
+- **Freezed + json_serializable** (models)
+- **flutter_secure_storage** (wallet keys)
+- **fl_chart** (chain visualization)
+- **google_fonts** (JetBrains Mono)
+
+## Phase actuelle
+Screens stub créés. Prochaine étape : implémenter les providers Riverpod + connecter au node API.
+
+## Commandes
+```bash
+flutter pub get
+dart run build_runner build --delete-conflicting-outputs
+flutter run
+flutter run -d chrome
+```
+
+## Config
+Node URL par défaut : `http://localhost:3000`
+Android emulator : `http://10.0.2.2:3000`
+
+## Repos liés
+- blockchain-core (le node API qu'on interroge)
+- blockchain-cli (même API)
+
+## Gitea
+https://git.etheryale.com/StillHammer/blockchain-flutter