Build, verify, and install CCResDoc.app locally for testing. Use when: (1) User says 'build ccresdoc', 'rebuild ccresdoc', 'install ccresdoc', 'ccresdoc-build', (2) User wants a fresh CCResDoc.app after Rust, app/, or src-tauri changes, (3) After Rust or zfb-output changes that need verification in the bundled .app.
Standardmäßig ist der Prompt ausgewählt, der zuerst die Quelle prüft. Sie können zu einem direkten Befehl wechseln oder eine lokale Kopie herunterladen.
Quelldateien prüfen
Lesen Sie SKILL.md und alle von SkillsMP angezeigten Begleitdateien, bevor Sie sich für eine Installation entscheiden.
Mit Codex oder Claude installieren Kopieren Sie diesen Prompt, fügen Sie ihn in Codex, Claude oder einen anderen Assistant ein und lassen Sie die Skill-Seite prüfen und installieren.
Ein direkter Befehl überspringt den Prüf-Prompt. Prüfen Sie die Quelle, bevor Sie ihn ausführen.
Build, verify, and install CCResDoc.app locally for testing. Use when: (1) User says 'build ccresdoc', 'rebuild ccresdoc', 'install ccresdoc', 'ccresdoc-build', (2) User wants a fresh CCResDoc.app after Rust, app/, or src-tauri changes, (3) After Rust or zfb-output changes that need verification in the bundled .app.
Local CCResDoc Build & Install
Clean rebuild, verify fresh assets, kill any running instance, install to /Applications/, launch.
Arguments
None. Always builds the single Tauri target defined in src-tauri/tauri.conf.json.
pnpm (Node at setup time only — not required at runtime)
The user is in the admin group (default on personal Macs) — /Applications/ write needs no sudo
Architecture recap
CCResDoc.app is a thin Tauri host with node-free runtime:
The bundled app/ tree (under Contents/Resources/_up_/app/) carries a pre-installed
node_modules that includes the native @takazudo/zfb-<platform>/zfb binary.
At launch the Tauri host resolves a writable workspace: dev = the repo app/
(already has node_modules); bundled = a versioned copy placed at
<app_data_dir>/app-workspace/.
The host spawns the in-process Rust watcher (ccresdoc-claude-md: walks ~/.claude/
→ writes MDX), then spawns
(the native binary, NOT the Node-shebang wrapper), polls on
, and navigates the WebView once ready.
node_modules/@takazudo/zfb-<platform>/zfb dev --port 4892
.bin/zfb
GET /
http://localhost:4892/
Workflow
Step 1: Ensure app/ deps are installed
cargo tauri build's beforeBuildCommand runs this automatically, but a manual
pre-check speeds up debugging if node_modules is stale:
cd app && pnpm install
This populates node_modules including the native @takazudo/zfb-darwin-arm64/zfb binary.
Node is only needed here — not at runtime.
Step 2: Clean
Cargo can cache stale Resources/ artifacts when app/dist/ changes. Always clean the Tauri crate first:
cargo tauri build runs cd app && pnpm install && pnpm exec zfb build automatically
(via beforeBuildCommand in src-tauri/tauri.conf.json; Tauri runs build hooks from the
project root, so the path is app, not ../app). This invokes the native zfb
binary through pnpm — no global zfb on PATH required. Produces both .app and .dmg
bundles under target/release/bundle/.
cargo tauri build
Build time on a warm cache: ~1.5 min Rust + ~10 s bundling. Cold cache: ~3-5 min total.
Step 4: Verify bundle freshness
Check that the bundled app/dist/ exists and node_modules includes the native binary:
BUNDLE=target/release/bundle/macos/CCResDoc.app/Contents/Resources/_up_/app
[ -d "$BUNDLE/dist" ] || { echo"FAIL: bundled dist/ missing"; exit 1; }
# Verify any @takazudo/zfb-* native binary exists in the bundled node_modules.# On the primary build host (macOS arm64) this is @takazudo/zfb-darwin-arm64.ls"$BUNDLE/node_modules/@takazudo"/zfb-*/zfb 2>/dev/null | grep -q . || \
{ echo"FAIL: no native zfb binary found in bundled node_modules/@takazudo/"; exit 1; }
echo"Bundle looks good: $(du -sh $BUNDLE/dist | cut -f1) dist"
If verification fails, the build is stale or pnpm install did not run. Inspect:
