Layout

Prefer Flutter-native structure choices:

• Column, Row, Flex, Wrap
• Expanded and Flexible
• SizedBox or shared gap widgets with ScreenUtil sizing
• CustomScrollView and slivers for long pages
• Align, Padding, ConstrainedBox, LayoutBuilder

Layout Fix Patterns

• move from a flat scroll of repeated cards to clearly separated sections
• replace nested containers with simpler hierarchy and spacing
• keep titles, summaries, metadata, and actions visually distinct
• tighten local spacing within a section and increase spacing between sections
• use max-width or constrained composition for wide layouts
• reduce centered composition when left alignment improves scanning

What Good Looks Like In This Repo

• operational clarity beats visual novelty
• primary action is obvious
• key metrics or statuses are readable without decoration overload
• list items scan quickly
• forms feel sectional, not like one long wall

Verify

Check:

• first-screen comprehension
• spacing consistency
• hierarchy clarity
• overflow at small widths
• large text scale behavior
• alignment of interactive elements and labels

Never

• solve hierarchy only with more cards
• nest cards inside cards by default
• treat every section as visually equal
• use raw pixel spacing values when ScreenUtil or shared spacing exists