Skip to content
Wun

Install

TL;DR. Clone the repo, run ./install.sh, then wun doctor should print green checks. The CLI is a single Babashka script that walks up to find the monorepo root, so it works from anywhere inside a Wun checkout.

Prerequisites

Wun ships as a monorepo of language-native runtimes. You need:

toolfor
Java 21+running the Pedestal/Jetty server
Clojureserver + cljs builds via shadow-cljs
Node 18+shadow-cljs npm deps + the docs site
Babashkathe wun CLI itself
Swift 5.9+iOS / macOS demo (Xcode toolchain on Mac)
Gradle 8+Compose Desktop / Android demo

wun doctor will tell you what’s missing once the CLI is on PATH.

Install the CLI

  1. Clone the framework.

    Terminal window
    git clone https://github.com/Holy-Coders/wun.git
    cd wun

  2. Run the installer. Pick whichever fits your shell:

    Terminal window
    # from a clone:
    ./install.sh
    

    # or, once the repo is publicly hosted:
    curl -fsSL https://raw.githubusercontent.com/Holy-Coders/wun/master/install.sh | bash

    The installer ensures Babashka is on PATH (offers brew install on macOS), then symlinks bin/wun into /usr/local/bin/ (or ~/.local/bin/ if the former isn’t writable). Re-running is safe — the symlink is overwritten in place.

  3. Verify.

    Terminal window
    wun doctor

    You should see green checkmarks for each tool plus ✓ repo root: …. If anything is missing, the doctor output points at the install command for that tool.

Auto-upgrade

If the local checkout falls behind, the next wun <cmd> shows:

! wun is 3 commits behind master (1 BREAKING)
  upgrade now? [y/N]

Hit y to fast-forward and re-run migrations, or N to skip.