This document defines the first reproducible macOS desktop alpha build path for IgnitionRL Studio.
The alpha target is an unsigned Tauri .app bundle. DMG packaging, Developer ID
signing and notarization are listed as explicit gaps below.
From the repository root:
bun install --frozen-lockfile
bun run build:studio:desktopThe root script delegates to:
bun run --cwd apps/studio build:desktopThe app-level script runs:
tauri build --bundles app --ci --no-signThat command builds the React/Vite frontend, compiles the Tauri shell in release
mode and bundles a macOS .app without invoking DMG creation or code signing.
The local alpha artifact is:
apps/studio/src-tauri/target/release/bundle/macos/IgnitionRL Studio Alpha.appThe release binary is also built at:
apps/studio/src-tauri/target/release/ignitionrl-studioCurrent Tauri alpha metadata:
- product name:
IgnitionRL Studio Alpha; - window title:
IgnitionRL Studio Alpha; - bundle identifier:
ai.ignitionrl.studio; - version:
0.1.0; - publisher:
IgnitionAI; - category:
DeveloperTool; - icons:
32x32.png,128x128.png,128x128@2x.png,icon.icns,icon.ico.
The version stays numeric because macOS bundle metadata expects a standard release version string. The alpha status is expressed in the product name and release documentation.
The alpha build command was verified on macOS with:
bun run --cwd apps/studio tauri build --bundles app --ci --no-signObserved output included:
Finished 1 bundle at:
apps/studio/src-tauri/target/release/bundle/macos/IgnitionRL Studio Alpha.app| Gap | Current status | Required before public distribution |
|---|---|---|
| Developer ID signing | Disabled with --no-sign. |
Configure Apple Developer Team ID, signing identity and CI secrets. |
| Notarization | Not configured. | Add Apple notarization credentials and staple notarization tickets. |
| DMG packaging | tauri build with DMG currently fails in the local headless environment during bundle_dmg.sh. |
Re-enable and verify tauri build --bundles dmg on a signed macOS release runner. |
| Universal binary | Current local artifact is architecture-specific. | Install both Apple targets and build with --target universal-apple-darwin. |
| CI artifact upload | Not enabled. | Add a macOS GitHub Actions release job that uploads .app or signed .dmg artifacts. |
| Icon finalization | Bundle icons are configured and present. | Replace placeholder/early alpha artwork before external release if branding changes. |
Do not add this build to every PR yet. The current PR CI runs on Ubuntu and already validates the TypeScript, Rust workspace, frontend build and smoke projects. A macOS bundle job should be added as a manual or release-only workflow when signing/notarization secrets exist.
Recommended future command for that job:
bun install --frozen-lockfile
bun run --cwd apps/studio tauri build --bundles app --ciOnce signing is configured, remove --no-sign from the release job. Once DMG is
stable, switch the release job to --bundles dmg or build both app and dmg.