| name | verify |
| description | Build, launch, and drive the Writer desktop app to verify a change end-to-end via the WebDriver e2e harness. Use when a change to apps/desktop needs runtime verification (GUI surface). |
Verifying Writer desktop changes
The surface is a macOS Tauri GUI. Drive it through the repo's WebdriverIO +
tauri-webdriver harness in apps/desktop/e2e/ (see its README for one-time
setup: cargo install tauri-webdriver --locked).
Build
cd apps/desktop/src-tauri
cargo tauri build --features e2e --bundles app --ignore-version-mismatches \
--config '{"identifier":"com.writer-computer.e2e","bundle":{"createUpdaterArtifacts":false}}'
Gotchas:
--ignore-version-mismatches is required while the npm @tauri-apps/*
packages lag the Rust crates; without it the CLI hard-errors before
building.- The bundle lands at
src-tauri/target/release/bundle/macos/Writer.app/Contents/MacOS/desktop
(binary keeps the crate name). Incremental rebuilds are fast; the first
build is slow.
- Rebuild after every frontend change too — the app ships the built assets.
Launch state
The e2e app uses its own data dir:
~/Library/Application Support/com.writer-computer.e2e. Fresh dir → welcome
screen (workspace opens need a native dialog you cannot drive). To land in a
workspace, seed before launch:
printf '["/abs/path/to/workspace-dir"]' > \
"$HOME/Library/Application Support/com.writer-computer.e2e/recent_workspaces.json"
Startup restores recent_workspaces[0] when it is a directory. Wipe the data
dir between runs for deterministic settings.
Drive
cd apps/desktop/e2e
pnpm exec wdio run ./wdio.conf.js --spec ./specs/<your>.spec.js
- Wait for
button[aria-label="Hide sidebar"] to detect mount+restore. Do
NOT wait for .animate-fade-in — that wrapper no longer exists (the smoke
spec still references it and fails; known rot).
- Key chords through the driver are flaky on WKWebView; dispatch synthetic
KeyboardEvents via browser.execute instead (Cmd+P opens the palette;
palette items are [cmdk-item][data-value="<command-id>"]).
setValue on empty inputs can throw in the driver's clear step — use
addValue.- Real Rust IPC is reachable via
window.__TAURI_INTERNALS__.invoke(cmd, args) inside
browser.executeAsync (see specs/smoke.spec.js).
- Screenshots:
browser.saveScreenshot(absPath).
specs/font-picker.spec.js self-skips when no workspace restored; it's a
working example of palette → settings → popover driving.
