Operations
Troubleshooting
Common failure modes, debugging patterns, and practical steps to recover fast.
Recommended debugging strategy
Reduce the YAML to the smallest working version first. Then add groups, links, labels, and presets back incrementally until the faulty block is isolated.
Common issues
- Blank preview or generation error: validate the YAML structure first. A missing Canvas, bad Type, or malformed Links block is the most common cause.
- Incorrect resource icon: verify that the definition file URL is valid and points to a compatible AWS definition set.
- Unexpected light/dark appearance: clear localStorage theme settings or use the theme switcher to resync the UI state.
- draw.io output opens but looks different: check zoom, previous manual edits, and whether the source YAML changed.
- CLI works but local web app fails: make sure the Go API is running on port 8080 before starting the frontend, or use vercel dev.
- Vercel deploy ignores dashboard build settings: this repository uses builds in vercel.json, so file-based config takes precedence.