Windows builds¶
Requirements¶
- x64 Windows.
- MSVC C++ build tools and a Windows SDK.
- Rust 1.94.0, Zig 0.17.1 on PATH, Godot 4.7.2.
- A normal, non-elevated desktop terminal launched by Explorer for GUI and live-agent tests.
SSH service launches do not reproduce desktop input or GPU behavior. A working terminal or agent badge alone does not verify Ctrl+C or graph delivery.
Build and launch¶
From PowerShell in the repository root:
rustup toolchain install 1.94.0
.\tools\build-windows.ps1
.\tools\build-cli.ps1
godot --editor --headless --path frontends/godot/project --import
godot --path frontends/godot/project res://scenes/terminal.tscn
For subsequent changes:
| Change | Command |
|---|---|
| CLI/server | mise run core:build |
| Extension and native dependencies | mise run dev:build |
| Build and launch | mise run dev |
| GDScript only | mise run dev -- --reload |
See development launches for restart choices and Windows Chromium for browser builds.
Installer¶
Requires Inno Setup 6, matching Godot export templates and the Chromium runtime:
To package an already prepared bundle:
- Output:
dist/installers/. - Installs to
%LOCALAPPDATA%\Programs\Graffitty. - Signing is not configured; these are unsigned development installers.
- See Windows packaging for checksums and publication.
Validate the exported app¶
Run on the logged-in desktop, or a scheduled task with Interactive logon. SSH service sessions are reported as blocked. Headless compilation does not verify the native window frame or Direct3D swap chain.