Build — 5 min

Onboarding

One topic: get from clone to running app. No architecture dump here — that's next page.

Prerequisites

Same across macOS / Linux — Zig nightly, not stable

zig env # check std_dir — should be master nightly
# if `zig` points at Homebrew stable, grab https://ziglang.org/download nightly

macOS: brew install gtk4 pango cairo glib sqlite3
Debian/Ubuntu: sudo apt install libgtk-4-dev libsqlite3-dev
Fedora: sudo dnf install gtk4-devel sqlite-devel

See docs/GEMINI.md for Zig 0.16+ IO migration and docs/ZIG_DISCOVERIES.md for nightly gotchas.

Run it

git clone https://github.com/4cecoder/metanoia
cd metanoia
zig build run         # desktop
# or
./mobile/gradlew assembleDebug   # Android (Android Studio)

First run seeds data/bible.db (118 MB LXXE+NKJV+interlinear) — tracked via .gitignore: !data/bible.db.

Next: Architecture

Kit (12 files), bible_db split, aikit sidecars

Stuck?

Check Docs or open an issue with zig env + build.zig.zon:minimum_zig_version

Back: Corpus principles

Next: Docs — Architecture