Desktop Apps

Pohualli desktop UI is implemented with Flutter and uses the Python JSON-RPC backend.

Architecture

• Frontend: flutter/pohualli_desktop
• Backend process: pohualli-rpc (bundled as pohualli-rpc-bin in release artifacts)
• Build workflow: .github/workflows/flutter-desktop.yml

Local Development

cd flutter/pohualli_desktop
flutter pub get
flutter run -d macos      # or: flutter run -d windows

If host platform folders are missing, generate them:

flutter create . --platforms=macos,windows

Release Artifacts

For tags v*.*.*, the Flutter Desktop workflow publishes:

• macOS zip (PohualliDesktop-<version>-macOS.zip) when notarization secrets are set
• macOS unsigned zip (PohualliDesktop-<version>-macOS-unsigned.zip) when secrets are missing
• Windows zip (PohualliDesktop-<version>-windows.zip)

Direct download links by release tag:

• Generic pattern: https://github.com/muscariello/pohualli-python/releases/download/<tag>/<file.zip>
• macOS signed: https://github.com/muscariello/pohualli-python/releases/download/<tag>/PohualliDesktop-<version>-macOS.zip
• macOS unsigned: https://github.com/muscariello/pohualli-python/releases/download/<tag>/PohualliDesktop-<version>-macOS-unsigned.zip
• Windows: https://github.com/muscariello/pohualli-python/releases/download/<tag>/PohualliDesktop-<version>-windows.zip

Example for v0.4.0:

• https://github.com/muscariello/pohualli-python/releases/download/v0.4.0/file.zip
• https://github.com/muscariello/pohualli-python/releases/download/v0.4.0/PohualliDesktop-0.4.0-macOS.zip
• https://github.com/muscariello/pohualli-python/releases/download/v0.4.0/PohualliDesktop-0.4.0-windows.zip

macOS First Run

If you install an unsigned build:

1. Move PohualliDesktop.app to /Applications (optional).
2. Control-click the app and select Open.
3. Confirm Open in the Gatekeeper dialog.

Windows First Run

If SmartScreen warns on unsigned binaries, select More info and Run anyway.