Cross-OS desktop client for self-hosted Coolify instances. Replace browser-tab juggling with native app: project overview, status at a glance, one-click restart/redeploy, drill-down config, and image-freshness check for docker/compose workloads.
Stack: Tauri 2 + Svelte 5 (runes) + TypeScript + Vite + shadcn-svelte UI + Rust backend (HTTP via tauri-plugin-http, secrets via tauri-plugin-keyring, settings via tauri-plugin-store).
Target users: self-hosters running Coolify who want a native ops panel.
- Connect to user-supplied Coolify URL with Bearer token.
- Sortable overview of all resources (applications + services + databases) across projects/environments.
- Live-ish status per resource (
running/exited/degraded/starting). - One-click Restart and Redeploy (pull latest).
- Detail view per resource: FQDN/URL, env vars, build pack, git ref, ports, health-check config, raw docker-compose (if present), logs (last N lines).
- Outdated image check for docker / docker-compose resources: compare image digests against remote registries (Docker Hub, GHCR, quay.io).
- Creating/deleting resources.
- Editing env vars (read-only first).
- Server provisioning, GitHub-app setup, cloud-token mgmt.
- Real-time log streaming (poll last N lines is enough).
- Multi-account / multi-instance switching (single instance v1).
- Auto-updater (defer).
Base: {user_url}/api/v1 — header Authorization: Bearer {token}.
OpenAPI spec: https://raw.githubusercontent.com/coollabsio/coolify/main/openapi.json — generate TS types from this.
| Purpose | Endpoint |
|---|---|
| List apps | GET /applications |
| List services | GET /services |
| List databases | GET /databases |
| List projects | GET /projects |
| App detail | GET /applications/{uuid} |
| Service detail | GET /services/{uuid} |
| Restart app | POST /applications/{uuid}/restart |
| Restart service | POST /services/{uuid}/restart |
| Redeploy app | POST /applications/{uuid}/deploy or /redeploy |
| Logs | GET /applications/{uuid}/logs |
| Health probe | GET /health (no auth) |
Status field: combined string running:healthy, exited:unhealthy, degraded, starting, excluded. Parse : split.
Resource detail fields used: uuid, name, fqdn, build_pack, git_repository, git_branch, git_commit_sha, docker_compose_raw, docker_registry_image_name, docker_registry_image_tag, ports_exposes, env vars, config_hash.
src/ Svelte 5 frontend (runes)
lib/
api/ typed Coolify client (calls Rust commands)
components/ shadcn-svelte primitives + app components
stores/ $state-based reactive stores
types/ OpenAPI-generated TS types
routes/ SvelteKit filesystem routes
+page.svelte (overview)
resource/[uuid]/+page.svelte
settings/+page.svelte
src-tauri/
src/
lib.rs tauri commands entrypoint
coolify.rs HTTP client (reqwest via plugin-http), bearer injection
registry.rs oci-distribution: digest fetch + compare
secrets.rs keyring wrappers
capabilities/ allowlist for http://*/api/v1 patterns
tauri.conf.json
Why Rust-side HTTP: avoids CORS, hides token from webview, lets us add retry/timeout/cache logic centrally.
Why shadcn-svelte: matches user preference, Svelte 5 native, includes Table/Dialog/Button/Card/Input — covers entire UI need without extra deps.
For each docker_compose_raw or docker_registry_image_name:tag:
- Parse compose YAML → list of
image:tagrefs (Rustserde_yaml). - For each ref: fetch
Docker-Content-Digestvia OCI v2 manifest API usingoci-distributioncrate. - Compare against
:latesttag digest and highest semver tag digest (/v2/<name>/tags/list). - Cache
{image:tag → digest, checked_at}intauri-plugin-store(image-digests.json) for offline diffing and rate-limit friendliness. - UI: badge per resource — green (current), yellow (newer semver), red (latest moved). Detail view lists per-image status.
Rate limit: Docker Hub anon = 100 pulls / 6h. Cache aggressively; show last-checked timestamp; manual "Check now" button (not auto-poll all).
Auth: anonymous by default. Settings allow per-registry tokens (GHCR PAT, Docker Hub PAT) stored via keyring.
[Svelte component] --invoke('list_resources')--> [Rust command]
|
v
reqwest -> Coolify /api/v1
|
v
typed JSON -> Svelte $state
Polling: overview page refreshes every 15s while focused; manual refresh button always available.
- Onboarding — Coolify URL + token input, "Test connection" calls
/health+/teams. Save via keyring. - Overview — sortable table of resources. Columns: name, project/env, type (app/service/db), status badge, FQDN, last-deploy, image-freshness badge, actions (restart / redeploy / open).
- Detail — tabs: Overview / Env / Compose / Logs / Images.
- Settings — Coolify URL, token rotation, registry tokens, polling interval, theme.
pnpm tauri devboots, app window opens on macOS first (primary dev OS).- Onboarding: paste valid token → green "Connected" + team name.
- Overview lists ≥1 resource from a real Coolify instance; sort by status/name works.
- Click Restart on a sandbox app → Coolify dashboard confirms restart event within 5s.
- Detail page renders FQDN, env vars (masked), compose YAML.
- Image-check on a known-stale image (e.g.
nginx:1.20) shows yellow badge. - Build artifacts:
pnpm tauri buildproduces.dmg(mac),.msi(win),.AppImage(linux). Test mac first.
- Token scope — does Coolify let us create a read+deploy token, or is it all-or-nothing?
- Logs endpoint — streaming or polling? Confirm against actual instance.
- Compose-only services: do we get
docker_compose_rawfor all service types or only the "generic" ones?
- Scaffold Tauri 2 + Svelte 5 + TS + shadcn-svelte.
- Add plugins: http, keyring, store.
- Onboarding screen + token storage.
- Rust
coolify.rsHTTP wrapper + typed commands. - Generate TS types from OpenAPI.
- Overview page with sortable table (shadcn DataTable).
- Status polling + manual refresh.
- Restart + Redeploy buttons (with confirm dialog).
- Detail page (tabs).
- Logs tab (poll last 500 lines).
registry.rs— oci-distribution digest fetch + cache.- Image-freshness badges in overview + detail.
- Settings page (URL rotation, registry tokens).
- Bundle config — mac/win/linux targets.
- README + screenshots.