SuperPlane Desktop (unofficial)

Desktop Electron wrapper that runs SuperPlane locally via Docker.

🚀 Download for your OS (make sure you have Docker installed)

Development

How it works

A loader screen shows live Docker output while the image is pulled and the container starts. Once the app responds on http://127.0.0.1:3000/health, the loader transitions to the main app window. Closing the window stops the container.

Prerequisites

• Node.js (v20+)
• pnpm
• Docker

Setup

pnpm install

Run

pnpm start

The app will:

1. Pull ghcr.io/superplanehq/superplane-demo:stable
2. Start the container on port 3000
3. Open SuperPlane in an Electron window once ready

Data is persisted in the spdata Docker volume.

Build

pnpm build          # current platform
pnpm build:linux    # AppImage + deb
pnpm build:mac      # dmg
pnpm build:win      # nsis installer

Output goes to the dist/ folder.

Release

Push a version tag to build all platforms and create a GitHub Release:

git tag v0.1.0
git push origin v0.1.0

You can also trigger a build manually from the Actions tab without creating a release.