Configs
stylelint-plugin-grid exports two ESM-first shareable configs.
| Config | Purpose |
|---|---|
๐ข โ gridPluginConfigs["grid-recommended"] | Low-noise checks for broadly applicable CSS Grid correctness. |
๐ฃ โ gridPluginConfigs["grid-all"] | Every public rule, including stricter same-stylesheet policy checks. |
Use grid-recommended first, then move selected stricter rules into your local
config after confirming they match your project's file boundaries.
Config Pagesโ
grid-recommendedenables the low-noise baseline.grid-allenables every public rule, including same-stylesheet policy checks.- Current status explains why some rules are kept out of the recommended config.
Rules by Configโ
Fix legend: ๐ง = autofixable ยท โ = report only
Config legend: โ = enabled ยท โ = not enabled
| Rule | Fix | grid-all | grid-recommended | Description |
|---|---|---|---|---|
consistent-area-naming | โ | โ | โ | Require consistent naming for grid-template-areas and single-name grid-area identifiers. |
no-conflicting-placement | โ | โ | โ | Disallow same-block CSS Grid placement declarations that write the same placement slot. |
no-dense-auto-flow | โ | โ | โ | Disallow grid-auto-flow: dense because it can reorder auto-placed grid items visually. |
no-ineffective-container-properties | โ | โ | โ | Disallow CSS Grid container declarations in blocks whose final literal display value is not grid-capable. |
no-invalid-areas | โ | โ | โ | Disallow malformed grid-template-areas declarations. |
no-invalid-auto-repeat | โ | โ | โ | Disallow definitely invalid CSS Grid auto-repeat track sizes. |
no-invalid-minmax | โ | โ | โ | Disallow flexible fr values as the minimum argument in CSS Grid minmax() track sizes. |
no-invalid-repeat-count | โ | โ | โ | Disallow invalid fixed repeat counts in CSS Grid track templates. |
no-invalid-span | โ | โ | โ | Disallow non-positive span counts in CSS Grid placement declarations. |
no-mismatched-template-rows | โ | โ | โ | Require grid-template-rows track count to match grid-template-areas row count. |
no-overlapping-areas | โ | โ | โ | Disallow multiple selectors assigning the same single-name grid-area value in one stylesheet. |
no-reversed-placement-lines | โ | โ | โ | Disallow reversed or zero-width numeric CSS Grid placement line ranges. |
no-unknown-areas | โ | โ | โ | Disallow single-name grid-area references that do not match any named area declared in the same stylesheet. |
no-unused-areas | โ | โ | โ | Disallow named template areas that are never referenced by a single-name grid-area declaration in the same stylesheet. |
no-zero-grid-lines | โ | โ | โ | Disallow line 0 in CSS Grid placement declarations. |
prefer-gap-properties | ๐ง | โ | โ | Prefer modern gap, row-gap, and column-gap properties over legacy grid gap aliases. |
prefer-minmax-zero-fr | โ | โ | โ | Prefer minmax(0, <flex>) for bare flexible CSS Grid column tracks. |
require-explicit-rows-with-column-flow | โ | โ | โ | Require explicit row sizing when a rule uses grid-auto-flow: column. |
require-explicit-tracks-with-areas | โ | โ | โ | Require explicit track sizing alongside CSS Grid named area templates. |
validate-area-shapes | โ | โ | โ | Require every named grid template area to form one contiguous rectangle. |
validate-track-counts | โ | โ | โ | Require template row and column track counts to match grid-template-areas dimensions. |