Quickstart

1. Install the CLI

npm install -g @buildtree/cli

The binary on your PATH is buildtree. Requires Node 22 or later.

2. Sign in

buildtree login

Authorise the session in the browser when prompted.

3. Upload a build

buildtree upload ./app.apk

The CLI prompts for:

• Project. Pick an existing one or create a new one inline.
• Environment. A short label such as dev, staging, or prod.
• Branch. Optional. Skip to mark the build as the environment's checkpoint.

The install URLs and a QR code are printed on completion.

4. Share the install URL

Two URLs are produced per upload:

• Pinned: locked to this exact build.
• Folder: always serves the latest for the environment and branch.

5. Run it from CI

buildtree upload ./app.apk \
  --project acme \
  --env dev \
  --branch "$GITHUB_REF_NAME"

Use an API token from the dashboard and set BUILDTREE_TOKEN. See the GitHub Actions guide.