# Unlighthouse

> Google Lighthouse for your entire site.

Canonical Origin: https://unlighthouse.dev/

**Agent Skills:**

Skills an agent can install from this site. The index at https://unlighthouse.dev/.well-known/agent-skills/index.json carries a sha256 digest for each one.

## LLM Resources

- [Full Content](https://unlighthouse.dev/llms-full.txt): Complete page content in markdown format.
- [sitemap.xml](https://unlighthouse.dev/sitemap.xml): XML sitemap for search engines and crawlers.
- [robots.txt](https://unlighthouse.dev/robots.txt): Crawler rules and permissions.

## Agent Skills

- [Agent Skills index](https://unlighthouse.dev/.well-known/agent-skills/index.json): Every published skill and its sha256 digest.
- [unlighthouse](https://unlighthouse.dev/SKILL.md): Run Google Lighthouse on every page of a site with the unlighthouse CLI, and fail CI on low scores with unlighthouse-ci. Use when a task mentions unlighthouse, unlighthouse-ci, site-wide Lighthouse scans, performance budgets in CI, unlighthouse.config.ts, defineUnlighthouseConfig, scanner.exclude, dynamic sampling, the authenticate hook, or a scan that never exits, skips pages, or refuses to clear its output folder.

## Pages

- [Unlighthouse: Site-Wide Google Lighthouse Audits · Unlighthouse](https://unlighthouse.dev/index.md): Unlighthouse finds your pages and runs Lighthouse audits across your site. Review the results in one dashboard. Free and open source.
- [Web Performance Glossary · Unlighthouse](https://unlighthouse.dev/glossary.md): Definitions and explanations of Core Web Vitals, Lighthouse metrics, and web performance terminology.
- [What is cumulative layout shift (CLS)?](https://unlighthouse.dev/glossary/cls.md): CLS measures visual stability. Learn what it is, thresholds, and how to prevent layout shifts.
- [What is first contentful paint (FCP)?](https://unlighthouse.dev/glossary/fcp.md): FCP measures when the first content renders. Learn what it is, thresholds, and how to improve it.
- [What is interaction to next paint (INP)?](https://unlighthouse.dev/glossary/inp.md): INP measures responsiveness. Learn what it is, thresholds, and how to improve interaction speed.
- [What is largest contentful paint (LCP)?](https://unlighthouse.dev/glossary/lcp.md): LCP measures loading performance. Learn what it is, thresholds, and how to improve your score.
- [Lighthouse Speed Index: What It Means, Good Scores & How to Fix](https://unlighthouse.dev/glossary/speed-index.md): Speed Index (SI) measures how fast visible content fills the viewport. Good: ≤3.4s mobile, ≤1.3s desktop. 10% of Lighthouse performance score. Thresholds, tools...
- [What is total blocking time (TBT)?](https://unlighthouse.dev/glossary/tbt.md): TBT measures main thread blocking during load. Learn what it is, thresholds, and how to reduce blocking time.
- [What is time to first byte (TTFB)?](https://unlighthouse.dev/glossary/ttfb.md): Learn what time to first byte measures, the 800ms field guideline, and how to find delays in connections, redirects, and server work.
- [What is time to interactive (TTI)?](https://unlighthouse.dev/glossary/tti.md): TTI measured page interactivity but was deprecated in Lighthouse 10. Learn what replaced it.
- [How Unlighthouse Works](https://unlighthouse.dev/guide/getting-started/how-it-works.md): Learn how Unlighthouse automatically discovers pages, runs Lighthouse audits in parallel, and generates site-wide performance reports.
- [Unlighthouse CLI - Site-Wide Lighthouse](https://unlighthouse.dev/guide/getting-started/installation.md): Install and run Unlighthouse CLI to scan your entire website with Lighthouse. npm, pnpm, and yarn installation options.
- [Integrations](https://unlighthouse.dev/guide/getting-started/integrations.md): Integrate Unlighthouse into your existing build tools, frameworks, and CI/CD pipelines for automated Lighthouse testing.
- [Authentication for Lighthouse Scans](https://unlighthouse.dev/guide/guides/authentication.md): Scan password-protected websites with Unlighthouse. Configure basic auth, cookies, headers, localStorage, and programmatic login flows.
- [Chrome Dependency](https://unlighthouse.dev/guide/guides/chrome-dependency.md): Configure Chrome browser settings for Unlighthouse scanning, including system Chrome usage and custom installations.
- [Common Errors](https://unlighthouse.dev/guide/guides/common-errors.md): Troubleshoot common issues encountered when running Unlighthouse scans, including browser connection and environment problems.
- [Configuration](https://unlighthouse.dev/guide/guides/config.md): Configure Unlighthouse for your specific needs using configuration files and inline options.
- [Debugging Lighthouse Scans](https://unlighthouse.dev/guide/guides/debugging.md): Debug and troubleshoot Unlighthouse scans using logging, browser inspection, and diagnostic tools.
- [Unlighthouse --desktop Flag & Device Configuration](https://unlighthouse.dev/guide/guides/device.md): Run Unlighthouse in desktop mode with the --desktop flag: npx unlighthouse --site <url> --desktop. Configure mobile, desktop, or custom viewports with throttlin...
- [Run Lighthouse in Docker](https://unlighthouse.dev/guide/guides/docker.md): Run Unlighthouse site-wide Lighthouse scans in Docker containers. Dockerfile examples and CI/CD configuration.
- [Dynamic Sampling](https://unlighthouse.dev/guide/guides/dynamic-sampling.md): Automatically sample similar pages to reduce scan time for sites with many similar URLs like blogs or e-commerce.
- [Generate Lighthouse Reports](https://unlighthouse.dev/guide/guides/generating-static-reports.md): Generate static Lighthouse reports for your entire site. Export as HTML, CSV, or JSON. Deploy to Netlify, CloudFlare, or any static host.
- [Lighthouse Configuration](https://unlighthouse.dev/guide/guides/lighthouse.md): Customize Google Lighthouse audit settings, categories, and performance thresholds within Unlighthouse scans.
- [Puppeteer Launch Options](https://unlighthouse.dev/guide/guides/puppeteer.md): Configure Puppeteer launch options in Unlighthouse: headless mode, Chrome args, viewport settings, executable path, and navigation hooks.
- [Route Definitions](https://unlighthouse.dev/guide/guides/route-definitions.md): Configure route discovery and custom sampling patterns for better page organization and intelligent scanning.
- [URL Discovery](https://unlighthouse.dev/guide/guides/url-discovery.md): How Unlighthouse discovers pages using sitemaps, robots.txt, and internal link crawling. Configure URL sources and filters.
- [Customizing the UI](https://unlighthouse.dev/guide/recipes/client.md): Modify Unlighthouse client interface columns and display to show custom metrics and data.
- [Improving Lighthouse Accuracy](https://unlighthouse.dev/guide/recipes/improving-accuracy.md): Optimize Lighthouse scan accuracy with multiple samples and reduced concurrency for more reliable, consistent Core Web Vitals results.
- [Bulk Lighthouse Testing for Large Sites](https://unlighthouse.dev/guide/recipes/large-sites.md): Scan large websites with thousands of pages efficiently. Configure sampling, URL filtering, and optimization strategies for bulk Lighthouse testing.
- [Single-Page Applications](https://unlighthouse.dev/guide/recipes/spa.md): Configure Unlighthouse to scan single-page applications (SPAs) with client-side routing like React, Vue, and Angular apps.
- [Integration Deprecations](https://unlighthouse.dev/integration-deprecations.md): Build tool integrations are deprecated in v1.0. Learn about migration paths and alternatives.
- [unlighthouse-ci: Bulk Lighthouse CI for Entire Sites](https://unlighthouse.dev/integrations/ci.md): Run unlighthouse-ci on every deploy. Auto-discovers every URL, runs Lighthouse on all of them in parallel, enforces a single budget. Works in GitHub Actions, Gi...
- [Lighthouse CLI for Entire Sites](https://unlighthouse.dev/integrations/cli.md): Scan your entire website with Lighthouse from the command line. Alternative to lighthouse CLI that audits all pages automatically.
- [Nuxt Integration](https://unlighthouse.dev/integrations/nuxt.md): Integrate Lighthouse audits directly into your Nuxt development workflow with automatic route discovery.
- [Vite Integration](https://unlighthouse.dev/integrations/vite.md): Integrate Lighthouse audits into your Vite development server with automatic route discovery and HMR support.
- [Webpack Integration](https://unlighthouse.dev/integrations/webpack.md): Add Lighthouse auditing to webpack-based projects with development server integration and HMR support.
- [Learn Lighthouse & Web Vitals: Performance Guides · Unlighthouse](https://unlighthouse.dev/learn-lighthouse.md): Free guides to improve Lighthouse scores and Core Web Vitals. Fix LCP, CLS, INP, accessibility, and SEO audits with actionable tutorials and tools.
- [Lighthouse Accessibility Audit Guide](https://unlighthouse.dev/learn-lighthouse/accessibility.md): Master web accessibility with Lighthouse. Learn how accessibility audits work, why they matter for users and SEO, and how to fix common issues.
- [Fix Focusable Elements Inside aria-hidden](https://unlighthouse.dev/learn-lighthouse/accessibility/aria-hidden-focus.md): Learn how to fix aria-hidden-focus issues in Lighthouse accessibility audits
- [Fix Missing Required ARIA Attributes](https://unlighthouse.dev/learn-lighthouse/accessibility/aria-required-attr.md): Learn how to fix aria-required-attr issues in Lighthouse accessibility audits
- [Fix Invalid or Misspelled ARIA Attributes](https://unlighthouse.dev/learn-lighthouse/accessibility/aria-valid-attr.md): Learn how to fix aria-valid-attr issues in Lighthouse accessibility audits
- [Fix Buttons Without Accessible Names](https://unlighthouse.dev/learn-lighthouse/accessibility/button-name.md): Learn how to fix buttons without accessible names in Lighthouse accessibility audits.
- [Fix missing bypass blocks for keyboard navigation](https://unlighthouse.dev/learn-lighthouse/accessibility/bypass.md): Fix bypass issues in Lighthouse accessibility audits
- [Fix Color Contrast for Better Accessibility](https://unlighthouse.dev/learn-lighthouse/accessibility/color-contrast.md): Learn how to fix color contrast issues in Lighthouse accessibility audits
- [Fix Missing Document Title](https://unlighthouse.dev/learn-lighthouse/accessibility/document-title.md): Learn how to fix missing document title in Lighthouse accessibility audits. The title gives screen reader users an overview of the page.
- [Fix Frame Title for Better Accessibility](https://unlighthouse.dev/learn-lighthouse/accessibility/frame-title.md): Learn how to fix frame and iframe title issues in Lighthouse accessibility audits
- [Fix heading order for better accessibility](https://unlighthouse.dev/learn-lighthouse/accessibility/heading-order.md): Fix heading order issues in Lighthouse accessibility audits. Ordered headings convey semantic structure for easier navigation.
- [Fix Missing HTML Lang Attribute for Better Accessibility](https://unlighthouse.dev/learn-lighthouse/accessibility/html-has-lang.md): Learn how to fix missing lang attribute in Lighthouse accessibility audits. The lang attribute helps screen readers pronounce content correctly.
- [Fix Missing Image Alt Text for Better Accessibility](https://unlighthouse.dev/learn-lighthouse/accessibility/image-alt.md): Learn how to fix missing image alt attributes in Lighthouse accessibility audits
- [Fix Form Labels for Better Accessibility](https://unlighthouse.dev/learn-lighthouse/accessibility/label.md): Learn how to fix missing form labels in Lighthouse accessibility audits. Labels ensure form controls are announced properly by assistive technologies.
- [Fix links without discernible names for better accessibility](https://unlighthouse.dev/learn-lighthouse/accessibility/link-name.md): Fix links without discernible names in Lighthouse accessibility audits
- [Fix zooming and scaling disabled](https://unlighthouse.dev/learn-lighthouse/accessibility/meta-viewport.md): Fix 'zooming and scaling must not be disabled' Lighthouse audit. Remove user-scalable=no and maximum-scale=1 from your viewport meta tag.
- [Fix tabindex values greater than zero for better accessibility](https://unlighthouse.dev/learn-lighthouse/accessibility/tabindex.md): Fix tabindex values greater than zero in Lighthouse accessibility audits
- [Fix touch target size for better accessibility](https://unlighthouse.dev/learn-lighthouse/accessibility/target-size.md): Fix touch target size issues in Lighthouse accessibility audits
- [Lighthouse Best Practices Guide](https://unlighthouse.dev/learn-lighthouse/best-practices.md): Understand Lighthouse Best Practices audits, fix common security and browser issues, and verify failures across every page template.
- [Fix back/forward cache issues](https://unlighthouse.dev/learn-lighthouse/best-practices/bf-cache.md): Make back button navigation instant with bfcache. Learn common blockers and how to fix them.
- [Fix charset declaration](https://unlighthouse.dev/learn-lighthouse/best-practices/charset.md): Properly declare character encoding to prevent text rendering issues and security vulnerabilities.
- [Fix deprecated browser APIs](https://unlighthouse.dev/learn-lighthouse/best-practices/deprecations.md): Replace deprecated browser APIs before they are removed. Covers document.domain, Event.path, keyCode, and sync XHR.
- [Fix Missing HTML Doctype for Better Best Practices Score](https://unlighthouse.dev/learn-lighthouse/best-practices/doctype.md): Learn why your page needs a proper HTML doctype and how quirks mode breaks your layout and CSS.
- [Fix Console Errors for Better Best Practices Score](https://unlighthouse.dev/learn-lighthouse/best-practices/errors-in-console.md): Identify and resolve browser console errors. Clean up JavaScript exceptions, failed network requests, and deprecation warnings affecting your site.
- [Fix Geolocation Request on Page Load](https://unlighthouse.dev/learn-lighthouse/best-practices/geolocation-on-start.md): Stop requesting geolocation permission on page load. Users distrust sites that ask for location without context - tie requests to user actions instead.
- [Fix Incorrect Image Aspect Ratio for Better Best Practices Score](https://unlighthouse.dev/learn-lighthouse/best-practices/image-aspect-ratio.md): Display images with their natural aspect ratio to prevent distortion. Stretched or squished images look unprofessional.
- [Fix Low Resolution Images for Better Best Practices Score](https://unlighthouse.dev/learn-lighthouse/best-practices/image-size-responsive.md): Serve images with appropriate resolution for the display size and device pixel ratio. Blurry images hurt perceived quality.
- [Fix Chrome DevTools Issues for Better Best Practices Score](https://unlighthouse.dev/learn-lighthouse/best-practices/inspector-issues.md): Resolve browser-detected problems including mixed content, cookie issues, CSP violations, and cross-origin blocks that appear in Chrome's Issues panel.
- [Fix HTTPS Issues for Better Best Practices Score](https://unlighthouse.dev/learn-lighthouse/best-practices/is-on-https.md): Eliminate insecure HTTP requests and mixed content warnings. Learn to enforce HTTPS across your entire site for security and modern web features.
- [Fix Notification Request on Page Load](https://unlighthouse.dev/learn-lighthouse/best-practices/notification-on-start.md): Stop requesting notification permission on page load. Users dismiss these prompts reflexively - wait for a user action that shows they want notifications.
- [Fix Inputs That Block Pasting](https://unlighthouse.dev/learn-lighthouse/best-practices/paste-preventing-inputs.md): Stop preventing users from pasting into input fields. Blocking paste breaks password managers and frustrates users without improving security.
- [Fix HTTP to HTTPS Redirect for Better Best Practices Score](https://unlighthouse.dev/learn-lighthouse/best-practices/redirects-http.md): Configure your server to redirect all HTTP traffic to HTTPS. Protect users and enable secure web features across your entire site.
- [Bulk lighthouse testing & --maxRoutes config](https://unlighthouse.dev/learn-lighthouse/bulk-lighthouse-testing.md): Run Lighthouse on your entire site with Unlighthouse. Limit pages with --maxRoutes, filter by URL pattern, and automate bulk audits.
- [Cumulative Layout Shift (CLS): What Is a Good Score & How to Fix](https://unlighthouse.dev/learn-lighthouse/cls.md): Google considers a CLS score of 0.1 or less as good. Learn what causes layout shifts and how to fix CLS with proven techniques for images, fonts, ads, and dynam...
- [Fix Ads, Embeds & iframes for Better CLS](https://unlighthouse.dev/learn-lighthouse/cls/ads-embeds-iframes.md): Prevent layout shifts from third-party ads, video embeds, social widgets, and iframes with reserved space techniques.
- [Fix Animations & Transitions for Better CLS](https://unlighthouse.dev/learn-lighthouse/cls/animations-transitions.md): Eliminate CLS from animations by using compositor-friendly properties like transform and opacity instead of layout-triggering properties.
- [Fix Dynamic Content Injection for Better CLS](https://unlighthouse.dev/learn-lighthouse/cls/dynamic-content-injection.md): Stop cookie banners, notifications, and lazy-loaded content from causing layout shifts with space reservation and transforms.
- [Fix Layout Shifts: CSS Reflow, Font-Size & CLS Causes](https://unlighthouse.dev/learn-lighthouse/cls/layout-shifts.md): Diagnose and fix layout shifts caused by CSS reflow, font-size changes, unsized media, web fonts, and injected iframes. Reduce your CLS score.
- [Fix Images Without Dimensions for Better CLS](https://unlighthouse.dev/learn-lighthouse/cls/unsized-images.md): Images without width and height cause layout shifts. Add explicit dimensions to prevent your page from jumping around as images load.
- [Fix Web Fonts Causing Layout Shifts (FOIT/FOUT)](https://unlighthouse.dev/learn-lighthouse/cls/web-fonts-causing-foit.md): How to prevent layout shifts from web font loading using font-display, preloading, and fallback metrics.
- [Core web vitals guide](https://unlighthouse.dev/learn-lighthouse/core-web-vitals.md): Learn the LCP, INP and CLS thresholds, read a real Core Web Vitals report, and choose what to investigate next.
- [Interaction to Next Paint (INP) Guide](https://unlighthouse.dev/learn-lighthouse/inp.md): Master INP optimization with practical fixes for JavaScript execution, DOM operations, and event handlers. Improve responsiveness across your site.
- [Fix Excessive DOM Size for Better INP](https://unlighthouse.dev/learn-lighthouse/inp/dom-size.md): Large DOMs slow every interaction. Reduce DOM size with virtualization, lazy rendering, and smarter component architecture.
- [Fix Event Handler Delays for Better INP](https://unlighthouse.dev/learn-lighthouse/inp/event-handler-delays.md): Slow event handlers directly hurt INP. Optimize click, input, and keypress handlers for instant feedback.
- [Fix Heavy Main Thread Work for Better INP](https://unlighthouse.dev/learn-lighthouse/inp/heavy-dom-operations.md): Reduce main thread work from DOM manipulation, style recalculation, and layout thrashing. Keep interactions responsive.
- [Fix Hydration Issues for Better INP](https://unlighthouse.dev/learn-lighthouse/inp/hydration-issues.md): Framework hydration blocks interactivity. Delay and partial hydration strategies to make SSR sites responsive faster.
- [Fix Long-Running JavaScript for Better INP](https://unlighthouse.dev/learn-lighthouse/inp/long-running-javascript.md): Reduce JavaScript execution time to improve INP. Learn code splitting, web workers, and task chunking to keep the main thread responsive.
- [Fix Third-Party Script Impact on INP](https://unlighthouse.dev/learn-lighthouse/inp/third-party-scripts.md): Third-party scripts compete for main thread time. Learn to defer, facade, and limit their impact on interaction responsiveness.
- [Fix Total Blocking Time for Better INP](https://unlighthouse.dev/learn-lighthouse/inp/total-blocking-time.md): Reduce TBT to improve your Lighthouse performance score. TBT measures main thread blocking - the lab proxy for real-world INP.
- [Largest Contentful Paint (LCP): find the element and fix delays](https://unlighthouse.dev/learn-lighthouse/lcp.md): Find your LCP element, read a real Lighthouse timing breakdown, and choose the next check for slow loading.
- [LCP Optimization Best Practices 2026: The Complete Guide](https://unlighthouse.dev/learn-lighthouse/lcp/best-practices-2026.md): A practical 2026 LCP playbook using Lighthouse 13 Insights, Priority Hints, early resource discovery, modern images, and field data.
- [Fix Client-Side Rendering for Better LCP](https://unlighthouse.dev/learn-lighthouse/lcp/client-side-rendering.md): How to improve LCP by using server-side rendering or pre-rendering instead of client-side rendering.
- [Fix Large Images for Better LCP](https://unlighthouse.dev/learn-lighthouse/lcp/large-images.md): Optimize LCP images with responsive srcset, modern formats like WebP and AVIF, and proper compression. Reduce image size without losing quality.
- [Fix Lazy-Loading Above the Fold for Better LCP](https://unlighthouse.dev/learn-lighthouse/lcp/lazy-loading-above-fold.md): Why you should never lazy-load your LCP image and how to fix it.
- [Don't Lazy-Load Your LCP Image](https://unlighthouse.dev/learn-lighthouse/lcp/lcp-lazy-loaded.md): Remove loading='lazy' from hero images. Lazy-loading your LCP image adds 500ms+ delay. Fix with eager loading and fetchpriority='high'.
- [Preload & Prioritize Your LCP Image](https://unlighthouse.dev/learn-lighthouse/lcp/prioritize-lcp-image.md): Add fetchpriority='high' and preload your LCP image. 85% of sites miss this — one attribute can cut LCP by 100-400ms.
- [Fix Page Redirects for Better LCP](https://unlighthouse.dev/learn-lighthouse/lcp/redirects.md): Eliminate redirect chains that delay LCP. Learn to identify and fix 301/302 redirects, canonical URL issues, and trailing slash mismatches.
- [Eliminate Render-Blocking Resources: Lighthouse Audit Fix](https://unlighthouse.dev/learn-lighthouse/lcp/render-blocking-resources.md): How to eliminate render-blocking CSS and JavaScript in the Lighthouse audit. Async/defer scripts, critical CSS extraction, font loading, and Next.js optimizeCss...
- [Fix Resource Load Delay for Better LCP](https://unlighthouse.dev/learn-lighthouse/lcp/resource-load-delay.md): How to reduce resource load delay by preloading LCP resources and prioritizing critical assets.
- [Fix Slow Server Response (TTFB) for Better LCP](https://unlighthouse.dev/learn-lighthouse/lcp/slow-server-response.md): Reduce server response time to improve LCP. Learn CDN setup, caching strategies, database optimization, and edge computing solutions.
- [Fix Enormous Network Payloads for Better LCP](https://unlighthouse.dev/learn-lighthouse/lcp/total-byte-weight.md): How to reduce total page weight and avoid enormous network payloads that slow down your Largest Contentful Paint.
- [Fix Unminified JavaScript for Better LCP](https://unlighthouse.dev/learn-lighthouse/lcp/unminified-javascript.md): How to minify JavaScript files to reduce payload sizes, improve parse time, and accelerate your Largest Contentful Paint.
- [Fix Unused JavaScript for Better LCP](https://unlighthouse.dev/learn-lighthouse/lcp/unused-javascript.md): How to reduce unused JavaScript through code splitting, tree shaking, and dynamic imports to improve your Largest Contentful Paint.
- [LHCI vs Unlighthouse: Which Lighthouse CI Tool Should You Use?](https://unlighthouse.dev/learn-lighthouse/lhci-vs-unlighthouse.md): Honest side-by-side comparison of @lhci/cli and Unlighthouse. Setup, URL discovery, budgets, reporting, and when each tool fits your workflow.
- [Lighthouse CI (LHCI): Complete Guide to @lhci/cli in 2026](https://unlighthouse.dev/learn-lighthouse/lighthouse-ci.md): Complete guide to Lighthouse CI (@lhci/cli) from Google. Automate Lighthouse audits in CI/CD, enforce performance budgets, prevent regressions. Install, configu...
- [Performance Budgets with Lighthouse CI: Assertions & budget.json](https://unlighthouse.dev/learn-lighthouse/lighthouse-ci/budgets.md): Set and enforce performance budgets with Lighthouse CI. Configure assertions, presets, custom thresholds, and budget.json to prevent regressions in CI/CD.
- [Lighthouse CI Configuration Reference](https://unlighthouse.dev/learn-lighthouse/lighthouse-ci/configuration.md): Complete guide to lighthouserc.js configuration options. Covers collect, assert, upload, and server settings for @lhci/cli.
- [Lighthouse CI GitHub Actions: Setup Guide & Documentation](https://unlighthouse.dev/learn-lighthouse/lighthouse-ci/github-actions.md): Complete Lighthouse CI GitHub Actions documentation. Step-by-step YAML workflows, status checks, PR comments, and treosh/lighthouse-ci-action setup.
- [Lighthouse CI with GitLab CI/CD: Setup Guide](https://unlighthouse.dev/learn-lighthouse/lighthouse-ci/gitlab-ci.md): Configure Lighthouse CI for GitLab pipelines. Includes .gitlab-ci.yml examples, merge request integration, and artifact storage.
- [LHCI Server: Self-Host Lighthouse CI Dashboard](https://unlighthouse.dev/learn-lighthouse/lighthouse-ci/server.md): Deploy your own Lighthouse CI server for historical tracking, build comparisons, and team dashboards. Covers Docker, Heroku, and database setup.
- [Lighthouse CI Troubleshooting Guide](https://unlighthouse.dev/learn-lighthouse/lighthouse-ci/troubleshooting.md): Fix common Lighthouse CI issues: Chrome launch failures, score variance, shallow clone errors, upload problems, and more.
- [PageSpeed Insights API Guide](https://unlighthouse.dev/learn-lighthouse/pagespeed-insights-api.md): Complete guide to using the PageSpeed Insights API. Get Lighthouse performance data programmatically with 25,000 free requests per day.
- [Bulk Testing with PageSpeed Insights API](https://unlighthouse.dev/learn-lighthouse/pagespeed-insights-api/bulk-testing.md): Test multiple URLs with the PageSpeed Insights API. Queue implementation, rate limit handling, and practical limits of bulk PSI testing.
- [Get a PageSpeed Insights API Key](https://unlighthouse.dev/learn-lighthouse/pagespeed-insights-api/get-api-key.md): Step-by-step guide to getting a free PageSpeed Insights API key from Google Cloud Console. Setup takes 2 minutes.
- [PageSpeed Insights API Node.js Example (googleapis.com/pagespeedonline)](https://unlighthouse.dev/learn-lighthouse/pagespeed-insights-api/node-example.md): Fetch Lighthouse data with Node.js using the googleapis.com/pagespeedonline/v5/runPagespeed endpoint. Working TypeScript code examples.
- [PageSpeed Insights API Python Example (googleapis.com/pagespeedonline)](https://unlighthouse.dev/learn-lighthouse/pagespeed-insights-api/python-example.md): Fetch Lighthouse data with Python using the googleapis.com/pagespeedonline/v5/runPagespeed endpoint. Working code examples with type hints.
- [PageSpeed Insights API Rate Limits](https://unlighthouse.dev/learn-lighthouse/pagespeed-insights-api/rate-limits.md): Handle PSI API quotas without breaking your integration. Rate limit detection, retry strategies, and quota monitoring.
- [PageSpeed Insights vs Lighthouse: What's the difference?](https://unlighthouse.dev/learn-lighthouse/pagespeed-insights-vs-lighthouse.md): Read real PageSpeed Insights and Lighthouse reports to separate lab scores from field data, compare test settings, and choose your next performance check.
- [Lighthouse with Playwright: Performance Testing Guide](https://unlighthouse.dev/learn-lighthouse/playwright.md): Run Google Lighthouse audits with Playwright for automated performance, accessibility, and SEO testing. Complete setup guide with code examples.
- [Lighthouse on Authenticated Pages with Playwright](https://unlighthouse.dev/learn-lighthouse/playwright/authentication.md): Run Lighthouse audits on pages behind login. Learn how to preserve authentication state when Lighthouse opens a new browser context.
- [Playwright Lighthouse in GitHub Actions](https://unlighthouse.dev/learn-lighthouse/playwright/ci-cd.md): Automate Lighthouse audits with Playwright in GitHub Actions. Run performance tests on every PR with thresholds and artifact reports.
- [Troubleshooting Playwright Lighthouse Integration](https://unlighthouse.dev/learn-lighthouse/playwright/troubleshooting.md): Fix common issues when running Lighthouse with Playwright: port conflicts, authentication problems, flaky scores, and Chrome version mismatches.
- [Lighthouse SEO Audit: All 8 Checks Explained & How to Fix](https://unlighthouse.dev/learn-lighthouse/seo.md): Pass every Lighthouse SEO audit. Crawlability, canonical, meta description, robots.txt, hreflang, status codes — each check explained with fixes and examples.
- [Fix Invalid Canonical URL for Better SEO](https://unlighthouse.dev/learn-lighthouse/seo/canonical.md): Resolve canonical tag errors that cause duplicate content issues and diluted page authority. Learn to implement rel=canonical correctly.
- [Fix Uncrawlable Links for Better SEO](https://unlighthouse.dev/learn-lighthouse/seo/crawlable-anchors.md): Learn how to fix anchor elements that search engines can't follow due to missing or invalid href attributes.
- [Fix Invalid hreflang Tags for Better International SEO](https://unlighthouse.dev/learn-lighthouse/seo/hreflang.md): Learn how to fix hreflang validation errors including unexpected language codes and relative URLs in your multi-language site.
- [Fix Unsuccessful HTTP Status Code for Better SEO](https://unlighthouse.dev/learn-lighthouse/seo/http-status-code.md): Fix pages returning 4xx or 5xx HTTP status codes that prevent proper indexing. Learn status code meanings, common causes, and how to resolve server errors.
- [Fix Page Blocked from Indexing for Better SEO](https://unlighthouse.dev/learn-lighthouse/seo/is-crawlable.md): Remove crawl blocks preventing search engines from indexing your pages. Fix robots.txt, meta robots, and X-Robots-Tag issues.
- [Fix Non-Descriptive Link Text for Better SEO](https://unlighthouse.dev/learn-lighthouse/seo/link-text.md): Learn how to replace generic link text like "click here" with descriptive text that helps search engines understand your content.
- [Fix Missing Meta Description for Better SEO](https://unlighthouse.dev/learn-lighthouse/seo/meta-description.md): Add compelling meta descriptions to improve click-through rates from search results. Learn how to write effective descriptions that drive traffic.
- [Fix Invalid robots.txt for Better SEO](https://unlighthouse.dev/learn-lighthouse/seo/robots-txt.md): Fix robots.txt validation errors that prevent search engines from properly crawling your site. Learn syntax rules, common errors, and proper configuration.
- [Unlighthouse Release Notes and Changelog · Unlighthouse](https://unlighthouse.dev/releases.md): Read the latest Unlighthouse release notes, improvements, fixes, and version history.
- [Free Lighthouse & Core Web Vitals Tools · Unlighthouse](https://unlighthouse.dev/tools.md): Free bulk Core Web Vitals checker, Lighthouse score calculator, CLS debugger, LCP finder, and more. Test multiple pages at once with no signup.
- [Bulk PageSpeed Test - Lighthouse Performance Scores · Unlighthouse](https://unlighthouse.dev/tools/bulk-pagespeed.md): Check Lighthouse Performance scores and lab metrics for up to 10 URLs. Compare page results and export measurements.
- [CLS Debugger - Free Layout Shift Testing Tool · Unlighthouse](https://unlighthouse.dev/tools/cls-debugger.md): Free CLS testing tool. Enter a URL to find which elements cause Cumulative Layout Shift and get actionable fixes. No signup required.
- [Core Web Vitals Test - Free CWV Checker · Unlighthouse](https://unlighthouse.dev/tools/cwv-checker.md): Check available field Core Web Vitals and inspect Lighthouse lab results. View measurement sources and recommendations.
- [Bulk Core Web Vitals Test - Compare CWV Across Sites · Unlighthouse](https://unlighthouse.dev/tools/cwv-compare.md): Bulk test and compare Core Web Vitals across multiple websites. See how your LCP, CLS, and INP stack up against competitors with real Chrome user data.
- [Core Web Vitals History - Track Performance Over Time · Unlighthouse](https://unlighthouse.dev/tools/cwv-history.md): Free CrUX history viewer. Track 25 weeks of LCP, CLS, and INP trends from real Chrome users. Monitor Core Web Vitals changes over time.
- [HAR File Viewer - Analyze HTTP Archive Files Online Free · Unlighthouse](https://unlighthouse.dev/tools/har-viewer.md): Free HAR file viewer and network analyzer. Upload HAR files to visualize waterfall charts, request timing, resource breakdown, and protocol analysis. Entirely c...
- [INP Analyzer - Test Interaction to Next Paint · Unlighthouse](https://unlighthouse.dev/tools/inp-analyzer.md): Free INP testing tool. Analyze your Interaction to Next Paint score, find long tasks blocking the main thread, and improve responsiveness.
- [JSON Size Calculator - Measure & Analyze JSON Size Online Free · Unlighthouse](https://unlighthouse.dev/tools/json-size.md): Free JSON size calculator. Measure raw, minified, gzip, and brotli sizes. Analyze key contributions, depth, and duplicate key overhead. Paste JSON, get instant ...
- [LCP Element Finder - Identify Your Largest Contentful Paint · Unlighthouse](https://unlighthouse.dev/tools/lcp-finder.md): Free LCP test tool. Find your Largest Contentful Paint element, see timing breakdowns, and get actionable recommendations to improve loading speed.
- [Lighthouse Report Viewer - Analyze JSON Reports Online Free · Unlighthouse](https://unlighthouse.dev/tools/lighthouse-report-viewer.md): Free Lighthouse JSON viewer and report analyzer. Upload or paste Lighthouse JSON to view scores, Performance metrics, and audit details. Works with PageSpeed In...
- [Lighthouse Performance Score Calculator - Calculate Performance Scores · Unlighthouse](https://unlighthouse.dev/tools/lighthouse-score-calculator.md): Free interactive Lighthouse scoring calculator. See how FCP, LCP, TBT, CLS, and Speed Index weights and thresholds determine your Lighthouse performance score. ...
- [Page Size Checker - Test Page Weight & Resource Breakdown Free · Unlighthouse](https://unlighthouse.dev/tools/page-size.md): Free page size checker. Analyze total page weight, resource breakdown by type, third-party script weight, unused code, and compression efficiency. Compare again...
- [PageSpeed Insights - Full Performance Report · Unlighthouse](https://unlighthouse.dev/tools/pagespeed-insights-performance.md): Comprehensive PageSpeed Insights performance report with Core Web Vitals, resource analysis, third-party breakdown, and actionable recommendations.
- [TTFB Checker - Test Time to First Byte · Unlighthouse](https://unlighthouse.dev/tools/ttfb-checker.md): Free TTFB test tool. Check your server response time with real Chrome user data (CrUX). Compare field vs lab TTFB and track trends over time.
- [API Reference](https://unlighthouse.dev/v1/api-doc.md): API Reference for the Unlighthouse v1 beta.
- [Configuration Reference](https://unlighthouse.dev/v1/api-doc/config.md): Configuration Reference for the Unlighthouse v1 beta.
- [API Glossary](https://unlighthouse.dev/v1/api-doc/glossary.md): API Glossary for the Unlighthouse v1 beta.
- [Unlighthouse v1 Architecture](https://unlighthouse.dev/v1/architecture.md): How Unlighthouse v1 is structured: runtime-neutral scan modules, explicit host adapters, and separate Node and Cloudflare orchestration.
- [How Unlighthouse Works](https://unlighthouse.dev/v1/guide/getting-started/how-it-works.md): How Unlighthouse Works for the Unlighthouse v1 beta.
- [Install Unlighthouse](https://unlighthouse.dev/v1/guide/getting-started/installation.md): Install Unlighthouse for the Unlighthouse v1 beta.
- [Integrations](https://unlighthouse.dev/v1/guide/getting-started/integrations.md): Integrate Unlighthouse into local development and CI/CD pipelines with the CLI and CI runner.
- [Authentication](https://unlighthouse.dev/v1/guide/guides/authentication.md): Authentication for the Unlighthouse v1 beta.
- [Chrome Dependency](https://unlighthouse.dev/v1/guide/guides/chrome-dependency.md): Chrome Dependency for the Unlighthouse v1 beta.
- [Common Errors](https://unlighthouse.dev/v1/guide/guides/common-errors.md): Troubleshoot common issues encountered when running Unlighthouse scans, including browser connection and environment problems.
- [Configuration](https://unlighthouse.dev/v1/guide/guides/config.md): Configuration for the Unlighthouse v1 beta.
- [Debugging Lighthouse Scans](https://unlighthouse.dev/v1/guide/guides/debugging.md): Debugging Lighthouse Scans for the Unlighthouse v1 beta.
- [Unlighthouse --desktop Flag & Device Configuration](https://unlighthouse.dev/v1/guide/guides/device.md): Run Unlighthouse in desktop mode with the --desktop flag: pnpm exec unlighthouse --site <url> --desktop. Configure mobile, desktop, or custom viewports with thr...
- [Docker](https://unlighthouse.dev/v1/guide/guides/docker.md): Docker for the Unlighthouse v1 beta.
- [Dynamic Sampling](https://unlighthouse.dev/v1/guide/guides/dynamic-sampling.md): Dynamic Sampling for the Unlighthouse v1 beta.
- [Generating Static Reports](https://unlighthouse.dev/v1/guide/guides/generating-static-reports.md): Generating Static Reports for the Unlighthouse v1 beta.
- [Lighthouse Configuration](https://unlighthouse.dev/v1/guide/guides/lighthouse.md): Customize Google Lighthouse audit settings, categories, and performance thresholds within Unlighthouse scans.
- [Migrating to v1](https://unlighthouse.dev/v1/guide/guides/migrating-to-v1.md): Move CLI scripts and programmatic integrations from Unlighthouse 0.19 to the v1 beta.
- [Chrome Options](https://unlighthouse.dev/v1/guide/guides/puppeteer.md): Chrome Options for the Unlighthouse v1 beta.
- [Route Definitions](https://unlighthouse.dev/v1/guide/guides/route-definitions.md): Route Definitions for the Unlighthouse v1 beta.
- [URL Discovery](https://unlighthouse.dev/v1/guide/guides/url-discovery.md): URL Discovery for the Unlighthouse v1 beta.
- [Dashboard and Export Customization](https://unlighthouse.dev/v1/guide/recipes/client.md): Dashboard and Export Customization for the Unlighthouse v1 beta.
- [Improving Lighthouse Accuracy](https://unlighthouse.dev/v1/guide/recipes/improving-accuracy.md): Improving Lighthouse Accuracy for the Unlighthouse v1 beta.
- [Scanning Large Sites](https://unlighthouse.dev/v1/guide/recipes/large-sites.md): Scanning Large Sites for the Unlighthouse v1 beta.
- [Scanning Single Page Applications](https://unlighthouse.dev/v1/guide/recipes/spa.md): Scanning Single Page Applications for the Unlighthouse v1 beta.
- [Removed Build Tool Integrations](https://unlighthouse.dev/v1/integration-deprecations.md): Build tool integrations were removed in v1. Learn how to migrate to the CLI or CI runner.
- [CI Integration](https://unlighthouse.dev/v1/integrations/ci.md): CI Integration for the Unlighthouse v1 beta.
- [CLI Integration](https://unlighthouse.dev/v1/integrations/cli.md): CLI Integration for the Unlighthouse v1 beta.
- [MCP Server for AI Agents](https://unlighthouse.dev/v1/integrations/mcp.md): Connect Unlighthouse to Claude Code, Cursor, or any MCP-compatible AI agent. Layered output: sub-1KB scan summaries, opinionated pack reports, drill-down on dem...
- [Self-hosting Unlighthouse](https://unlighthouse.dev/v1/integrations/self-hosted.md): Run Unlighthouse as a long-lived hosted service: external storage, token auth, CORS, proxies, rate limiting, graceful shutdown.
- [Self-Host Unlighthouse on Cloudflare](https://unlighthouse.dev/v1/self-host-cloudflare.md): Deploy Unlighthouse with a secured Worker, Workflows, D1, R2, a Lighthouse Container, and Browser Rendering.