Gap
Gap is space that a container puts between its Flexbox or Grid children. The same rule applies to every pair.
Another example
A toolbar uses one gap value. When a new button is added, the spacing stays even.
Main parts
- 01Outer constraint
- 02Content and spacing model
- 03Computed size or reflow result
Use it when
Use gap when the layout, not each child, should control the space between sibling items.
Do not use it when
Never add margins to each child when gap shows the relationship more clearly.
Name used in code
gap Before you ship
Check content order, shared design values, component consistency, contrast, zoom, and layout changes by screen size. Verify every theme, language, and state. If there is motion, offer an equal reduced-motion experience.
Outcome: Use or define Gap to make the visual experience clear and easy to use. User context: A toolbar uses one gap value. When a new button is added, the spacing stays even. Design concept to apply: Gap. Why it fits: Use gap when the layout, not each child, should control the space between sibling items. Do not use it when: Never add margins to each child when gap shows the relationship more clearly. Design requirements: Set the content order, shared design values, and reusable components. Define how the layout changes by screen size and state. Keep useful design choices separate from decoration. Inclusion and resilience: Check contrast, zoom, languages, themes, and reduced motion when needed. Do not use color or effects as the only way to show meaning. Acceptance criteria: The design stays clear on phones and desktops, at zoom, in every theme, and in all supported languages. Interactive states stay clear and consistent. Evidence and limits (evidence boundary): A formal document may still be a draft, release candidate, or final version. Check its status and browser or platform support. Unknowns to confirm: Brand limits, amount of content, supported themes and languages, target devices, and design-system rules.
Check this request
Review the current use of Gap. Definition: Gap is space that a container puts between its Flexbox or Grid children. The same rule applies to every pair. Release checks: Check content order, shared design values, component consistency, contrast, zoom, and layout changes by screen size. Verify every theme, language, and state. If there is motion, offer an equal reduced-motion experience. Before changing code, report the evidence you found, gaps, severity, and the smallest safe fix.