Pull Request Reviews allow you to see the performance impact of development work before it gets released to your customers. Pull Request Reviews is a powerful GitHub integration that works with most popular deployment platforms.
To enable Pull Request Reviews, go to Site → Settings → Integrations tab and click Install next to the GitHub logo. You will be redirected to GitHub to enable the integration for your organisation.
Calibre requires access to commit statuses, deployments, checks and pull requests. We strongly recommend granting access to any selected repositories you’re interested in tracking.
After confirming the link between GitHub and Calibre, you will have to select a primary branch that will be the base for performance comparisons. This branch should be either deploying to production or a staging environment. In most cases, this might be master branch.
When the selected branch is successfully deployed, Calibre creates a deployment marker on your charts and takes a new snapshot of your site. That way, you always know how releases affect your performance metrics.
Calibre will compare each Pull Request to the median of your site metrics since the last deploy. Each report highlights critical measurements (Lighthouse Performance Score, Time to Interactive and First Contentful Paint) overall and across Test Profiles to highlight top-level changes.
You can also analyse each page to see browser previews for specific Test Profiles and most significant changes, including any Budgets that have changed.
Pull Request Reviews provide a helpful performance overview directly in GitHub, with the ability to drill down into metrics further in the Calibre interface.
By default, Calibre will compare the following metrics:
You can customise the metrics used by including a configuration YAML file in your linked repository at /.calibre/config.yml.
There are two top-level properties you can specify:
Under pullRequestReviews you can explicitly define which metrics to use, or you can provide a list of metrics to ignore from all available metrics in Calibre.
When you define metrics, the first three will be shown in the summary table.
The following configuration will only compare the metrics listed under measurements:
1version: 12pullRequestReviews:3 measurements:4 - lighthousePerformanceScore5 - lighthouseAccessibiltiyScore6 - lighthouseSEOScore
The following configuration will include all metrics except the ones listed under ignore:
1version: 12pullRequestReviews:3 ignore:4 - lighthousePwaScore5 - pageHTMLDownload6 - timeToFirstByte7 - lighthouseSeoScore8 - pageWaitTiming