Gzip or Brotli compression is enabled for text assets
Why it matters
Gzip compression reduces HTML, CSS, and JavaScript file sizes by 60–80%; Brotli achieves 15–25% better compression than Gzip. A 500KB JavaScript bundle uncompressed is typically 150KB gzipped — a 350KB savings on every cold load. Without compression enabled on a custom server, every user downloads the raw uncompressed file. Managed platforms (Vercel, Netlify, Cloudflare) enable Brotli automatically, but projects deploying to a custom Express server, Docker container, or bare nginx config must configure it explicitly. ISO 25010 performance-efficiency.resource-utilization identifies uncompressed text delivery as a direct and avoidable resource waste.
Severity rationale
Low because managed hosting platforms enable compression automatically, limiting this to custom infrastructure deployments — but on custom servers the oversight causes consistent 60-80% bandwidth waste.
Remediation
Enable compression at the server or proxy level. For Vercel or Netlify deployments, compression is automatic with no configuration. For custom Express or nginx servers, add compression middleware or directives explicitly.
// Express server — src/server.ts
import compression from 'compression'
import express from 'express'
const app = express()
app.use(compression()) // enables gzip by default; add shrink-ray for Brotli
# nginx.conf
gzip on;
gzip_types text/plain text/css application/javascript application/json;
gzip_comp_level 6;
gzip_min_length 256;
brotli on; # requires ngx_brotli module
brotli_types text/plain text/css application/javascript application/json;
Verify compression is active with: curl -H 'Accept-Encoding: gzip, br' -I https://yourdomain.com/bundle.js | grep Content-Encoding
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 Performance & Load Readiness 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 — Resource Utilization
Taxons
History
- 2026-04-18·v1.0.0·Initial import from performance-load·automated