Use cases
Use cases
Sample setups that show how the pieces combine. Project names are examples.
Catch a regression before merge
Audit the app CI builds on every pull request and compare against main.
Sample items
- Project: my-app
- lighthouserc.js with upload.basicAuth
- CI step: npx @lhci/cli autorun
- GITHUB_TOKEN for the PR status check
Watch the deployed site
Audit production without building, in a Project of its own.
Sample items
- Project: my-app-live
- No-build workflow against the deployed URL
- Its own Build token
- No backend secrets needed in CI
Score a site with no CI
Let the server audit a Client site on a schedule with PageSpeed Insights.
Sample items
- Register the Project first
- Add the site to LHCI_PSI_SITES
- Set LHCI_PSI_API_KEY
- Redeploy to load the list
Audit pages behind a login
Sign Lighthouse’s browser in before it audits a dashboard.
Sample items
- loginWithCredentials in staging
- injectSessionCookies in production
- authenticateBasicAuth for App basic auth
- Secrets stay in CI, never in the repo
Keep your score history in one place you own
Deploy the server once, then onboard each repo in a few minutes.