Guides

Fixes that ship, not advice.

Every guide is written by engineers who ship. Code-first, opinionated, and short enough to read before standup.

Performance · 8 min

Cutting LCP under 1.5s without a CDN rewrite

A surgical approach to render-blocking JS, preloads, and image hints — the three levers that move LCP the most for the least architectural disruption.

Performance · 8 min
Performance

Cutting LCP under 1.5s without a CDN rewrite

Avg LCP delta
−1.2s
after fix
  • 1Preload the hero image with fetchpriority="high"
  • 2Defer non-critical JS with type="module" + async
  • 3Serve AVIF/WebP with width + height set
guide / performanceRead guide
SEO · 6 min

Structured data that actually moves the SERP

Which schema types matter, which are noise, and how to validate the markup so Google trusts it the first time.

SEO · 6 min
SEO

Structured data that actually moves the SERP

Rich result win rate
+34%
after fix
  • 1Pick one schema per template, not three
  • 2Validate with Rich Results Test on staging
  • 3Wire JSON-LD into the loader, not the client
guide / seoRead guide
Accessibility · 10 min

Shipping WCAG 2.2 AA without a UX rewrite

The eight checks that fix the long tail of A11y regressions — without dragging design into a four-week refactor.

Accessibility · 10 min
Accessibility

Shipping WCAG 2.2 AA without a UX rewrite

A11y issues closed
8 / 10
after fix
  • 1Audit focus order on every interactive surface
  • 2Set aria-current and aria-expanded correctly
  • 3Lift contrast on muted text to ≥ 4.5:1
guide / accessibilityRead guide
Security · 7 min

A CSP that doesn't break your analytics

Nonce-based CSP rollout plan with a one-week soft-launch — report-only first, enforced second, no 3am incidents.

Security · 7 min
Security

A CSP that doesn't break your analytics

XSS vectors closed
100%
after fix
  • 1Start in Content-Security-Policy-Report-Only
  • 2Add per-request nonces for inline scripts
  • 3Promote to enforced after a clean week
guide / securityRead guide
Mobile · 5 min

Killing CLS on mobile checkout flows

Common patterns and the layout primitives that prevent them — most CLS on checkout comes from three layout mistakes.

Mobile · 5 min
Mobile

Killing CLS on mobile checkout flows

CLS p75
0.04
after fix
  • 1Reserve space for banners with min-height
  • 2Set aspect-ratio on every responsive image
  • 3Avoid late-loading web fonts on the critical path
guide / mobileRead guide
Process · 12 min

Setting up audit gates in CI

Wire audits into PR comments without slowing the team down — fail loudly on regressions, stay quiet on the rest.

Process · 12 min
Process

Setting up audit gates in CI

Regressions caught
9 / wk
after fix
  • 1Run audits on every PR against a baseline
  • 2Block merge only on critical regressions
  • 3Post deltas as a sticky PR comment
guide / processRead guide