DevForge

Plateforme de déploiement moderne, avec agents IA, GitHub et GitHub Actions.

Greenfield v2 — monorepo Rust + Astro. Legacy archivé : bobdivx/devforge-alpha.

Wiki : manuel produit (source dans wiki/).
Brand : brand/ — logo ; URL publique : deploy/zimaos/icon.svg.

Installer (utilisateur)

Releases : GitHub Releases · détails : wiki/Installation.

Plateforme	Comment
Docker	export DEVFORGE_VERSION=… puis docker compose up -d
Windows	DevForge-Setup-<version>-x64.exe
Linux	Flatpak DevForge-<version>-x86_64.flatpak (voir ci-dessous)

Linux Flatpak

1. Installer Flatpak si besoin (Arch / CachyOS) :

   sudo pacman -Syu
   sudo pacman -S flatpak
   # optionnel (KDE) : sudo pacman -S discover

2. Installer l’app :

   flatpak install --user ./DevForge-<version>-x86_64.flatpak
   flatpak run io.github.bobdivx.DevForge

Le fichier .flatpak n’est pas un paquet Pacman. Sous CachyOS/KDE, ne pas l’ouvrir avec CachyOS Package Installer — utiliser le terminal ou Discover. En cas de 404 pacman, refaire -Syu avant d’installer flatpak / discover.

Docker et Git doivent être présents sur la machine hôte (le Flatpak les appelle via le socket / le PATH).

Structure

apps/
  web/          # Astro + Preact + Tailwind 4
  server/       # Axum — HTTP /api/v1 + SSE
crates/
  shared/ agent/ deploy/ github/ database/ mcp/ env/
  ports/ domain/ proxy/ wireguard/ cluster/

Quick start

npm install
npm run dev
# → front http://127.0.0.1:8080  ·  API http://127.0.0.1:8000
# (cargo-watch relance le serveur Rust à chaque modif dans apps/server + crates)

# Séparé si besoin :
# npm run dev:web
# npm run dev:server

Variables :

• DATABASE_URL — défaut sqlite:devforge.db?mode=rwc (fichier à la racine du monorepo)
• HOST / PORT — bind du server (défaut 0.0.0.0:8000)
• PUBLIC_SERVER_URL — base HTTP du front vers le server (défaut http://127.0.0.1:8000/api/v1)
• Optionnel : apps/server/.env (chargé automatiquement par npm run dev)

Tests

cargo test --workspace
npm run check:forbidden
npm run build -w apps/web

Modules

Voir docs/MODULES.md — inventaire crates (ports, domain, proxy, wireguard, deploy, github versions, etc.).

Global : Accueil · Projects · Agent · Team · Settings
Projet : Overview · Deployments · Domains · Env · Settings · Agent

MCP & Env

• MCP serveur : GET /api/v1/mcp/tools — tools DevForge exposés aux clients MCP.
• MCP client : GET/POST /api/v1/mcp/servers — brancher d’autres MCP ; tools agent mcp_*.
• Env apps : GET/POST /api/v1/projects/{uuid}/env — secrets masqués dans les réponses agent.
• Preview : l'atelier ne monte pas les secrets de prod (opt-in preview_allowed). Publier exige POST /api/v1/projects/{uuid}/publish-approval (15 min) avant trigger_deploy.

Archive alpha

Voir docs/alpha.md.