DartPad

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/nvme0n1p5 291 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)

  1. ❌ Collision de port 8080 — dart bin/server.dart écoute sur 8080 par défaut, mais Linux Journey occupe déjà :8080. Premier essai planté avec SocketException: 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.
  2. ❌ /api/v3/compile → 404 (« Route not found ») — cette route n’existe pas dans cette version. ✅ Correctif : les vraies routes sont /api/v3/compileDDC et /api/v3/compileNewDDC (vérifié dans lib/src/common_server.dart).
  3. ❌ Le canal localhost de l’UI est codé en dur sur :8080 — Channel.localhost('Localhost', 'http://$localhostIp:8080/') dans pkgs/dartpad_shared/lib/model.dart. Comme Linux Journey tient 8080, l’UI aurait parlé au mauvais serveur. ✅ Correctif : patch 8080 → 8081 sur cette ligne + rebuild du bundle web (rebuild : 323 s).
  4. ❌ 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.
  5. ❌ /run/user/1000/opencode n’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_services construit les artefacts .dill à partir de flutter_web_sdk et du SDK Dart embarqué. Pas de chemin « backend seul » allégé.
  • Le premier /api/v3/analyze aprè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

ComposantEmplacementPortStatut
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-security fonctionne 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_KEY pour activer les fonctions Gen-AI « generate code » au runtime.
  • Enregistrer les deux processus en unités systemd --user pour un démarrage automatique.
  • Quand Linux Journey ou DartPad déménagera, remettre model.dart sur :8080 par défaut pour supprimer le patch.

10. Leçons apprises

  1. 8080 est un port disputé sur cette machine (Linux Journey). Tout nouveau service local devrait d’abord faire ss -ltnp.
  2. 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.
  3. setsid nohup … < /dev/null & disown est la façon fiable de garder des serveurs longs vivants entre deux appels d’outils de l’agent.
  4. 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-artifacts au premier setup, et 2–5 min de plus pour le build web de l’UI.
  5. 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.
  6. 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 : ~/.gradle 11 Go, ~/.docker 7,5 Go, ~/.cache 6,4 Go, ~/.npm 4,5 Go, ~/Android 15 Go, ~/VirtualBox VMs 21 Go).