Desktop Smoke Tests

Use this checklist before calling a desktop build healthy on macOS, Linux, or Windows.

Current build matrix

The current CI workflow in .github/workflows/build-tauri.yml produces:

  • macOS arm64

  • Linux x86_64

  • Linux arm64

  • Windows x86_64

Windows ARM64 is only partially supported in code today:

  • the Tauri runtime resolves the ARM64 sidecar target

  • the CI workflow does not build or publish a Windows ARM64 artifact yet

  • local ARM64 testing still depends on a native sidecar environment

Startup

Check:

  • the desktop app launches without a console window on Windows

  • only one title bar is visible on Windows and Linux

  • the startup screen progresses, then the main UI loads

  • a startup failure shows the inline error screen instead of a blank window

  • startup logs are written to the native desktop log directory

Project selection

Check:

  • opening an existing project works

  • invalid recent projects are detected and can be removed

  • creating a project rejects invalid names such as CON, bad/name, trailing dots, or trailing spaces

  • switching projects updates the backend context without restarting the whole desktop app

Core workflows

Check:

  • import starts and reaches progress updates

  • transform starts and reaches progress updates

  • site export starts and reaches progress updates

  • feedback submission either succeeds or fails with a useful local diagnostic

  • updater can check, download, and install an update

Platform-specific checks

Windows

  • no extra terminal window opens

  • installer and updater both complete without leaving the UI stuck at 0%

  • project creation rejects Windows-reserved names

  • opening external links works for http, https, and mailto, and rejects other schemes

Linux

  • updater handles the privileged install step cleanly

  • PyInstaller bundle contains required native GIS dependencies

  • native window decorations remain intact

macOS

  • overlay title bar still leaves enough drag area

  • traffic lights remain accessible

  • startup, project switching, and updater still work after the Tauri hardening passes