Nexus OS Docs

Appearance

Writing Recipes ​

Foundry recipes are KDL manifests that describe the edition, target platform, modules, and build constraints for a Nexus image.

Minimal Recipe ​

kdl
edition "NEXUS_MECH" {
    target "aarch64-virt"

    kernel {
        scheduler "harmonic-hard"
        memory "locked"
    }

    modules {
        include "nip:drivers/imu/bno055"
        include "nip:lib/kinematics"
    }

    constraints {
        no_heap = true
        max_boot_ms = 500
    }
}

Local Checks ​

Validate structure before submitting a build:

bash
nexus recipe validate recipes/micro.kdl

Preview the build plan:

bash
nexus build --edition=mech --arch=aarch64 --dry-run