Luxury Yacht

Luxury Yacht is a desktop app for managing Kubernetes clusters, available for Linux, macOS, and Windows.

New to Luxury Yacht? Check out the Features page to see what it can do!

Installation

Direct Downloads

Visit Downloads on the web site, or go to the Releases page if you know exactly what you need.

Package Managers

Package manager support is currently limited, but more will be added.

Homebrew (macOS only)

brew install luxury-yacht

If you previously used the custom tap, you can remove it, as Luxury Yacht is now in the public Casks repo.

untap luxury-yacht/tap
brew update

Building from Source

If you prefer to build the app from source, see the Development section.

Troubleshooting

The app won't start on Linux

Luxury Yacht requires webkit2 4.1. Some distros don't include it, or don't install it by default. Installation will vary depending on your distro.

Distro	Installation
Ubuntu 20.04	Unsupported
Ubuntu 22.04	sudo apt install libwebkit2gtk-4.1-0

If your distro isn't on this (admittedly short) list, you'll have to search your package manager to determine the exact package name. If you have info you'd like to add to this list, email admin@luxury-yacht.app or open an issue.

Development

Prerequisites

• Go 1.26
• Node 25
• Wails
• Mage
• Staticcheck

Wails

Luxury Yacht is built with Wails, a framework for building cross-platform apps in Go.

To install Wails:

 go install github.com/wailsapp/wails/v2/cmd/wails@2.11.0

Once Wails is installed, run wails doctor to see what other dependencies are required for your OS.

Staticcheck

Staticcheck is a static analysis linter for Go.

To install Staticcheck:

go install honnef.co/go/tools/cmd/staticcheck@latest

Mage

For scripting builds, testing, releases, etc., Luxury Yacht uses Mage for cross-platform compatibilty. Makefiles and bash scripts are fine for Linux and macOS, but they don't work in Windows. The magefile is written in Go, so should work the same in any OS.

To install Mage:

go install github.com/magefile/mage@latest

To see what mage targets are available, run mage -l in the repo root.

Development Mode

The fastest way to get the app up and running for development is to run in Wails development mode. This gives you hot-reloads and access to the browser console for debugging.

mage dev

Note that hot-reload of the Go backend will cause the app to restart, while changes to frontend code will be reflected immediately without an app restart.

Build

mage build

Install

To install the app locally:

mage install:unsigned

Versions

When updating versions in the app, these are the canonical sources. All scripts/workflows should get app and toolset versions from these sources and these sources only.

App Version

App version is derived from info.productVersion in wails.json

APP_VERSION=$(jq -r '.info.productVersion' wails.json)

Go Version

Go version is derived from go.mod

GO_VERSION=$(grep '^go ' go.mod | awk '{print $2}')

Wails Version

Wails version is derived from go.mod

WAILS_VERSION=$(grep 'github.com/wailsapp/wails/v2' go.mod | awk '{print $2}')

Node Version

Node version is derived from .nvmrc

NODE_VERSION=$(cat .nvmrc | tr -d 'v')

Publishing Releases

Run the prerelease checks. This should surface any problems that could cause the release to fail.

mage qc:prerelease

1. Update the version in wails.json

2. Commit and push the change.

3. Create and push a tag. The release workflow will do the rest.

git tag $(jq -r '.info.productVersion' wails.json)
git push origin main --tags