Installing the Developer Setup GUI

Use a pre-built release for your platform. You do not need the Rust toolchain or a dev environment to run the app. Releases do not ship Windows .msi or macOS notarized install bundles from this repository — you get a Windows .exe, a macOS standalone binary, and a Linux Flatpak (.flatpak) built from a Tauri .deb.

Download

The latest build is on GitHub: Releases (FoodTruckNerdz/onboarding).

On that page, download an asset for your system, for example:

  • Windows (x64): the setup-gui-x86_64-pc-windows-msvc.exe in Assets.

  • macOS: the *-apple-darwin file in Assets (the workflow builds on macos-latest, typically Apple Silicon / aarch64).

  • Linux (x64): the com.foodtrucknerdz.setup-x86_64.flatpak in Assets (single-file Flatpak; requires Flatpak on your system).

The same chmod and run instructions are repeated below and in the repository README so you do not have to rely on the release STANDALONE-README.txt alone. That text file is still attached to every release for anyone who only has the GitHub release link.

If you are behind a managed PC or strict antivirus, the Windows executable may need an explicit allow rule; the file is an unsigned (or not-yet notarized) community build. Choose More info on SmartScreen and Run anyway if you trust the repository.

Linux: install the Flatpak

  1. Install Flatpak (see distribution setup for your OS).

  2. Install the downloaded bundle (replace the filename with the one from Assets):

flatpak install --user com.foodtrucknerdz.setup-x86_64.flatpak

You may be prompted to add the Flathub remote the first time so the org.gnome.Platform runtime can be installed. The app is packaged with --filesystem=home so it can read and write project files under your home directory; see the manifest in the repository if you need to audit those permissions.

Run with flatpak run com.foodtrucknerdz.setup (or your desktop’s launcher) after installation.

macOS: make the file executable, then run

GitHub and many browsers do not preserve the Unix executable bit on downloaded assets. In a shell, go to the folder where you saved the file and use the real filename from Assets:

chmod +x setup-gui-aarch64-apple-darwin
./setup-gui-aarch64-apple-darwin

If the OS blocks the app (e.g. Gatekeeper on macOS), adjust Privacy & Security or build from source; see Developing.

Run

  1. On Windows, run the *.exe as usual (double-click or from a terminal). No chmod step.

  2. On macOS, run the binary as in the macOS section above; on Linux, use the Linux (Flatpak) section.

  3. Open FoodTruckNerdz Setup (the window title of the app).

  4. When prompted, set the project path to your local clone of ftn-site (or the repo you are onboarding to).

  5. Complete prerequisite checks, env setup, and API keys with the in-app flow.

Source instead of a release

If you prefer to build the desktop app from source, see Developing the Developer Setup GUI.

Related