Skip to content

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:

mise run windows:installer -- --version 0.1.0

To package an already prepared bundle:

uv run packaging/windows/build_installer.py --bundle dist/windows --version 0.1.0
  • 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

uv run tests/windows_packaged_startup.py --bundle dist/windows

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.

See test isolation, runtime limits, and recordings.