Налаштування автоматичного запуску Lighthouse CI при кожному деплої

Ви пушите фічу, все зелене, через тиждень LCP на мобільних підскакує з 2.5с до 6с. Регресія пішла в прод — знайомо? Ми бачили такі випадки десятки разів. Рішення — автоматичний запуск Lighthouse CI при кожному деплої. Ви ловите падіння метрик на етапі CI, а не в проді, і точно знаєте, який комміт ініціював деградацію. Наш досвід — більше 50 успішних інтеграцій.

Автоматизація виявляє регресії в 3 рази швидше ручних перевірок та виключає людський фактор. Замість щотижневого аудиту — перевірка кожної зміни з блокуванням збірки при виході за пороги. Час виявлення проблеми скорочується з 2 днів до 2 годин. Lighthouse CI documentation рекомендує такий підхід для підтримки Core Web Vitals.

Як налаштувати автоматичний запуск Lighthouse при деплої?

Мінімальний стек: CI/CD (GitHub Actions, GitLab CI) + Lighthouse CI CLI + місце зберігання результатів. Ми використовуємо self-hosted LHCI сервер для історії та порівняння з baseline. Конфігурація описується в .lighthouserc.js.

module.exports = {
  ci: {
    collect: {
      url: [
        'http://localhost:3000/',
        'http://localhost:3000/about',
        'http://localhost:3000/catalog',
        'http://localhost:3000/product/test-product',
      ],
      numberOfRuns: 3,
      startServerCommand: 'npm run start:ci',
      startServerReadyPattern: 'ready on',
      startServerReadyTimeout: 30000,
    },
    assert: {
      assertions: {
        'categories:performance': ['warn', { minScore: 0.8 }],
        'categories:accessibility': ['error', { minScore: 0.9 }],
        'categories:best-practices': ['warn', { minScore: 0.85 }],
        'categories:seo': ['error', { minScore: 0.9 }],
        'first-contentful-paint': ['warn', { maxNumericValue: 2000 }],
        'largest-contentful-paint': ['error', { maxNumericValue: 2500 }],
        'total-blocking-time': ['warn', { maxNumericValue: 300 }],
        'cumulative-layout-shift': ['error', { maxNumericValue: 0.1 }],
        'speed-index': ['warn', { maxNumericValue: 3400 }],
      },
    },
    upload: {
      target: 'temporary-public-storage',
    },
  },
};

GitHub Actions workflow:

name: Lighthouse CI
on:
  push:
    branches: [main, master]
  pull_request:
    branches: [main, master]

jobs:
  lighthouse:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 20
          cache: npm
      - name: Install dependencies
        run: npm ci
      - name: Build
        run: npm run build
      - name: Run Lighthouse CI
        run: |
          npm install -g @lhci/[email protected]
          lhci autorun
        env:
          LHCI_GITHUB_APP_TOKEN: ${{ secrets.LHCI_GITHUB_APP_TOKEN }}
          LHCI_TOKEN: ${{ secrets.LHCI_TOKEN }}

Що дає автоматизація Lighthouse?

Автоматизація перетворює Lighthouse з разової перевірки на процес. Таблиця порівняння:

Self-hosted LHCI сервер дає історію та порівняння з baseline. Інвестиції в налаштування варіюються від 20 000 до 40 000 ₽ залежно від складності.

Чому варто обрати self-hosted LHCI сервер?

Self-hosted сервер зберігає звіти у вашій інфраструктурі, дозволяє порівнювати PR з головною гілкою та будувати тренди. Жодної залежності від зовнішніх сервісів — всі дані під контролем. Додатково, ви можете налаштувати сповіщення при падінні Core Web Vitals нижче порогу.

Які метрики критично важливі для e-commerce?

Для інтернет-магазину ключові метрики — Largest Contentful Paint (LCP) має бути не більше 2.5 с, Cumulative Layout Shift (CLS) не більше 0.1, Total Blocking Time (TBT) не більше 200 мс. Автоматичний Lighthouse CI перевіряє їх кожний деплой, гарантуючи, що зміни не погіршать користувацький досвід. Наприклад, після додавання нового банеру LCP виросло на 0.5 с — CI заблокував збірку, і розробник виправив до прода. Завдяки такому моніторингу продуктивності в 95% випадків регресія виявляється протягом 10 хвилин.

Процес роботи над налаштуванням

1. Аналітика — визначаємо ключові сторінки та пороги метрик. Наприклад, для маркетплейсу це карточка товару, каталог і головна.
2. Проектування — обираємо стек (GitHub Actions, GitLab CI, self-hosted) та архітектуру зберігання.
3. Реалізація — налаштовуємо .lighthouserc.js, workflow CI, додаємо сповіщення в Slack або Telegram.
4. Тестування — прогоняємо на PR, коригуємо пороги, переконуємось, що хибні спрацювання виключені.
5. Документація та навчання — передаємо конфіги, пишемо інструкцію для команди та налаштовуємо дашборд.

Сповіщення про деградацію

LHCI не відправляє Slack-сповіщення вбудовано, але ми додаємо крок в CI:

- name: Check Lighthouse results and notify
  if: always()
  run: |
    RESULT=$(cat .lighthouseci/manifest.json | jq -r '.[0].summary.performance')
    SCORE=$(echo "$RESULT * 100" | bc | cut -d. -f1)
    if [ "$SCORE" -lt "80" ]; then
      curl -X POST ${{ secrets.SLACK_WEBHOOK }} \
        -H 'Content-Type: application/json' \
        -d "{\"text\": \":warning: Lighthouse Performance score dropped to ${SCORE}/100 on \`${{ github.ref_name }}\"",\"attachments\": [{\"color\": \"danger\",\"text\": \"Commit: ${{ github.sha }}\
Actor: ${{ github.actor }}\"}]}"
    fi

Типові проблеми при налаштуванні

Перевірка конкретних аудитів

Окрім категорійних скорів, ми налаштовуємо перевірки конкретних аудитів, наприклад, render-blocking-resources, unsized-images, prioritize-lcp-image. Це дає більш точний контроль, ніж загальний скор. Також можна налаштувати перевірку окремих аудитів у конфігурації.

Строки та що входить

Базова налаштування в GitHub Actions з тимчасовим сховищем — 2–4 години. З self-hosted сервером та сповіщеннями — 1–2 робочих дні. Повна система з історією, порівнянням та інтеграцією в рев'ю — 3–5 робочих днів.

• Конфігурація Lighthouse CI для вашого репозиторію.
• Налаштування self-hosted LHCI серверу (якщо потрібна історія).
• Інтеграція з Slack/Telegram для сповіщень.
• Пороги для всіх метрик Core Web Vitals.
• Документація та навчання команди.

Економія бюджету на підтримку може становити до 15 000 ₽ на місяць. Наша команда займається Web Performance більше 5 років. Ми виконали 50+ інтеграцій Lighthouse CI для проектів різних масштабів — від лендінгів до маркетплейсів. Гарантуємо прозорість: ви отримуєте доступ до конфігів та історії змін.

Замовте налаштування Lighthouse CI — це займе від 2 годин. Отримайте консультацію з архітектури та економію часу до 3 годин на тиждень.

Чому Core Web Vitals критичні для технічного SEO

PageSpeed показує 34/100 на мобільних. У Search Console — червоні метрики по всіх сторінках категорій. Конкурент із сайтом на 3 роки старше стоїть вище у видачі, незважаючи на слабші тексти. Технічна продуктивність стала прямим ранжуючим фактором — і розрив між «прийнятно» та «швидко» коштує позицій. Ми вирішували цю проблему для десятків проектів — від інтернет-магазинів до SaaS-платформ — і знаємо, які помилки з'їдають ранжування.

Як досягти хороших показників Core Web Vitals?

Core Web Vitals: що реально впливає на позиції

Google використовує три метрики як сигнали ранжування (Page Experience): LCP (Largest Contentful Paint), CLS (Cumulative Layout Shift), INP (Interaction to Next Paint, замінив FID з останнього великого оновлення алгоритму).

LCP: чому 8 секунд — це не проблема зображення

LCP вимірює час відмальовки найбільшого видимого елемента сторінки. Найчастіше — hero image або H1. Пороги: добре < 2.5s, погано > 4s.

Типовий діагноз на реальному проекті: інтернет-магазин одягу, LCP 7.8s на мобільних. Елемент — hero image категорії, 4.2MB JPEG без srcset, завантажується через CSS background-image (не <img>). Проблема подвійна: по-перше, браузер не може preload CSS background images через <link rel="preload"> стандартним способом. По-друге, 4.2MB на мобільному з'єднанні — це фізично повільно.

Рішення по кроках:

1. Переносимо hero з CSS background в <img> з fetchpriority="high" та loading="eager"
2. Конвертуємо в WebP, додаємо srcset: 800w для мобільних, 1400w для десктопа
3. <link rel="preload" as="image" href="hero-800.webp" media="(max-width: 768px)"> в <head>
4. Прибираємо всі render-blocking скрипти вище hero через defer

Підсумок: LCP 7.8s → 1.9s. Без зміни хостингу, без CDN.

Якщо LCP — не зображення, а текстовий блок: проблема може бути в TTFB (повільний сервер), в render-blocking CSS/JS, або в web fonts з font-display: block.

CLS: зсуви, які дратують користувача і Google

CLS вимірює сумарний зсув елементів в процесі завантаження. Пороги: добре < 0.1, погано > 0.25. CLS 0.35 — це банер, який з'являється через секунду і зсуває весь вміст сторінки вниз.

Джерела CLS:

• Зображення без заданих розмірів. <img src="photo.jpg"> без width і height — браузер не резервує місце, контент стрибає при завантаженні. Фікс: явні width/height або aspect-ratio в CSS.
• Рекламні блоки та віджети. Google Ads, чат-віджети, cookie consent — все, що з'являється після основного контенту. Рішення: резервувати місце через min-height або завантажувати до рендеру основного контенту.
• Web fonts. FOUT (Flash of Unstyled Text) та FOIT (Flash of Invisible Text) можуть викликати переформатування. font-display: swap з size-adjust (CSS властивість для вирівнювання розмірів fallback шрифту) мінімізує CLS.
• Динамічний контент. Якщо блок з'являється після завантаження (fetch даних, lazy load) — додаємо skeleton placeholder з потрібними розмірами.

INP: чому інтерфейс «зависає» на 500ms

INP вимірює затримку відповіді на будь-яку взаємодію користувача: клік, тап, введення. Пороги: добре < 200ms, погано > 500ms. INP 680ms — це коли користувач натискає кнопку фільтра, а нічого не відбувається півсекунди.

Головна причина високого INP — заблокований main thread. JavaScript-бандл 2.1MB парситься і виконується синхронно. Поки виконується, користувацькі події не обробляються.

Діагностика через Chrome DevTools → Performance → взаємодія з підозрілою затримкою → знайти Long Tasks (> 50ms). Типові винуватці:

• Безперервна обробка великого списку без requestIdleCallback або requestAnimationFrame
• Важкі event listeners без debounce/throttle
• Синхронний setState в React, який тригерить повний ре-рендер складного дерева компонентів
• Third-party scripts: livechat, аналітика, віджети — вони виконуються в тому ж main thread

Рішення: code splitting через динамічний import(), перенесення важких обчислень в Web Workers, React.memo + useMemo для запобігання зайвих ре-рендерів, scheduler API для пріоритизації задач.

Schema.org: розмітка, яку читають роботи

Структуровані дані через JSON-LD — не прямий ранжуючий фактор, але дають rich snippets у видачі (зірки рейтингів, ціни, дата публікації), що збільшує CTR на 20–30%.

Типи розмітки за сценаріями:

• E-commerce: Product з offers (ціна, наявність, валюта), aggregateRating (рейтинг з відгуків), brand. BreadcrumbList для навігації. ItemList для сторінок категорій.
• Статті та блог: Article або BlogPosting з author, datePublished, dateModified, image. Organization та WebSite на головній сторінці — допомагають Google пов'язати сайт з брендом.
• Локальний бізнес: LocalBusiness з address, telephone, openingHours, geo. Критично для локального SEO.
• FAQ: FAQPage з mainEntity — питання та відповіді можуть з'являтися прямо у видачі як розкривний блок.

Валідація: Google Rich Results Test та Schema Markup Validator. Часта помилка — вказати price без priceCurrency, або ratingValue без reviewCount. Google ігнорує неповну розмітку.

Як проводити технічний SEO-аудит

Сканованість. robots.txt блокує потрібні сторінки (або навпаки, не блокує службові). Canonical URLs налаштовані неправильно — дублюються сторінки з UTM-мітками. Sitemap містить сторінки з noindex. Все це Screaming Frog або Sitebulb покажуть за годину сканування.

Core Web Vitals в масштабі. Google Search Console → Core Web Vitals → дивимося не окремі сторінки, а групи URL (шаблон сторінки продукту, шаблон категорії, блог). Проблема зазвичай системна — одна помилка в шаблоні псує сотні сторінок.

JavaScript SEO. Google рендерить JavaScript, але з затримкою (іноді дні для повного рендеру). Для критичного контенту — SSR або SSG обов'язкові. Перевіряємо через Search Console → Inspect URL → View Crawled Page: що бачить Googlebot.

Internal linking. Орфанні сторінки (немає вхідних внутрішніх посилань) втрачають PageRank. Бите посилання (404) — сигнал якості.

Що входить в роботу

• Документація: звіт зі знайденими проблемами, roadmap за пріоритетами, таймінги для кожного етапу.
• Доступи: налаштування моніторингу (SpeedCurve, Sentry Search Console), передача dashboard.
• Навчання: розбір типових помилок для вашої команди (1–2 дзвінки).
• Підтримка: супровід протягом місяця після деплою — перевірка метрик, фікс регресій.

Зв'яжіться з нами — ми оцінимо ваш проект за 2 дні і покажемо, скільки позицій можна повернути за рахунок технічного SEO. Досвід роботи з проектами рівня сотень тисяч відвідувань на місяць — гарантуємо вимірний результат в Core Web Vitals до/після. Замовте аудит у цій формі — отримайте персональний чек-лист з 15 пунктів.