Makepad Basics Skill
Version: makepad-widgets (dev branch) | Last Updated: 2026-01-19
Check for updates: https://crates.io/crates/makepad-widgets
You are an expert at the Rust makepad-widgets crate. Help users by:
- Writing code: Generate Rust code following the patterns below
- Answering questions: Explain concepts, troubleshoot issues, reference documentation
When to Use
- You need to get started with Makepad or understand basic app structure and boilerplate.
- The task involves project setup,
live_design!, app_main!, or first-screen application wiring.
- You want foundational Makepad guidance before moving into more specific layout, widget, or shader topics.
Documentation
Refer to the local files for detailed documentation:
./references/app-structure.md - Complete app boilerplate and structure
./references/event-handling.md - Event handling patterns
IMPORTANT: Documentation Completeness Check
Before answering questions, Claude MUST:
- Read the relevant reference file(s) listed above
- If file read fails or file is empty:
- Inform user: "本地文档不完整,建议运行
/sync-crate-skills makepad --force 更新文档"
- Still answer based on SKILL.md patterns + built-in knowledge
- If reference file exists, incorporate its content into the answer
Key Patterns
1. Basic App Structure
use makepad_widgets::*;
live_design! {
use link::theme::*;
use link::shaders::*;
use link::widgets::*;
App = {{App}} {
ui: <Root> {
main_window = <Window> {
body = <View> {
width: Fill, height: Fill
flow: Down
<Label> { text: "Hello Makepad!" }
}
}
}
}
}
app_main!(App);
#[derive(Live, LiveHook)]
pub struct App {
#[live] ui: WidgetRef,
}
impl LiveRegister for App {
fn live_register(cx: &mut Cx) {
crate::makepad_widgets::live_design(cx);
}
}
impl AppMain for App {
fn handle_event(&mut self, cx: &mut Cx, event: &Event) {
self.ui.handle_event(cx, event, &mut Scope::empty());
}
}
2. Cargo.toml Setup
[package]
name = "my_app"
version = "0.1.0"
edition = "2024"
[dependencies]
makepad-widgets = { git = "https://github.com/makepad/makepad", branch = "dev" }
3. Handling Button Clicks
impl AppMain for App {
fn handle_event(&mut self, cx: &mut Cx, event: &Event) {
let actions = self.ui.handle_event(cx, event, &mut Scope::empty());
if self.ui.button(id!(my_button)).clicked(&actions) {
log!("Button clicked!");
}
}
}
4. Accessing and Modifying Widgets
// Get widget references
let label = self.ui.label(id!(my_label));
label.set_text("Updated text");
let input = self.ui.text_input(id!(my_input));
let text = input.text();
API Reference Table
| Macro/Type |
Description |
Example |
live_design! |
Defines UI in DSL |
live_design! { App = {{App}} { ... } } |
app_main! |
Entry point macro |
app_main!(App); |
#[derive(Live)] |
Derive live data |
#[derive(Live, LiveHook)] |
WidgetRef |
Reference to UI tree |
#[live] ui: WidgetRef |
Cx |
Context for rendering |
fn handle_event(&mut self, cx: &mut Cx, ...) |
id!() |
Widget ID macro |
self.ui.button(id!(my_button)) |
Platform Setup
| Platform |
Requirements |
| macOS |
Works out of the box |
| Windows |
Works out of the box |
| Linux |
apt-get install clang libaudio-dev libpulse-dev libx11-dev libxcursor-dev |
| Web |
cargo install wasm-pack |
When Writing Code
- Always include required imports:
use makepad_widgets::*;
- Use
live_design! macro for all UI definitions
- Implement
LiveRegister and AppMain traits
- Use
id!() macro for widget references
- Handle events through
handle_event method
When Answering Questions
- Emphasize live design - changes in DSL reflect instantly without recompilation
- Makepad is GPU-first - all rendering is shader-based
- Cross-platform: same code runs on Android, iOS, Linux, macOS, Windows, Web
- Recommend UI Zoo example for widget exploration
Limitations
- Use this skill only when the task clearly matches the scope described above.
- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.
- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.
1---2name: makepad-basics3description: 'CRITICAL: Use for Makepad getting started and app structure. Triggers on:45 makepad, makepad getting started, makepad tutorial, live_design!, app_main!,67 makepad project setup, makepad hello world, "how to create makepad app",89 makepad 入门, 创建 makepad 应用, makepad 教程, makepad 项目结构1011 '12metadata:13 source: https://skillmd.com/skills/iradoweck/makepad-basics14 aas-risk: critical15 aas-source: https://github.com/makepad/makepad16---1718# Makepad Basics Skill1920> **Version:** makepad-widgets (dev branch) | **Last Updated:** 2026-01-1921>22> Check for updates: https://crates.io/crates/makepad-widgets2324You are an expert at the Rust `makepad-widgets` crate. Help users by:25- **Writing code**: Generate Rust code following the patterns below26- **Answering questions**: Explain concepts, troubleshoot issues, reference documentation2728## When to Use29- You need to get started with Makepad or understand basic app structure and boilerplate.30- The task involves project setup, `live_design!`, `app_main!`, or first-screen application wiring.31- You want foundational Makepad guidance before moving into more specific layout, widget, or shader topics.3233## Documentation3435Refer to the local files for detailed documentation:36- `./references/app-structure.md` - Complete app boilerplate and structure37- `./references/event-handling.md` - Event handling patterns3839## IMPORTANT: Documentation Completeness Check4041**Before answering questions, Claude MUST:**42431. Read the relevant reference file(s) listed above442. If file read fails or file is empty:45 - Inform user: "本地文档不完整,建议运行 `/sync-crate-skills makepad --force` 更新文档"46 - Still answer based on SKILL.md patterns + built-in knowledge473. If reference file exists, incorporate its content into the answer4849## Key Patterns5051### 1. Basic App Structure5253```rust54use makepad_widgets::*;5556live_design! {57 use link::theme::*;58 use link::shaders::*;59 use link::widgets::*;6061 App = {{App}} {62 ui: <Root> {63 main_window = <Window> {64 body = <View> {65 width: Fill, height: Fill66 flow: Down6768 <Label> { text: "Hello Makepad!" }69 }70 }71 }72 }73}7475app_main!(App);7677#[derive(Live, LiveHook)]78pub struct App {79 #[live] ui: WidgetRef,80}8182impl LiveRegister for App {83 fn live_register(cx: &mut Cx) {84 crate::makepad_widgets::live_design(cx);85 }86}8788impl AppMain for App {89 fn handle_event(&mut self, cx: &mut Cx, event: &Event) {90 self.ui.handle_event(cx, event, &mut Scope::empty());91 }92}93```9495### 2. Cargo.toml Setup9697```toml98[package]99name = "my_app"100version = "0.1.0"101edition = "2024"102103[dependencies]104makepad-widgets = { git = "https://github.com/makepad/makepad", branch = "dev" }105```106107### 3. Handling Button Clicks108109```rust110impl AppMain for App {111 fn handle_event(&mut self, cx: &mut Cx, event: &Event) {112 let actions = self.ui.handle_event(cx, event, &mut Scope::empty());113114 if self.ui.button(id!(my_button)).clicked(&actions) {115 log!("Button clicked!");116 }117 }118}119```120121### 4. Accessing and Modifying Widgets122123```rust124// Get widget references125let label = self.ui.label(id!(my_label));126label.set_text("Updated text");127128let input = self.ui.text_input(id!(my_input));129let text = input.text();130```131132## API Reference Table133134| Macro/Type | Description | Example |135|------------|-------------|---------|136| `live_design!` | Defines UI in DSL | `live_design! { App = {{App}} { ... } }` |137| `app_main!` | Entry point macro | `app_main!(App);` |138| `#[derive(Live)]` | Derive live data | `#[derive(Live, LiveHook)]` |139| `WidgetRef` | Reference to UI tree | `#[live] ui: WidgetRef` |140| `Cx` | Context for rendering | `fn handle_event(&mut self, cx: &mut Cx, ...)` |141| `id!()` | Widget ID macro | `self.ui.button(id!(my_button))` |142143## Platform Setup144145| Platform | Requirements |146|----------|--------------|147| macOS | Works out of the box |148| Windows | Works out of the box |149| Linux | `apt-get install clang libaudio-dev libpulse-dev libx11-dev libxcursor-dev` |150| Web | `cargo install wasm-pack` |151152## When Writing Code1531541. Always include required imports: `use makepad_widgets::*;`1552. Use `live_design!` macro for all UI definitions1563. Implement `LiveRegister` and `AppMain` traits1574. Use `id!()` macro for widget references1585. Handle events through `handle_event` method159160## When Answering Questions1611621. Emphasize live design - changes in DSL reflect instantly without recompilation1632. Makepad is GPU-first - all rendering is shader-based1643. Cross-platform: same code runs on Android, iOS, Linux, macOS, Windows, Web1654. Recommend UI Zoo example for widget exploration166167## Limitations168- Use this skill only when the task clearly matches the scope described above.169- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.170- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.