Ui

When the UI is waiting on an async task:

Motion should be purposeful — guide attention, show spatial relationships, and provide

Use color with intention — never as the sole means of conveying information.

Choose the right pattern for the content type and user task.

Every user action should have visible feedback. The weight of the feedback should match

Forms are where users do real work. Reduce friction at every step.

Icons supplement text — they do not replace it (except for universally understood symbols

Design for the content, not a fixed screen size. Layouts should adapt gracefully from

Defer to these canonical sources before applying the defaults in this file:

All UI components MUST include preview declarations for rapid visual verification during development. Previews should...

Use a consistent spatial scale based on a **4px base unit** (8px primary grid). All spacing,

Every view that loads data or can be empty must handle all four states explicitly. Never

Interactive elements MUST be large enough to tap or click accurately. Defer to the platform

Use the platform's system font. Establish a type scale with clear roles — don't invent

Establish clear importance through size, weight, color, and spacing. Every screen should