Skip to content

UX-041: Bundle size budgets

Statement

JavaScript and CSS bundle sizes per surface shall have documented budgets enforced in continuous integration. Pull requests that exceed a budget shall fail unless the budget is updated with rationale in the same change.

Rationale

Bundle size is the upstream cause of most LCP regressions. Tracking it directly catches regressions earlier and keeps the conversation about cost-vs-value at the moment a dependency is added, not months later when the budget is already blown.