Install Stacki

Stacki is a desktop app. Download a build, or clone the repository and run it yourself. The app is identical either way.

Download

Builds for macOS (universal .dmg) and Windows (NSIS installer) are published on the releases page. Shipped builds update themselves from that feed, so you only download once.

What your machine needs

Stacki drives the tools your project already uses rather than bundling its own, so those need to be installed:

Tool	Why it is needed
Node.js 18+ and npm	The app shells out to npm install and astro dev for the project you open
git	Branches, commits and the branch chip in the title bar
GitHub CLI (gh)	Only for Publish to GitHub. Authenticate once with gh auth login

A project does not need anything added to it. There is no plugin, no config file and no dependency for Stacki. If npm run dev works in your terminal, the project opens.

Running from source

git clone https://github.com/flowtricks/stacki.git
cd stacki
npm install
npm run dev

npm run dev starts Vite for the interface and launches Electron against it. To run the production interface instead, use npm start.

Building your own installers

An unsigned build needs no Apple Developer account and no certificates:

npm run dist:mac:unsigned   # .dmg + .zip, built on macOS
npm run dist:win            # NSIS installer, built on Windows

Output lands in release/. macOS warns the first time an unsigned build is opened. Right-click the app and choose Open to get past Gatekeeper.

If you publish builds from a fork, change build.appId and build.publish in package.json to your own identifiers so your releases do not collide with the official update feed.