Build from source

Requirements

Apple silicon Mac with macOS 26 or later.
Xcode 26 or later and Swift 6.2 or newer.
Git. For the Chromium engine bundle: curl, jq, ripgrep and Python 3.

Get the source

git clone https://github.com/arcusis/shaar.git
cd shaar

Build the browser with its engine

bash scripts/bundle-app.sh --with-engine

The result is build/Shaar.app, signed ad hoc for local development. The script downloads the pinned Chromium framework, checks its SHA-256 and verifies the extracted payload. This is a development build, not a notarized release.

Build the interface without the engine

swift build
swift run ArcusisBrowser

This builds the UI-only preview without downloading Chromium. It does not render webpages. Development builds have no live update feed.

Run checks

swift test --jobs 2
swift format lint --strict --recursive Package.swift Sources Tests
python3 scripts/check-license-headers.py

Engine probes and Python tooling have additional setup. See the contributor guide and full build instructions.

Build this website

cd website
pnpm install --frozen-lockfile
pnpm check
pnpm wrangler dev

Local development needs no Cloudflare token. See website setup for hosting and release-content maintenance.