# Islandflow Desktop Shell

This workspace packages a thin Electron shell around the hosted Islandflow app.

## What It Does

- Loads `https://flow.deltaisland.io` by default.
- Supports local UI development against `http://127.0.0.1:3000`.
- Preserves the existing remote API and WebSocket behavior from the web app.
- Keeps Electron privileges locked down for remote content.

## What It Does Not Do

- Bundle a local backend.
- Ship a packaged local Next.js renderer in v1.
- Add desktop-native features beyond launch, windowing, and packaging.

## Workspace Commands

- `bun run start` builds the main process and launches Electron Forge in dev mode.
- `bun run package` creates a packaged unsigned macOS app bundle.
- `bun run make` creates a macOS zip distributable for the current host architecture.
- `bun run test` runs the desktop URL-policy tests.

## Development Notes

- `ISLANDFLOW_DESKTOP_START_URL` controls which trusted app URL Electron loads. Prefer `/options` for deep links; `/tape` remains supported and redirects in the web app for compatibility.
- `NEXT_PUBLIC_API_URL` remains a web-app setting and should typically be `https://api.flow.deltaisland.io` when developing the local UI inside Electron.
- `assets/` currently contains placeholders only; a real `.icns` icon is deferred.
