Installation

English | 简体中文

The Fastforge CLI runs as a standalone binary. The CLI does not bundle platform SDKs, build tools, signing tools, or third-party publishing clients.

Install with the Script

macOS / Linux

curl -fsSL https://raw.githubusercontent.com/fastforgedev/fastforge/main/install.sh | sh

The default installation path is /usr/local/bin/fastforge. You can specify an installation directory or version:

curl -fsSL https://raw.githubusercontent.com/fastforgedev/fastforge/main/install.sh \
  | FASTFORGE_INSTALL_DIR="$HOME/.local/bin" sh

curl -fsSL https://raw.githubusercontent.com/fastforgedev/fastforge/main/install.sh \
  | FASTFORGE_VERSION="0.7.0" sh

The installation script supports:

• macOS: Apple Silicon and Intel
• Linux: AArch64 and x86_64 (GNU libc)

If the target directory is not writable, the script requests sudo access.

Windows

Run the following in PowerShell:

iwr https://raw.githubusercontent.com/fastforgedev/fastforge/main/install.ps1 | iex

The default installation path is %LOCALAPPDATA%\fastforge\bin, which is added to the current user's PATH. You can specify a version or directory with environment variables:

$env:FASTFORGE_VERSION = "0.7.0"
$env:FASTFORGE_INSTALL_DIR = "$HOME\bin"
iwr https://raw.githubusercontent.com/fastforgedev/fastforge/main/install.ps1 | iex

Install from Source

Installing from source requires the latest stable Cargo toolchain:

git clone https://github.com/fastforgedev/fastforge.git
cd fastforge
cargo install --path apps/cli

During development, you can run the CLI directly from the repository root without installing it:

cargo run -p fastforge_cli -- --help

Verify the Installation

fastforge --version
fastforge --help

If your shell cannot find the command, confirm that the installation directory is in PATH.

Project Toolchains

Install the dependencies required by the operations you use:

Scenario	Additional dependencies
Android build or analysis	Android SDK; APK analysis requires aapt2 under ANDROID_HOME
AAB analysis	Android SDK aapt2, or bundletool specified through BUNDLETOOL
iOS / macOS builds	macOS, Xcode, and command-line tools
Flutter builds	Flutter SDK and the target platform toolchain, with flutter in PATH
App Store uploads	macOS, xcrun, and valid App Store Connect credentials
Firebase publishing	Firebase CLI
Vercel publishing	Vercel CLI

Uninstall

macOS / Linux:

curl -fsSL https://raw.githubusercontent.com/fastforgedev/fastforge/main/uninstall.sh \
  | sh

Windows:

iwr https://raw.githubusercontent.com/fastforgedev/fastforge/main/uninstall.ps1 | iex

If you used FASTFORGE_INSTALL_DIR during installation, pass the same value when uninstalling.