What is DDEV Unlighthouse Add-on?
This is a DDEV addon to run Unlighthouse in your site. Unlighthouse is a tool to scan your entire site with Google Lighthouse in 2 minutes (on average).
This is optimized for Aljibe projects, but can be used in any DDEV project.
Getting Started
Install this addon:
For DDEV v1.23.5 or above run
ddev add-on get Metadrop/ddev-unlighthouse
For earlier versions of DDEV run
ddev get Metadrop/ddev-unlighthouse
Once installed, make sure to restart your ddev project:
Configuration
This addon uses the tests/[local|pro|....]/unlighthouse.ts configuration file to customize tests according to your needs. You can modify this file following Unlighthouse configuration guidelines.
Running Tests
To execute unlighthouse tests, simply access your ddev environment and run any of this commands:
unlighthouse: Run tests and browse them live at https://$DDEV_HOSTNAME:5678unlighthouse-ci: Run tests and generate a static report in reports/unlighthouse folder
ddev [unlighthouse|unlighthouse-ci] <folder>[local|pre|pro...]
Accessing reports
Because of CORS restrictions, reports must be accessed via an HTTP server. To do this, you need to adjust the unlighthouse configuration and provide ddev’s URL. See unlighthouse/unlighthouse.ts for reference.
Interpreting Results
Once unlighthouse reports are generated, you can review them to identify areas for improvement in performance, accessibility, and more of your website.
Happy optimization!
Contributed and maintained by @Metadrop