Troubleshooting

cargo: command not found when running npm run tauri dev

Add to your shell config (e.g. ~/.zshrc):

source "$HOME/.cargo/env"

Restart the terminal.

Port 1420 is already in use

Dev server port conflict during Tauri dev:

lsof -ti:1420 | xargs kill -9

First tauri dev is very slow

Expected on first compile (often several minutes). Later incremental builds are usually seconds. Use a release build only when you need to profile distribution performance.

ADB not found / devices not appearing

Open Settings (Cmd+,) and set the Android SDK path. Use Health Center (Cmd+Shift+H) to see which tools are missing.

App can't be opened because it is from an unidentified developer

For unsigned local builds: right-click the app → Open once to satisfy Gatekeeper.

White flash on launch

Ensure the WebView loads a dark background early (see app index.html / global styles in the Keynobi repo).