Performance & Rendering

• Const-First: Every widget that can be const MUST be const.
• Lazy Rendering: Mandatory use of lazy-loading constructs (SliverList.builder or SliverGrid.builder) for any list exceeding 10 items.
• Repaint Boundaries: Wrap complex animations or heavy UI sections in RepaintBoundary to optimize Impeller frame budget.
• Isolate Parsing: Mandate compute() or Isolate for JSON parsing exceeding 1MB to avoid main-thread jank.
• Optimize image handling with cached_network_image
• Handle asynchronous operations cleanly with proper cancellation during widget disposal
• Minimize unnecessary rebuilds using memoization techniques
• Implement pagination for large data sets
• Flatten widget hierarchies where reasonable for better rendering performance
• BuildContext Safety: Check mounted before using context across async gaps to prevent setState after dispose.

Design System

See design-system/SKILL.md for full token definitions (colors, spacing, radius, typography), reusable component rules, theming standards, and accessibility. Always use design tokens — never hardcode values.

Widget Patterns