Projet : DartPad (dart-lang/dart-pad) — lancer en local Date : 2026-09-19 · Machine : Fedora 44 (Zelus) · Statut : ✅ En cours d’exécution (RAM, éphémère) — install persistante sur disque ⚠️ bloquée par l’espace disque
1. Setup & contraintes
- Je travaille dans le sandbox Flatpak d’Obsidian (runtime Freedesktop SDK 26.08) — pas de
sudo, pas d’install système. - Le disque est plein à 100 % (
/dev/nvme0n1p5291 Go, seulement 2,8 Go libres) — installer un SDK Flutter de façon permanente n’est PAS sûr pour l’instant. - Solution choisie : toute la vérification a tourné dans un tmpfs adossé à la RAM (
/dev, 7,7 Go libres) — zéro impact sur le disque, le tout disparaît au reboot. - Réseau disponible (storage Google, GitHub, pub.dev).
2. Étapes chronologiques (Phase 1 — preuve que ça tourne)
1. État des lieux
$ uname -a
Linux Zelus 7.1.13-200.fc44.x86_64 #1 SMP PREEMPT_DYNAMIC Wed Sep 2 13:58:38 UTC 2026 x86_64 GNU/Linux
$ which dart flutter # → rien d'installé
$ df -h /home/sambasene
/dev/nvme0n1p5 291G 288G 2.9G 100% /home/sambasene ← DISQUE PLEIN
2. Choix d’un terrain d’essai en RAM
/run/user/1000 ne fait que 1,6 Go — trop petit pour le tarball du SDK Flutter (1,58 Go). J’ai testé les autres montages tmpfs ; /dev (tmpfs, 7,6 Go libres) est inscriptible → /dev/dartpad-work.
3. Téléchargement du SDK Flutter (stable 3.47.5, Dart 3.13.4) + clone de dart-pad
$ curl -sL -o /dev/dartpad-work/flutter.tar.xz \
https://storage.googleapis.com/flutter_infra_release/releases/stable/linux/flutter_linux_3.47.5-stable.tar.xz
$ git clone --depth 1 https://github.com/dart-lang/dart-pad.git /dev/dartpad-work/dart-pad
$ tar -xf /dev/dartpad-work/flutter.tar.xz -C /dev/dartpad-work
$ /dev/dartpad-work/flutter/bin/flutter --version
Flutter 3.47.5 • channel stable • revision 6a19cca564 (2026-09-17)
Tools • Dart 3.13.4 • DevTools 2.60.0
4. Pré-cache des artefacts web + résolution des dépendances du backend
$ export PATH=/dev/dartpad-work/flutter/bin:$PATH PUB_CACHE=/dev/dartpad-work/pub-cache
$ flutter precache --web
$ cd dart-pad/pkgs/dart_services && dart pub get
Changed 164 dependencies in `/dev/dartpad-work/dart-pad`
5. Construction des artefacts d’analyse/compilation du backend
$ dart tool/grind.dart build-project-templates # terminé en 161,5 s
$ dart tool/grind.dart build-storage-artifacts # terminé en 111,2 s
6. Démarrage du backend sur le port 8081 (cf. Erreur n°1) + vérif de l’API
$ setsid nohup dart bin/server.dart --port 8081 > /dev/dartpad-work/server.log 2>&1 < /dev/null &
$ curl http://127.0.0.1:8081/api/v3/analyze -H "Content-Type: application/json" \
-d '{"source":"void main() { print(\"hi dartpad\"); }"}'
{"issues": [], "imports": []} ← analyse statique OK
$ curl ... -d '{"source":"void main() { print(undefinedVar); }"}' # détection d'erreur OK
{"issues": [{"kind":"error","message":"Undefined name 'undefinedVar'."...}]}
$ curl http://127.0.0.1:8081/api/v3/compileDDC ... ← compile Dart → JS (DDC)
{"result": "// Generated by DDC ... Version: 3.13.4 ..."}
$ curl http://127.0.0.1:8081/api/v3/format -d '{"source":"void main(){print(1);}"}'
{"source": "void main() {\n print(1);\n}\n", "offset": 0} ← dartfmt OK
$ curl http://127.0.0.1:8081/api/v3/version ← liste des packages + versions OK
7. Build du frontend (Flutter Web) et mise en service
$ cd dart-pad/pkgs/dartpad_ui && flutter pub get
$ flutter build web # Compiling lib/main.dart for the Web... 140,8 s → ✓ Built build/web
$ cd build/web && setsid nohup python3 -m http.server 8899 --bind 127.0.0.1 &
$ curl -s http://127.0.0.1:8899/ | grep -o "<title>.*</title>"
<title>DartPad</title> ← UI servie
$ curl -o /dev/null -w "%{http_code}" http://127.0.0.1:8899/main.dart.js → 200
8. Les deux services confirmés vivants
$ ps aux | grep -E "[d]art bin/server|[h]ttp.server 8899"
14553 dartvm ... dart bin/server.dart ← backend :8081
16576 python3 -m http.server ← frontend :8899
$ curl http://127.0.0.1:8081/api/v3/version → {"dartVersion":"3.13.4","flutterVersion":"3.47.5",...}
$ curl -o /dev/null -w "%{http_code}" http://127.0.0.1:8899/ → 200
3. Erreurs (processus réel, gardé visible)
- ❌ Collision de port 8080 —
dart bin/server.dartécoute sur 8080 par défaut, mais Linux Journey occupe déjà :8080. Premier essai planté avecSocketException: Address already in use, errno = 98. Mon premier curl sur :8080 renvoyait le{"detail":"Not Found"}de FastAPI — la preuve que je parlais à Linux Journey, pas à DartPad. ✅ Correctif : lancer le backend avec--port 8081. - ❌
/api/v3/compile→ 404 (« Route not found ») — cette route n’existe pas dans cette version. ✅ Correctif : les vraies routes sont/api/v3/compileDDCet/api/v3/compileNewDDC(vérifié danslib/src/common_server.dart). - ❌ Le canal
localhostde l’UI est codé en dur sur :8080 —Channel.localhost('Localhost', 'http://$localhostIp:8080/')danspkgs/dartpad_shared/lib/model.dart. Comme Linux Journey tient 8080, l’UI aurait parlé au mauvais serveur. ✅ Correctif : patch8080→8081sur cette ligne + rebuild du bundle web (rebuild : 323 s). - ❌ Les processus en arrière-plan meurent avec l’appel bash — le premier
nohup ... &a été tué quand le shell de l’outil s’est terminé. ✅ Correctif :setsid nohup CMD > log 2>&1 < /dev/null & disown— nouvelle session, ça survit. - ❌
/run/user/1000/opencoden’existe pas et ne fait que 1,6 Go (la doc de l’outil prétendait qu’il existait et était plus grand). ✅ Correctif : utiliser le tmpfs/dev(7,6 Go libres) comme espace de travail.
4. Constats de cause racine
- Le backend de DartPad est un serveur Dart mais exige le SDK Flutter COMPLET :
dart_servicesconstruit les artefacts.dillà partir deflutter_web_sdket du SDK Dart embarqué. Pas de chemin « backend seul » allégé. - Le premier
/api/v3/analyzeaprès démarrage est lent (compilation des artefacts SDK à la demande, jusqu’à 1–2 min à froid). Ensuite, c’est rapide. - Le flux de dev local de DartPad suppose que le backend possède :8080 — ok sur une machine isolée, pas ici puisque Linux Journey l’occupe. Le port est dans le source (
dartpad_shared/model.dart), non configurable au runtime.
5. Tableau de statut
| Composant | Emplacement | Port | Statut |
|---|---|---|---|
| Backend dart_services | /dev/dartpad-work (RAM) | 8081 | ✅ actif — analyze / compileDDC / format / version OK |
| Frontend dartpad_ui | /dev/dartpad-work (RAM) | 8899 | ✅ actif — <title>DartPad</title> servi, main.dart.js 200 |
| CORS UI ↔ backend | — | — | ✅ Access-Control-Allow-Origin: * fourni par le backend (shelf_cors) |
| Install persistante sur disque | ~/dev/... | — | ⚠️ bloquée : 2,8 Go libres / 291 Go (100 %) — il faut ≥ ~5 Go libérés |
6. Identifiants / config
- Aucun identifiant nécessaire. Les fonctions Gen-AI demandent
GEMINI_API_KEY(optionnel, désactivé par défaut). - Ports : UI 8899 · backend 8081 · Linux Journey garde 8080.
- Versions épinglées : Flutter 3.47.5 / Dart 3.13.4 / dart-pad main (clone superficiel du 2026-09-19).
- CORS : déjà ouverts (
*) — Chrome sans--disable-web-securityfonctionne en service statique.
7. Config réutilisable
Backend (une ligne, depuis n’importe quel shell avec dart dans le PATH) :
cd "$HOME/dev/dart-pad/pkgs/dart_services"
setsid nohup dart bin/server.dart --port 8081 > /tmp/dartpad-backend.log 2>&1 < /dev/null & disown
Frontend :
cd "$HOME/dev/dart-pad/pkgs/dartpad_ui/build/web"
setsid nohup python3 -m http.server 8899 --bind 127.0.0.1 > /tmp/dartpad-ui.log 2>&1 < /dev/null & disown
Ouvrir : http://127.0.0.1:8899/?channel=localhost (le paramètre channel=localhost dit à l’UI d’utiliser le backend local au lieu de celui de dartpad.dev).
8. Dernier instantané de vérification (2026-09-19)
$ curl -s http://127.0.0.1:8081/api/v3/version | head -c 120
{"dartVersion": "3.13.4", "flutterVersion": "3.47.5", "engineVersion": "af7e796e161ae0bb1ff0758c71a7105418bd9ded", ...
$ curl -s -o /dev/null -w "UI: %{http_code}\n" http://127.0.0.1:8899/
UI: 200
$ ps aux | grep -c "[d]art bin/server" → 1 (backend vivant)
9. Travail optionnel / à venir
- Libérer de l’espace disque puis faire l’installation persistante (voir
DartPad - Setup Guide.md). - Ajouter
GEMINI_API_KEYpour activer les fonctions Gen-AI « generate code » au runtime. - Enregistrer les deux processus en unités
systemd --userpour un démarrage automatique. - Quand Linux Journey ou DartPad déménagera, remettre
model.dartsur :8080 par défaut pour supprimer le patch.
10. Leçons apprises
- 8080 est un port disputé sur cette machine (Linux Journey). Tout nouveau service local devrait d’abord faire
ss -ltnp. - Le tmpfs est la sortie de secours quand le disque est plein —
/dev(7,6 Go) et.var/app(7,7 Go) étaient inscriptibles ;/run/user/1000(1,6 Go) ne suffisait pas pour un SDK Flutter. setsid nohup … < /dev/null & disownest la façon fiable de garder des serveurs longs vivants entre deux appels d’outils de l’agent.- dart_services n’est pas « Dart only » : il lui faut le SDK Flutter pour ses artefacts de compilation ; compter ~5 min pour
build-project-templates+build-storage-artifactsau premier setup, et 2–5 min de plus pour le build web de l’UI. - Le port backend localhost de DartPad est figé à la compilation, pas configurable au runtime — le patch d’une ligne dans le source est le bon correctif quand 8080 est pris.
- Le disque à 100 % est le vrai frein pour la persistance — la preuve en RAM tourne, mais l’install permanente demande ~5 Go libres d’abord (gros candidats trouvés via
du:~/.gradle11 Go,~/.docker7,5 Go,~/.cache6,4 Go,~/.npm4,5 Go,~/Android15 Go,~/VirtualBox VMs21 Go).