How-tos
Task recipes.
Short practical recipes for common alpha tasks. Each recipe points to the canonical page for context and avoids detailed UI promises that may change before release.
| Status | Alpha recipe index |
|---|---|
| Audience | Early users, testers, contributors, agents |
| Source | Website docs and Runebender Xilem README |
| Stability | Recipe goals are stable; exact UI behavior may move |
Run with a file
Use this when you want to open a specific UFO directly from the command line.
cargo run -- assets/untitled.ufo See Xilem install for native-editor prerequisites and first-run notes.
Run with logs
Use verbose logging when testing alpha behavior or preparing a useful issue report.
cargo run -- --verbose Include the source checkout, command, UFO path, and expected behavior when reporting a bug.
Trace locally
- Import a background image.
- Align and scale it against the glyph metrics.
- Use local img2bez tracing.
- Clean up the resulting outlines manually.
See Tracing for the current tracing map.
Trace with QuiverAI
- Confirm that cloud tracing is acceptable for the source image.
- Configure an API key through the supported config path or environment variable.
- Run the QuiverAI trace command from the app.
- Review and clean up the generated outlines.
QuiverAI requires network access, an API key, and API credits. Prefer local tracing when reproducibility or privacy matters.
Convert hyperbeziers
Use conversion when a downstream tool needs standard cubic outlines rather than Runebender hyperbezier contours.
| Convert | Cmd/Ctrl + Shift + H |
|---|---|
| Read first | Format notes |
| Exact spec | Hyperbezier UFO extension |
Find implementation code
- Start with Source map.
- Use the README and source tree as the source of truth.
- Keep website edits broad unless implementation behavior is settled.
- Update agent-readable files when a page is added or moved.