I've added a debug tip to CONTRIBUTING.md and I thought it would be good to repeat it here as well:
Use a debug build of the compiler. We have many asserts enabled in the debug compiler that can alert you to something going wrong. When building from source, build the debug compiler with
cargo build --bin roc, the binary is at roc/target/debug/roc. When using roc through a nix flake like in basic-cli, userocPkgs.cli-debuginstead ofrocPkgs.cli
Last updated: Nov 28 2025 at 12:16 UTC