Skip to content

Latest commit

 

History

History
104 lines (73 loc) · 3.24 KB

MACOS_ALPHA_BUILD.md

File metadata and controls

104 lines (73 loc) · 3.24 KB

macOS Alpha Build

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.

Local Build Command

From the repository root:

bun install --frozen-lockfile
bun run build:studio:desktop

The root script delegates to:

bun run --cwd apps/studio build:desktop

The app-level script runs:

tauri build --bundles app --ci --no-sign

That 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.

Artifact Path

The local alpha artifact is:

apps/studio/src-tauri/target/release/bundle/macos/IgnitionRL Studio Alpha.app

The release binary is also built at:

apps/studio/src-tauri/target/release/ignitionrl-studio

Alpha Bundle Metadata

Current 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.

Verified Locally

The alpha build command was verified on macOS with:

bun run --cwd apps/studio tauri build --bundles app --ci --no-sign

Observed output included:

Finished 1 bundle at:
apps/studio/src-tauri/target/release/bundle/macos/IgnitionRL Studio Alpha.app

Known Gaps

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.

CI Recommendation

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 --ci

Once 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.