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-debug
instead ofrocPkgs.cli
Last updated: Jul 05 2025 at 12:14 UTC