layout-spacing-checker

name	layout-spacing-checker
description	[Design System] Validate margin/padding/gap values against spacing scale and grid rules. Use when (1) checking if spacing values follow the design system scale, (2) finding off-scale or inconsistent spacing, (3) auditing layout consistency across components, (4) user asks to 'check spacing', 'validate layout', 'audit margins/padding', or 'find off-scale values'.

Layout & Spacing Scale Checker

Validate spacing values against a defined scale and find inconsistencies.

Quick Start

python3 scripts/check_spacing.py --scale spacing.yml --source src/

Issue Types

Type	Severity	Description
off-scale	warning	Value not in spacing scale
inconsistent	info	Different spacing for similar components
zero-spacing	info	Potentially missing spacing
excessive	warning	Unusually large spacing value

Detection Examples

CSS/SCSS

/* off-scale: 17px not in scale */
.card { padding: 17px; }
/* Suggested: 16px (md) or 20px */

SwiftUI

// off-scale: 15 not in scale
.padding(15)
// Suggested: .padding(16) or spacing token .md