Skip to main content

Web Performance

Performance supports both SEO rankings and web design quality: fast docs keep developers reading. Optimize static sites, SPAs, and agent UIs hosted on cloud platforms.

Core Web Vitals targets

MetricTargetFocus
LCP< 2.5sHero, fonts, largest image
INP< 200msJS handlers, hydration
CLS< 0.1Reserved space for media, ads

Optimization tactics

  • Lazy-load below-the-fold images and embeds
  • Split JavaScript bundles; defer non-critical scripts
  • Cache static assets at the CDN edge
  • Preconnect to font origins (see Docusaurus setup)
  • Compress images; prefer SVG for icons and logos

Performance in deployment automation

  • Run Lighthouse or CI performance budgets in CI/CD
  • Compare preview deploys before merging doc or open-source site changes