Patterns

Proven patterns for building robust Makepad applications.

Widget Patterns

Data Patterns

Layout Patterns

Advanced Patterns

Community Patterns

See community/ for more community-contributed patterns.

To contribute your own pattern, use the template at 99-evolution/templates/pattern-template.md.

Pattern Selection Guide

For UI State

• Simple toggle: Use widget instance variables
• Multiple states: Use State Machine
• Mutually exclusive: Use Radio Navigation

For Data

• One-time fetch: Use Async Loading
• Incremental display: Use Streaming Results
• Persist settings: Use Local Persistence

For Performance

• Large lists: Use List Template
• Heavy views: Use LRU View Cache
• Background work: Use Tokio Integration

For Layouts

• IDE/studio with resizable panels: Use Dock-Based Studio Layout
• Grid with variable columns per row: Use Row-Based Grid Layout
• Drag-to-reorder widgets: Use Drag-Drop Reorder
• Simple fixed grid: Use View with flow: Down and nested flow: Right rows

For Custom Rendering

• 3D widgets: Use Custom 3D Widget
• Custom geometry: Create GeometryFields implementation with unique instance_id
• Multiple meshes: Use template pattern to share shaders across DrawMesh instances

References

• Robrix – Matrix chat client
• Moly – AI model manager