https://github.com/etechflow/module-page-speed-optimizer
Magento 2 Page Speed Optimizer. Google PageSpeed Insights diagnostic from the admin + CLI, ETechFlow-feature mapping. v1.1+ adds CSS/JS minification, defer fonts, prioritize resource loading. Standalone or bundled with ETechFlow Image Optimizer.
https://github.com/etechflow/module-page-speed-optimizer
core-web-vitals ecommerce etechflow hyva hyva-compatible magento-2 magento-module magento2 magento2-module page-speed pagespeed-insights performance php seo
Last synced: 24 days ago
JSON representation
Magento 2 Page Speed Optimizer. Google PageSpeed Insights diagnostic from the admin + CLI, ETechFlow-feature mapping. v1.1+ adds CSS/JS minification, defer fonts, prioritize resource loading. Standalone or bundled with ETechFlow Image Optimizer.
- Host: GitHub
- URL: https://github.com/etechflow/module-page-speed-optimizer
- Owner: etechflow
- License: other
- Created: 2026-05-21T06:07:23.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-05-21T10:03:00.000Z (about 1 month ago)
- Last Synced: 2026-05-21T17:37:00.301Z (about 1 month ago)
- Topics: core-web-vitals, ecommerce, etechflow, hyva, hyva-compatible, magento-2, magento-module, magento2, magento2-module, page-speed, pagespeed-insights, performance, php, seo
- Language: PHP
- Homepage: https://etechflow.com
- Size: 133 KB
- Stars: 0
- Watchers: 0
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# ETechFlow Page Speed Optimizer
Magento 2 module that integrates with Google PageSpeed Insights — run real performance diagnostics from the admin, see Lighthouse lab data + real-user CrUX field data side-by-side, and get inline mappings from Google's recommendations to the ETechFlow setting that fixes each one.
Code optimization (CSS/JS/HTML minification, defer fonts, prioritize resource loading) is in development for v1.1+. v1.0 ships the visible-value feature first.
## Install
```bash
composer require etechflow/module-page-speed-optimizer:^1.0
bin/magento module:enable ETechFlow_PageSpeedOptimizer
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:flush
# Restart php-fpm to clear OPcache (mandatory on prod with opcache.validate_timestamps=0)
```
## Set up the Google API key (~3 min, one-time)
1. https://console.cloud.google.com/apis/credentials → **Create Credentials → API Key** (free)
2. Enable **PageSpeed Insights API** on the project (free, 25,000 requests/day)
3. Paste the key into **Stores → Configuration → eTechFlow → Page Speed Optimizer → Google PageSpeed Insights → API Key**
Without a key it still works, but you'll hit Google's per-IP rate limit (~1 request/second).
## Activate the licence
```bash
php tools/generate-license.php --module=page-speed-optimizer --host=
```
Paste the key into **Configuration → eTechFlow → Page Speed Optimizer → License Key** (or use the **Bundle License Key** if you're an ETechFlow suite customer).
## Verify
```bash
bin/magento etechflow:pso:verify
```
Ten PASS lines means you're good to go.
## Run your first diagnostic
```bash
bin/magento etechflow:pso:diagnose --url=https://your-store.com/ --strategy=mobile
```
Or via the admin: **Stores → Settings → Page Speed Diagnose** → click **Run diagnostic**.
## Configuration
`Stores → Configuration → eTechFlow → Page Speed Optimizer`:
- **License Key** — per-module key (or use Bundle License Key for the suite)
- **Module Enabled** — toggle the whole module
- **Google PageSpeed Insights API Key** — your Google Cloud API key
- **Default Strategy** — mobile (Google's mobile-first indexing default) or desktop
- **API Timeout** — default 90s (PSI typically takes 15-45s per page)
## Compatibility
- Magento Open Source 2.4.4 – 2.4.8
- Adobe Commerce 2.4.4 – 2.4.8
- PHP 8.1 / 8.2 / 8.3 / 8.4
- Hyvä Theme + Hyvä Checkout — admin-only module, theme-agnostic
## Support
info@etechflow.com — include your license key + Magento version when reporting issues.