Pure-reference for deciding how large a compatibility matrix a team can afford and for publishing that commitment - defines tier-1 (must work; per-PR) vs tier-2 (must work; nightly) vs tier-3 (should work; pre-release) vs unsupported, with example budgets per product type (web / desktop / mobile / library), the matrix-size cost / coverage trade-off, and 'what we support' external templates. Use when a team must cap how many browser / OS / runtime combos it commits to, or must publish a support policy. This is the BUDGET and support-statement gate - for the traffic-share analysis that picks WHICH specific browsers belong in each tier use browser-matrix-strategy-reference; to execute the resulting matrix use the runners browser-matrix-runner (bundled engines) or selenium-grid-4-runner (self-hosted).
75
94%
Does it follow best practices?
Run evals on this skill
Adds up to 20 points to the overall score
View guide
Passed
No findings from the security scan
Detailed reference for compatibility-budget. The tier model below defines the four commitment levels; the per-product-type tables are starting templates to copy and adjust against your own telemetry.
| Tier | Definition | CI cadence |
|---|---|---|
| Tier 1 | Must work; failure blocks releases. | Per-PR smoke. |
| Tier 2 | Must work; failure blocks releases on detection. | Nightly full suite. |
| Tier 3 | Should work; broken-here is a known issue. | Pre-release manual / weekly. |
| Unsupported | Explicitly out of scope; bugs closed as "not supported." | None. |
The tier signals engineering investment, not user importance - a configuration with low traffic but contractual obligation may be Tier 1.
| Configuration | Tier |
|---|---|
| Chrome (current + 1 prior) | 1 |
| Edge (current) | 1 |
| Safari (current + 1 prior) | 1 |
| Firefox (current) | 2 |
| iOS Safari (current + 1 prior) | 1 |
| Chrome on Android (current) | 1 |
| Firefox Android | 3 |
| Samsung Internet | 3 |
| Internet Explorer | unsupported |
| < Chrome 100 | unsupported |
| Configuration | Tier |
|---|---|
| Chrome (latest stable) | 1 |
| Chrome (current - 1 stable) | 1 |
| Edge (latest) | 2 |
| Firefox | 3 |
| Safari | 3 |
| All others | unsupported |
| Configuration | Tier |
|---|---|
| Node 18, 20, 22 on Linux | 1 |
| Node 18, 20, 22 on macOS | 2 |
| Node 18, 20, 22 on Windows | 2 |
| Bun (current) | 3 |
| Deno (current) | 3 |
| Older Node EOL versions | unsupported |
| Configuration | Tier |
|---|---|
| iOS 17, 16 (current + 1 prior) | 1 |
| iOS 15 | 2 |
| iOS 14 | 3 |
| < iOS 14 | unsupported |
| Android 14, 13 | 1 |
| Android 12 | 2 |
| Android 11 | 3 |
| < Android 11 | unsupported |