v3.x · Design preview

The v3.x installer, screen-by-screen

A static React prototype of the v3.x wizard. This is a design artifact, not the shipped installer — it renders the same color, symbol, and box-drawing vocabulary `src/cli/` will use, so the visual contract is verifiable before any user runs it.

Below is the 6-tab embed from the home page, hosted full-width here. The full 75-screen browser with sidebar navigation and three render modes (color, NO_COLOR, ASCII) is on the roadmap — see v3 roadmap for context.

In design · v3.xWizard preview

A declarative installer. 75 designed screens. Built terminal-first.

v3.x replaces the 9-phase imperative installer with a 5-layer engine: parser → validator → planner → executor → state. Adds rollback, dry-run, resume, channel switching, and a silent NDJSON mode for CI. It's also bigger than just the installer — the spec-driven pipeline becomes five first-class skills and ~12 new hooks enforce what was prose-only. Click through the highlights.

$ npx devforgeai install
____ ______ ___ ____ / __ \ ___ _ __/ ____/___ _________ ____ / | / / / / / / / _ \ | / / /_ / __ \/ ___/ __ `/ _ \ / /| | / / / /_/ / / __/ V / __/ / /_/ / / / /_/ / __// ___ |/ / /_____/ \___/\_/ /_/ \____/_/ \__, /\___/ // |_/__/ /____/
Spec-Driven Development Framework v3.0.0-beta
Zero technical debt. AI-powered quality gates.
? Where do you want to install?
(default: ./my-app)
❯
[Step 1/12 — Welcome]
Step 1/12The banner: ASCII art, version, and the first prompt — install target directory. Step 1 of 12 in the v3.x wizard.
Coming in v3.x

Five skills. Twelve new hooks. Seven CLI gates. One declarative engine.

40+ ADRs ratified across PRs #8–#138. The spec-driven pipeline is now five first-class architecture skills; ~12 new hooks mechanically enforce what was prose-only; seven new CLI validators gate phase progression. The installer modernization is six of those ADRs. Currently Proposed; ships as v3.0.0-beta first, then GA. --legacy keeps v2 behaviour for one minor cycle.

ADR-100 · Manifest schemaADR-101 · Engine architectureADR-102 · Dual-mode UXADR-103 · Python ownershipADR-104 · v2→v3 migrationADR-105 · Update channels

The DevForgeAI v3.x installer preview is a static React prototype that renders all 75 designed wizard screens with three rendering variants: default color, NO_COLOR (color-stripped), and TERM=dumb (ASCII fallback). It is a design artifact only — the shipped installer is in src/cli/ and follows the same visual specification. The prototype lives at docs/installer/preview/ in the repo and embeds the design language defined in devforgeai/specs/design/installer/design-foundation/design.md.