Brotli compression is enabled for text assets
Why it matters
Uncompressed text assets — HTML, CSS, and JavaScript — transfer at their full source size over the network. Brotli compression reduces text payload by 15–25% compared to gzip, and 60–80% compared to uncompressed, which directly maps to the ISO-25010 resource-utilisation quality attribute. A 200KB JavaScript bundle served uncompressed arrives as 200KB; with Brotli it arrives as approximately 45KB. At 4G speeds, that's roughly 250ms of avoidable download time per bundle. Marketing pages with multiple JS chunks and third-party scripts compound this: every uncompressed text resource adds to the total transfer time that feeds into FCP and LCP. Serving compress: false without an external compression layer is an explicit choice to send more bytes than necessary.
Severity rationale
Medium because disabling compression adds 60–80% to text asset payload, measurably increasing FCP and LCP, but Brotli is automatic on modern hosting platforms so the failure only occurs on custom server configurations.
Remediation
Verify compression is enabled and not explicitly disabled in your Next.js configuration — the default is compress: true.
// next.config.ts — ensure this is not present
// compress: false ← remove this if it exists
// Correct default
const nextConfig = {
compress: true, // gzip compression via Next.js server
}
On Vercel and Netlify, Brotli is applied automatically at the CDN layer — no configuration needed. For custom nginx servers:
# nginx.conf
brotli on;
brotli_types text/html text/css application/javascript application/json;
brotli_comp_level 6;
Verify compression is active by checking the Content-Encoding response header: curl -H 'Accept-Encoding: br' -I https://yoursite.com should return content-encoding: br.
DetectionPro
The detection method for this pattern is part of AuditBuffet Pro.
The full method (what to look for, pass and fail conditions, and how results get reported) ships inside the Page Speed Audit. The pattern definition, severity rationale, and remediation remain openly licensed under CC-BY-4.0.
External references
- iso-25010:2011 · performance-efficiency.resource-utilization — Brotli compression — reduces text-asset transfer size
Taxons
History
- 2026-04-18·v1.0.0·Initial import from marketing-page-speed·automated