shopify/lighthouse-ci-action

---

Forked to add a new variable that sets the specific web URL to visit using lighthouse, different from the variable used to fetch from the Shopify API

About this repo | Usage | Authentication | Configuration

About this repo

Lighthouse CI on Shopify Theme Pull Requests using GitHub Actions.

Usage

Add shopify/lighthouse-ci-action to the workflow of your Shopify theme.

# .github/workflows/lighthouse-ci.yml
name: Shopify Lighthouse CI
on: [push]
jobs:
  lhci:
    name: Lighthouse
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2
      - name: Lighthouse
        uses: shopify/lighthouse-ci-action@v1
        with:
          store: ${{ secrets.SHOP_STORE }}
          access_token: ${{ secrets.SHOP_ACCESS_TOKEN }}
          lhci_github_app_token: ${{ secrets.LHCI_GITHUB_APP_TOKEN }}
          lhci_min_score_performance: 0.9
          lhci_min_score_accessibility: 0.9

Authentication

Authentication is done with Custom App access tokens.

1. Create the app.
2. Click the Configure Admin API Scopes button.
3. Enable the following scopes:
   • read_products
   • write_themes
4. Click Save.
5. From the API credentials tab, install the app.
6. Take note of the Admin API access token.
7. Add the following to your repository's GitHub Secrets:
   • SHOP_ACCESS_TOKEN: the Admin API access token
   • SHOP_STORE: Shopify store <store>.myshopify.com URL

Configuration

The shopify/lighthouse-ci-action accepts the following arguments:

• access_token - (required) see Authentication
• store - (required) Shopify store Admin URL, e.g. my-store.myshopify.com.
• store_web_url - (optional) The URL of the shop to visit. Defaults to store
• password - (optional) For password protected shops
• product_handle - (optional) Product handle to run the product page Lighthouse run on. Defaults to the first product.
• theme_root - (optional) The root folder for the theme files that will be uploaded. Defaults to .
• collection_handle - (optional) Collection handle to run the product page Lighthouse run on. Defaults to the first collection.
• lhci_min_score_performance - (optional, default: 0.6) Minimum performance score for a passed audit (must be between 0 and 1).
• lhci_min_score_accessibility - (optional, default: 0.9) Minimum accessibility score for a passed audit

For the GitHub Status Checks on PR. One of the two arguments is required:

• lhci_github_app_token - (optional) Lighthouse GitHub app token
• lhci_github_token - (optional) GitHub personal access token

For more details on the implications of choosing one over the other, refer to the Lighthouse CI Getting Started Page

Deprecated authentication configuration

The following were used to authenticate with private apps.

• app_id - (deprecated) Shopify store private app ID.
• app_password - (deprecated) Shopify store private app password.