diff --git a/README.md b/README.md
index 2d5eb14..93f15cb 100644
--- a/README.md
+++ b/README.md
@@ -20,12 +20,13 @@ Prérequis : Node 24 LTS, npm.
 
 ```bash
 cd app
-cp .env.example .env      # DEV_USER=dev simule un utilisateur SSO connecté
 npm ci
-npm run dev
+npm run dev:local   # zéro config : utilisateur SSO simulé (dev), token d'alertes factice, données dans ./data
 ```
 
-Sans `DEV_USER`, l'accueil public minimal est affiché et toute autre route renvoie 401 — comme en production sans header SSO.
+`npm run dev:local` injecte `DEV_USER=dev` (utilisateur SSO simulé — dev uniquement), `ALERTS_TOKEN=dev-token-local` (pour tester `POST /api/alerts`) et `DATA_DIR=./data`. L'app est sur http://localhost:5173, connectée en tant que `dev`.
+
+Pour tester finement une variable précise, copie `.env.example` en `.env` et utilise `npm run dev`. Sans `DEV_USER`, l'accueil public minimal est affiché et toute autre route renvoie 401 — comme en production sans header SSO.
 
 ### Variables d'environnement
 
diff --git a/app/README.md b/app/README.md
index 3e2b257..b4d4b71 100644
--- a/app/README.md
+++ b/app/README.md
@@ -4,10 +4,20 @@ Voir le [README racine](../README.md) pour la vue d'ensemble, le dev local et le
 
 ```bash
 npm ci
-npm run dev        # dev (DEV_USER=dev dans .env simule le SSO)
+npm run dev:local  # dev zéro config : DEV_USER=dev + ALERTS_TOKEN=dev-token-local + DATA_DIR=./data
+npm run dev        # dev nu (lit .env — voir .env.example)
 npm run check      # svelte-check — 0 erreur / 0 warning exigé
 npm run lint       # prettier + eslint
 npm run test       # vitest
 npm run build      # build adapter-node (BASE_PATH=/veille pour un sous-chemin)
 node build/index.js
 ```
+
+Test de `POST /api/alerts` en local (avec `dev:local`) :
+
+```bash
+curl -X POST http://localhost:5173/api/alerts \
+  -H "authorization: Bearer dev-token-local" \
+  -H "content-type: application/json" \
+  -d '{"type":"nouvelle_sortie","titre":"Test","resume":"Résumé test.","sources":["https://example.org"],"date":"2026-08-01"}'
+```
diff --git a/app/package.json b/app/package.json
index d46215e..72f1725 100644
--- a/app/package.json
+++ b/app/package.json
@@ -5,6 +5,7 @@
 	"type": "module",
 	"scripts": {
 		"dev": "vite dev",
+		"dev:local": "DEV_USER=dev ALERTS_TOKEN=dev-token-local DATA_DIR=./data vite dev",
 		"build": "vite build",
 		"preview": "vite preview",
 		"prepare": "svelte-kit sync || echo ''",