Run any Skill in Manus with one click

build-app-local

Stars2

Forks0

UpdatedMay 8, 2026 at 16:41

Build Qaio App locally (macOS). Clean stale artifacts, pnpm tauri build, notarize DMG manually (Tauri skips), staple, verify, copy to ~/Desktop/Qaio-{version}.dmg. Fallback when CI broken.

Installation

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

Run Skill in Manus

Source

akiotanaka847

akiotanaka847/qaio-desktop

View GitHub Repository View Creator Repositories

Download

Run Skill in Manus

Related occupationsSOC

Based on SOC occupation classification

Network and Computer Systems AdministratorsComputer and Mathematical Occupations·SOC 15-1244

SKILL.md

readonly

name	build-app-local
description	Build Qaio App locally (macOS). Clean stale artifacts, pnpm tauri build, notarize DMG manually (Tauri skips), staple, verify, copy to ~/Desktop/Qaio-{version}.dmg. Fallback when CI broken.

/build-app-local

Manual macOS build. CI broken? Use this. Normal path = /release.

Pre-reqs

Env vars set in shell:

APPLE_SIGNING_IDENTITY — Developer ID string
APPLE_API_KEY — App Store Connect key ID
APPLE_API_KEY_PATH — path to .p8
APPLE_API_ISSUER — issuer UUID
TAURI_SIGNING_PRIVATE_KEY + TAURI_SIGNING_PRIVATE_KEY_PASSWORD
POSTHOG_KEY · POSTHOG_HOST · SUPABASE_URL · SUPABASE_ANON_KEY · SENTRY_DSN

Flow

# 0. One-time: ensure both macOS rustup targets installed
rustup target add aarch64-apple-darwin x86_64-apple-darwin

# 1. Clean stale
cd ..  # workspace root
rm -rf app/src-tauri/target/universal-apple-darwin/release/bundle
rm -rf app/dist

# 2. Build engine sidecar for BOTH arches (required for universal)
cargo build --release --target aarch64-apple-darwin -p qaio-engine-server
cargo build --release --target x86_64-apple-darwin -p qaio-engine-server

# 3. Build + auto-sign the app (universal fat binary)
cd app
pnpm tauri build --target universal-apple-darwin

Tauri signs .app. Does NOT notarize DMG. Must do manually:

# 4. Submit DMG to Apple for notarization (note universal path)
DMG="src-tauri/target/universal-apple-darwin/release/bundle/dmg/Qaio_${VERSION}_universal.dmg"
xcrun notarytool submit "$DMG" \
  --key "$APPLE_API_KEY_PATH" \
  --key-id "$APPLE_API_KEY" \
  --issuer "$APPLE_API_ISSUER" \
  --wait

# 5. Staple ticket to DMG
xcrun stapler staple "$DMG"

# 6. Verify
xcrun stapler validate "$DMG"
spctl -a -vvv -t install "$DMG"
lipo -info "$(hdiutil attach "$DMG" -nobrowse -mountpoint /tmp/hmnt -quiet && echo /tmp/hmnt/*.app/Contents/MacOS/qaio-engine)"
# → expect: "Architectures in the fat file: ... x86_64 arm64"
hdiutil detach /tmp/hmnt -quiet

Output

cp "$DMG" ~/Desktop/Qaio-${VERSION}.dmg

Verify install

Open DMG on clean Mac
Drag to Applications
Launch — no Gatekeeper warning
Check "About Qaio" version matches

Common issues

"App is damaged" — stapling failed. Re-staple.
Notarization rejected — xcrun notarytool log <submission-id> --key ... to see reason.
Code sign identity not found — check security find-identity -v -p codesigning. Must match $APPLE_SIGNING_IDENTITY exactly.
Slow notarization — Apple servers variable. 2-15 min typical.

When to use vs /release

Situation	Skill
Normal release	`/release`
CI broken, need ship now	`/build-app-local`
Testing build locally, not releasing	`/build-app-local`, skip step 6
Auto-updater broken, users stuck on old version	`/build-app-local` + manual distribution

More from this repository

same repository

debug

akiotanaka847/qaio-desktop

Debug bugs in Qaio. NEVER guess. Read log files first (backend + frontend). Add targeted tracing/logger if not enough info. Never ask user to copy-paste terminal output.

2026-05-082

release

akiotanaka847/qaio-desktop

Ship new Qaio version. Bump semver across all packages, tag, push, let CI build + sign + notarize. STOP at draft — user publishes manually. Defaults patch bump. Minor needs explicit user permission.

2026-05-082

process-my-statements

akiotanaka847/qaio-desktop

Process a batch of PDF or CSV bank and credit-card statements end to end: extract every transaction (parallel Haiku subagents), canonicalize the party names, categorize against your locked chart of accounts (parallel Sonnet subagents), detect inter-account transfers, and assemble a reviewed Google Sheets workbook with a formula-driven P&L. Reconciliation mismatches surface as warnings, low-confidence categorizations land in Suspense — I never invent an account code, never silently plug a number, never post to your accounting system.

2026-05-082

set-up-my-books

akiotanaka847/qaio-desktop

Set up your books from scratch with one founder interview that captures entity, fiscal year, accounting method, registered accounts, payroll posture, revenue model, investor cadence, and tax preparer, then writes the live bookkeeping brief every other skill reads first. Sub-mode `mode=opening-balances` captures your opening trial balance from a spreadsheet, CSV, or prior-accountant export. I never connect a bank, post to a general ledger, or move money from this skill — facts and a brief, full stop.

2026-05-082

set-up-my-legal-info

akiotanaka847/qaio-desktop

Tell me the basics about your company so I can give you better legal help. I ask a few quick questions about your entity, cap table, contracts in force, templates, and any open risks. You only need to do this once, and I keep it updated as things change.

2026-05-082

set-up-my-marketing-info

akiotanaka847/qaio-desktop

Tell me the basics about your company, your customer, and how you talk so I can give you better marketing help. I ask a few quick questions about your product, positioning, ideal customer, voice, and what you're selling right now. You only need to do this once, and I keep it updated as things change.

2026-05-082

name	build-app-local
description	Build Qaio App locally (macOS). Clean stale artifacts, pnpm tauri build, notarize DMG manually (Tauri skips), staple, verify, copy to ~/Desktop/Qaio-{version}.dmg. Fallback when CI broken.

/build-app-local

Manual macOS build. CI broken? Use this. Normal path = /release.

Pre-reqs

Env vars set in shell:

APPLE_SIGNING_IDENTITY — Developer ID string
APPLE_API_KEY — App Store Connect key ID
APPLE_API_KEY_PATH — path to .p8
APPLE_API_ISSUER — issuer UUID
TAURI_SIGNING_PRIVATE_KEY + TAURI_SIGNING_PRIVATE_KEY_PASSWORD
POSTHOG_KEY · POSTHOG_HOST · SUPABASE_URL · SUPABASE_ANON_KEY · SENTRY_DSN

Flow

# 0. One-time: ensure both macOS rustup targets installed
rustup target add aarch64-apple-darwin x86_64-apple-darwin

# 1. Clean stale
cd ..  # workspace root
rm -rf app/src-tauri/target/universal-apple-darwin/release/bundle
rm -rf app/dist

# 2. Build engine sidecar for BOTH arches (required for universal)
cargo build --release --target aarch64-apple-darwin -p qaio-engine-server
cargo build --release --target x86_64-apple-darwin -p qaio-engine-server

# 3. Build + auto-sign the app (universal fat binary)
cd app
pnpm tauri build --target universal-apple-darwin

Tauri signs .app. Does NOT notarize DMG. Must do manually:

# 4. Submit DMG to Apple for notarization (note universal path)
DMG="src-tauri/target/universal-apple-darwin/release/bundle/dmg/Qaio_${VERSION}_universal.dmg"
xcrun notarytool submit "$DMG" \
  --key "$APPLE_API_KEY_PATH" \
  --key-id "$APPLE_API_KEY" \
  --issuer "$APPLE_API_ISSUER" \
  --wait

# 5. Staple ticket to DMG
xcrun stapler staple "$DMG"

# 6. Verify
xcrun stapler validate "$DMG"
spctl -a -vvv -t install "$DMG"
lipo -info "$(hdiutil attach "$DMG" -nobrowse -mountpoint /tmp/hmnt -quiet && echo /tmp/hmnt/*.app/Contents/MacOS/qaio-engine)"
# → expect: "Architectures in the fat file: ... x86_64 arm64"
hdiutil detach /tmp/hmnt -quiet

Output

cp "$DMG" ~/Desktop/Qaio-${VERSION}.dmg

Verify install

Open DMG on clean Mac
Drag to Applications
Launch — no Gatekeeper warning
Check "About Qaio" version matches

Common issues

"App is damaged" — stapling failed. Re-staple.
Notarization rejected — xcrun notarytool log <submission-id> --key ... to see reason.
Code sign identity not found — check security find-identity -v -p codesigning. Must match $APPLE_SIGNING_IDENTITY exactly.
Slow notarization — Apple servers variable. 2-15 min typical.

When to use vs /release

Situation	Skill
Normal release	`/release`
CI broken, need ship now	`/build-app-local`
Testing build locally, not releasing	`/build-app-local`, skip step 6
Auto-updater broken, users stuck on old version	`/build-app-local` + manual distribution