Skip to content

fix: installer UX — progress feedback + gateway health check#48

Merged
ApiliumDevTeam merged 2 commits intodevfrom
fix/installer-ux-feedback
Mar 27, 2026
Merged

fix: installer UX — progress feedback + gateway health check#48
ApiliumDevTeam merged 2 commits intodevfrom
fix/installer-ux-feedback

Conversation

@ApiliumDevTeam
Copy link
Copy Markdown
Collaborator

Summary

Users don't know what's happening during installation and the portal opens before the gateway is ready.

  • macOS: Progress dialogs during install, cortex setup, onboard, gateway start. Polls /health before opening portal.
  • Linux: notify-send + stdout progress messages. Polls /health before opening portal.
  • Windows: Starts gateway, polls /health before opening browser.

Test plan

  • macOS DMG: shows progress, waits for gateway
  • Linux AppImage: shows progress, waits for gateway
  • Windows shortcut: waits for gateway before opening browser

## Summary

Hotfix: install sharp in /tmp/sharp-tool/ to avoid oxlint peer dep
conflict on macOS CI runners.

## After merge

Re-run `Build Desktop Installers` workflow via workflow_dispatch.
@ApiliumDevTeam ApiliumDevTeam force-pushed the fix/installer-ux-feedback branch 2 times, most recently from d164fa4 to 6047ee8 Compare March 27, 2026 05:42
macOS: show progress dialogs during install, cortex setup, onboard,
and gateway start. Wait for /health before opening portal.

Linux: add notify-send + stdout progress. Wait for /health.

Windows: start gateway, poll /health before opening browser.
@ApiliumDevTeam ApiliumDevTeam force-pushed the fix/installer-ux-feedback branch from 6047ee8 to 0e246b4 Compare March 27, 2026 05:54
@ApiliumDevTeam ApiliumDevTeam merged commit f7decb1 into dev Mar 27, 2026
3 of 4 checks passed
@ApiliumDevTeam ApiliumDevTeam deleted the fix/installer-ux-feedback branch March 27, 2026 13:14
ApiliumDevTeam added a commit that referenced this pull request Mar 27, 2026
## Summary

Users don't know what's happening during installation and the portal
opens before the gateway is ready.

- **macOS**: Progress dialogs during install, cortex setup, onboard,
gateway start. Polls /health before opening portal.
- **Linux**: notify-send + stdout progress messages. Polls /health
before opening portal.
- **Windows**: Starts gateway, polls /health before opening browser.

## Test plan

- [ ] macOS DMG: shows progress, waits for gateway
- [ ] Linux AppImage: shows progress, waits for gateway
- [ ] Windows shortcut: waits for gateway before opening browser
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant