CONTRIBUTING#

Thanks for helping out!

⚠️ Dakota uses BuildStream 2 — not Containerfiles#

Dakota is built with BuildStream 2 (BST), not a Containerfile or DNF/RPM like mainline Bluefin. If you're here to change something in the Bluefin image, you probably want projectbluefin/common instead.

If you're here to package new software for the BST-based image, read AGENTS.md first — all build instructions, BST workflow, PR checklist, branch conventions, and mandatory gates live there. The README also references AGENTS.md.

Check the Contributing Guide for general contribution information and the architecture diagram.

Prerequisites#

• podman — required for BST sandbox execution
• just — brew install just or your OS package manager

BST itself runs inside the pinned bst2 container — use just bst ... rather than installing bst directly.

Pull requests#

• Open PRs against the testing branch
• Run just validate && just lint before opening a PR
• Follow Conventional Commits for commit messages

Where things live#

project.conf # BST project configuration
elements/ # BST element files (.bst) — one per package
patches/ # Patches applied to junction elements via patch_queue
files/ # Static files installed by elements

Full build reference and BST workflow: AGENTS.md