How do I build the system?

Question
Answer
- Day-to-day with compass
- Direct CMake
Script
Tested by
See also

Configure first if you haven't (see How do I configure the project?). For preset / output / parallelism details, see CMake setup.

Question

How do I build ORE Studio?

Answer

Day-to-day with compass

compass build resolves the checkout's preset from ORES_PRESET in .env and configures the build directory automatically on first use:

./compass.sh build                          # everything
./compass.sh build ores.iam.core            # specific target(s)
./compass.sh build site                     # friendly alias (deploy_site)
./compass.sh build --preset linux-clang-release-make   # preset override
./compass.sh build -j 4 --dry-run           # jobs / print-only

Friendly aliases: site → deploy_site, manual → deploy_manual, org-roam-db-sync → org_roam_db_sync; any raw cmake target is also accepted.

For documentation/agile targets, add --direct to skip cmake entirely and run the Emacs build script directly (no cmake/vcpkg — works in light environments): ./compass.sh build --direct site skills settings manual. See How do I deploy the site?.

Direct CMake

The underlying invocation, for when you need to drive cmake yourself:

cmake --build --preset <preset> [--target <target_name>]

Script

compass build (projects/ores.compass/src/compass.py) wrapping cmake --build --preset.

Tested by

CI builds every preset on every push.