Debug Makepad Code and Improve Quality
Reference hub skill for Makepad - common error quick-fixes, debug logging tips, and links to production reference apps.
Why it matters
Accelerate your Makepad development by quickly resolving common errors and improving code quality with this comprehensive reference. Get instant solutions for debugging, API lookups, and advanced layout patterns.
Outcomes
What it gets done
Resolve common Makepad build and runtime errors.
Find quick fixes for API usage and UI update issues.
Apply Makepad-aware refactoring for safer code simplification.
Understand and implement adaptive layouts for cross-platform UIs.
Install
Add it to your toolbox
Run in your project directory:
curl -fsSL https://spark.entire.vc/get/ag-makepad-reference | bash Overview
Makepad Reference
A central Makepad reference and debugging hub covering common error quick-fixes, debug logging/line-info tips, and links to official docs and production reference codebases (Robrix, Moly). Use for quick Makepad error diagnosis, API lookups, or as a starting point before a specialized Makepad skill. Not a substitute for the specialized subsystem skills or for testing/review of an actual fix.
What it does
Makepad Reference is a central quick-reference and debugging hub for the Makepad Rust UI framework, distinct from the specialized subsystem skills (basics, DSL, layout, animation, events, fonts, shaders, deployment) in that it's oriented toward diagnosis and lookup rather than writing a focused feature in one subsystem. It provides a navigation table pointing to four reference categories - API documentation lookup, troubleshooting for build/runtime failures, Makepad-aware code-quality refactoring, and adaptive desktop/mobile responsive layout patterns - as a starting point before diving into a more specialized Makepad skill.
Its common-issues quick-reference table covers five recurring problems with their fixes: a "no matching field: font" error (use text_style: <THEME_FONT_*>{} instead), a color-parse error when a hex color ends in e (change the last digit, e.g. #14141e to #14141f), a set_text call missing an argument (add cx as the first argument), UI not updating after a state change (call redraw(cx) explicitly), and a widget-not-found error (check ID spelling and use the ids!() macro for widget paths).
### Run with line info for better error messages
MAKEPAD=lines cargo +nightly run
// Add logging
log!("Value: {:?}", my_value);
log!("State: {} / {}", self.counter, self.is_loading);
It links out to the official Makepad documentation (an Obsidian-published docs site), the Makepad GitHub repository, and two production reference codebases - Robrix and Moly - as real-world examples of Makepad apps to study for patterns beyond the SKILL.md's own scope.
When to use - and when NOT to
Use this skill when you need quick-reference material for common Makepad errors, debugging, or API lookups, or when the task is diagnostic/reference-oriented rather than writing a focused feature within one specific Makepad subsystem - use it as a central starting point before reaching for a more specialized Makepad skill.
It is not a substitute for the specialized Makepad skills (basics, DSL, layout, animation, events, fonts, shaders, deployment) for actually implementing a feature, nor for environment-specific validation, testing, or expert review of a fix.
Inputs and outputs
Inputs: a Makepad build error, runtime bug symptom, or a general question about where to find API documentation or production examples.
Outputs: a quick-fix for a recognized common error, a debug command or logging snippet, or a link to the relevant official documentation or production reference codebase.
Integrations
Points to the official Makepad documentation site, the Makepad GitHub repository, and the Robrix and Moly production reference apps; serves as the entry point to the rest of the Makepad skill family (basics, DSL, layout, animation, event/action, font, shader, deployment).
Who it's for
Makepad developers hitting a build or runtime error, looking for a quick API lookup, or wanting a starting point before diving into a more specialized Makepad skill.
FAQ
Common questions
Discussion
Questions & comments ยท 0
Sign In Sign in to leave a comment.