Files

southseact-3d f1f32a430c fix: Add Windows installer registry entries, launch after install, and app icon

- Added Plugin.png as app icon in windows-app/assets/
- Updated NSIS config with runAfterFinish to launch app after install
- Added installer.nsh for proper Windows registry entries
- Fixed icon paths to use PNG format
- App now properly registers in Windows Installed Apps

2026-02-16 19:01:39 +00:00

assets

fix: Add Windows installer registry entries, launch after install, and app icon

2026-02-16 19:01:39 +00:00

scripts

Convert Windows app to Electron and add Android Capacitor app with CI builds

2026-02-16 09:40:31 +00:00

src-tauri

Bump the cargo group across 1 directory with 2 updates

2026-02-10 21:25:04 +00:00

.env.example

Restore to commit 74e578279624c6045ca440a3459ebfa1f8d54191

2026-02-07 20:32:41 +00:00

.gitignore

Restore to commit 74e578279624c6045ca440a3459ebfa1f8d54191

2026-02-07 20:32:41 +00:00

BUILD_FIX_CHECKLIST.md

Restore to commit 74e578279624c6045ca440a3459ebfa1f8d54191

2026-02-07 20:32:41 +00:00

electron-bridge.js

Convert Windows app to Electron and add Android Capacitor app with CI builds

2026-02-16 09:40:31 +00:00

electron-main.js

Rename to Plugin Compass, add mobile onboarding/signin, implement self-update for desktop, and fix workflow paths

2026-02-16 12:05:30 +00:00

electron-preload.js

Rename to Plugin Compass, add mobile onboarding/signin, implement self-update for desktop, and fix workflow paths

2026-02-16 12:05:30 +00:00

installer.nsh

fix: Add Windows installer registry entries, launch after install, and app icon

2026-02-16 19:01:39 +00:00

package-lock.json

Restore to commit 74e578279624c6045ca440a3459ebfa1f8d54191

2026-02-07 20:32:41 +00:00

package.json

fix: Add Windows installer registry entries, launch after install, and app icon

2026-02-16 19:01:39 +00:00

README.md

Rename to Plugin Compass, add mobile onboarding/signin, implement self-update for desktop, and fix workflow paths

2026-02-16 12:05:30 +00:00

tauri-bridge.js

Restore to commit 74e578279624c6045ca440a3459ebfa1f8d54191

2026-02-07 20:32:41 +00:00

tauri.conf.json

Restore to commit 74e578279624c6045ca440a3459ebfa1f8d54191

2026-02-07 20:32:41 +00:00

README.md

Plugin Compass Desktop (Electron)

This folder contains the desktop app build for Plugin Compass. The desktop app reuses the existing web UI and wraps it with a native Electron shell that can run OpenCode locally, save output on the user's machine, and sync finished plugins to the backend.

Features

Reuses the existing web UI with minimal divergence.
Self-updating via electron-updater (no manual downloads required).
Run OpenCode locally with API keys pulled securely from the backend.
Persist work on the user's device and sync results back to the backend.
Build via GitHub Actions.

Self-Update System

The app includes an automatic update system using electron-updater:

Automatic Check: On startup, the app checks for updates from GitHub Releases.
Background Download: Updates download in the background without interrupting the user.
User Notification: When an update is ready, the user is notified via the UI.
One-Click Install: User can restart the app to apply the update.

How Updates Work

Updates are published to GitHub Releases by the CI workflow.
electron-updater downloads the new version from GitHub.
The update is verified before installation.
Users can choose when to restart and apply the update.

Developer Notes

Updates require code-signing for production (not needed for testing).
The update server is GitHub Releases (configured in package.json).
Update events are exposed via window.windowsAppBridge:
- checkForUpdates() - Manually check for updates
- downloadUpdate() - Download available update
- installUpdate() - Restart and install
- onUpdateAvailable(callback) - Listen for update available
- onUpdateDownloaded(callback) - Listen for update ready
- onDownloadProgress(callback) - Track download progress

Setup

Install prerequisites (Node 18+).
From this folder: npm install.
Pull UI assets: npm run prepare-ui.

Development

npm run dev starts Electron using the copied UI in ui-dist.
Commands are exposed via window.windowsAppBridge.

CI build

GitHub Actions workflow: .github/workflows/build-electron-app.yml.
The action runs on windows-latest, builds the app, and publishes to GitHub Releases.

Security notes

No command exposes the stored API key to the web layer.
OpenCode is only invoked from the main process with the key set via environment variables.
File system access is restricted to the app data directory.