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

GitHub Release DMGs are signed and notarized. This warning is most likely from a local/source build or an app copied before notarization finished. For local builds, right-click the app → Open once to satisfy Gatekeeper.

Update indicator does not show a newer release

Keynobi checks the latest GitHub Release. Confirm you are online, then open the Releases page directly if the status bar cannot reach GitHub from your network.

White flash on launch

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