Build and run

Prebuilt binaries (recommended)

Download the latest release from GitHub:

• https://github.com/mustafamohsen/safeparts/releases

Each release includes:

• safeparts (CLI)
• safeparts-tui (terminal UI)

Quick sanity check:

1. Put the binaries on your PATH.
2. Run safeparts —help.
3. Run safeparts-tui —help.

macOS Gatekeeper

If you download the release binaries via a browser, macOS may quarantine them and show “cannot be opened because the developer cannot be verified”.

If you built from source, you usually will not see this.

If you trust the download and want to remove the quarantine attribute:

# Point this at the folder you extracted the release into
xattr -dr com.apple.quarantine /path/to/safeparts-release/

# Or remove it per-binary
xattr -d com.apple.quarantine /path/to/safeparts
xattr -d com.apple.quarantine /path/to/safeparts-tui

Build from source (Rust)

Prereqs:

• Rust stable + rustfmt and clippy

Build + tests:

cargo build
cargo test --all-features

CI-style lint:

cargo fmt --all -- --check
cargo clippy --all-targets --all-features -- -D warnings

Web UI (Vite + React + WASM)

The web app lives in web/. It runs split/combine in your browser via WASM.

Prereqs:

• Bun
• wasm-pack (or let the build script install it)

Run locally:

cd web
bun install
bun run build:wasm
bun run dev

Open http://localhost:5173.

Web UI + docs (Docker)

If you want a single command that builds WASM + the web UI + the docs site and serves them, you can use the repo’s Dockerfile.

docker build -t safeparts-webui -f web/Dockerfile .
docker run --rm -p 8080:8080 safeparts-webui

Open http://localhost:8080.

Docs: http://localhost:8080/help/

Help/docs site (Astro + Starlight)

This site lives in web/help/ and is served under /help/.

cd web/help
bun install
bun run dev

Open http://localhost:4321/help/.