Check the obvious first.

First checks

Rust	Confirm a current Rust toolchain. The source README currently lists MSRV 1.88.
Checkout	Run commands from the root of runebender-xilem, not from this website repo.
Command	Try cargo run before adding file paths or verbose flags.
Logs	Use cargo run — —verbose when collecting detail for an issue.

• Use an included example first: assets/untitled.ufo or assets/hyper-matisse.ufo.
• Keep real font sources in version control before testing alpha editing behavior.
• If a path fails, verify it relative to the source repo root.
• Use Examples to choose which included UFO matches the behavior you are testing.

Image-to-outline checks

Background image	Import, align, and scale the bitmap before judging tracing output.
Local tracing	Use img2bez first when offline behavior or reproducibility matters.
Cloud tracing	QuiverAI requires network access, API credentials, and API credits.
Cleanup	Expect traced outlines to need manual review and metric adjustment.

• Use Format for orientation, then verify exact behavior in the source repo.
• Use the canonical hyperbezier UFO extension spec for storage details.
• Use assets/hyper-matisse.ufo when testing hyperbezier-specific behavior.
• Convert hyperbeziers to cubic outlines before relying on tools that do not understand Runebender extensions.

When a problem looks real, collect the smallest useful report.

• Source repository commit or checkout date.
• Command used to launch the app.
• UFO path or example file name.
• Expected behavior and actual behavior.
• Whether the problem affects local tracing, QuiverAI tracing, normal cubic outlines, or hyperbezier outlines.