Presets

Built-in Presets

PS Guard includes built-in presets with optimized thresholds for common use cases. Use them with the --preset flag or the preset config option.

nextjs

Balanced thresholds for Next.js applications with SSR/SSG. Based on Google's recommended Web Vitals targets.

npx ps-guard --url https://my-nextjs-app.com --preset nextjs

landing-page

Stricter thresholds for landing pages where first impression and conversion matter. Optimized for fast paint and minimal layout shift.

npx ps-guard --url https://my-landing.com --preset landing-page

marketing-site

Standard thresholds for marketing sites with images, animations, and dynamic content. More lenient than landing pages.

Extending Presets

Presets can be combined with custom config. Your config values override the preset:

// ps-guard.config.ts
export default {
  preset: "nextjs",

  // Override just the LCP threshold
  thresholds: {
    lcp: 3000, // More lenient for image-heavy pages
  },

  // Override device
  device: "desktop",
};