build-app-local

Builds, signs, notarizes and copies a universal Qaio macOS DMG to the desktop.

2|Updated May 8, 2026
One-click install
npx skills add https://github.com/akiotanaka847/qaio-desktop --skill build-app-local
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: build-app-local
Source: https://github.com/akiotanaka847/qaio-desktop/tree/main/skills/build-app-local
Command: npx skills add https://github.com/akiotanaka847/qaio-desktop --skill build-app-local

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill solves the problem of getting the Qaio app built and distributed when CI/release automation is broken, by providing a reliable manual macOS build-and-release workflow.

Core Features & Use Cases

  • Deterministic local universal builds: Builds the engine sidecar for both aarch64-apple-darwin and x86_64-apple-darwin, then produces a universal pnpm tauri build --target universal-apple-darwin app.
  • Clean rebuilds and controlled artifacts: Removes stale bundle and dist outputs to reduce mismatched artifacts and “works on my machine” issues.
  • Manual notarization workflow for DMG: Performs Apple notarization and DMG stapling because Tauri skips DMG notarization, then verifies Gatekeeper acceptance and architecture correctness.
  • One-stop distribution for quick shipping: Copies the resulting DMG to ~/Desktop/Qaio-{version}.dmg and includes validation steps for installation on a clean Mac.

Quick Start

Ask it to perform a local universal macOS build and produce a notarized DMG on your machine using the required Apple signing and notarization environment variables.

Frequently Asked Questions about build-app-local

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I manually notarize a Tauri DMG on macOS when CI is unavailable?

Building a universal macOS binary requires compiling Rust sidecars for both aarch64-apple-darwin and x86_64-apple-darwin targets, then running pnpm tauri build with the universal-apple-darwin target to produce a single fat binary that runs natively on both architectures.

What environment variables do I need to set up for local macOS app notarization?

Local macOS app notarization requires Apple signing and notarization environment variables to be configured before starting the build. These credentials allow xcrun notarytool to submit your DMG to Apple and staple the resulting notarization ticket to the distributed application.

How do I validate that a notarized DMG passes Gatekeeper on a clean Mac?

Validating a notarized DMG involves stapling the notarization ticket using xcrun stapler and then running spctl assessment to verify Gatekeeper acceptance. The workflow also checks architecture correctness to ensure the universal binary is properly structured for distribution.

How do I clean stale artifacts before doing a Tauri universal build?

Cleaning stale artifacts before a Tauri universal build involves removing old bundle and dist output directories. This controlled cleanup reduces mismatched artifacts and prevents works on my machine issues by ensuring the notarized DMG is built from a deterministic local state.

Why does my Tauri macOS build fail Gatekeeper validation after distribution?

A Tauri macOS build fails Gatekeeper validation because Tauri skips DMG notarization during its build process. You must manually notarize the DMG using xcrun notarytool, staple the resulting ticket, and run spctl validation to ensure Gatekeeper accepts the distributed application.