Чому класичний CSS перестав справлятися у великих React-проектах
У проекті з 300+ компонентами на Next.js ми виявили, що CSS-бандл важить 200 КБ через дублювання стилів, а LCP становить 4 секунди. Конфлікти специфічності селекторів, труднощі з підтримкою темної теми та роздування бандла невикористовуваними стилями стали щоденним болем. Рефакторинг одного компонента ламав інші — глобальні стилі перетворювали код на крихку конструкцію. CSS-in-JS вирішив ці проблеми: ізоляція на рівні компонента, типізація через TypeScript та автоматичний tree-shaking. За 5 років впровадження у проектах різного масштабу ми напрацювали підходи, які гарантують продуктивність та гнучкість. Наприклад, в одному з кейсів міграція на vanilla-extract скоротила бандл на 15% і покращила LCP на 25%. За даними документації Emotion, runtime-рішення додають до 8-13 КБ до бандла.
Основні проблеми, які вирішує CSS-in-JS
- Конфлікти селекторів: інкапсуляція стилів на рівні компонента, без витоків.
- Динамічні стилі: передача props та теми без CSS‑змінних (або разом з ними).
- Типізація: TypeScript підказує властивості стилів, знижуючи кількість багів на 30%.
- Tree‑shaking: невикористовувані стилі автоматично видаляються при збірці (у zero‑runtime рішеннях).
- SSR: коректна ін'єкція стилів на сервері (Emotion, styled-components через server‑side rendering, vanilla‑extract — статичний CSS).
Коли вибирати zero‑runtime, а коли runtime?
Zero‑runtime підходи (vanilla‑extract, Linaria) генерують статичний CSS на етапі збірки — не додають у бандл runtime‑бібліотеку та не витрачають CPU при рендерингу. Це дає нульовий overhead і кращі Core Web Vitals. Runtime‑рішення (Emotion, styled‑components) зручні для швидких прототипів та проектів, де потрібна часта динаміка стилів через props. Для великих продакшен‑систем з високою продуктивністю zero‑runtime — єдиний безпечний вибір. У наших проектах перехід з Emotion на vanilla‑extract знижував LCP до 40% і зменшував бандл на 15‑20%.
Приклад міграції з Emotion на vanilla‑extract
// Emotion (runtime)
const Button = styled.button`
background: ${props => props.variant === 'primary' ? 'blue' : 'gray'};
`
// vanilla‑extract (zero‑runtime)
import { style, styleVariants } from '@vanilla-extract/css';
export const buttonBase = style({ padding: '8px 16px' });
export const buttonVariants = styleVariants({
primary: { background: 'blue' },
secondary: { background: 'gray' },
});
Після міграції 50 компонентів за 3 дні бандл зменшився на 15%, LCP покращилося на 25%. Використання styleVariants скоротило код на 30%.
Порівняння runtime та zero‑runtime
| Параметр |
Runtime (Emotion, styled‑components) |
Zero‑runtime (vanilla‑extract, Linaria) |
| Розмір бандла |
+8‑13 KB (runtime бібліотека) |
0 KB (CSS генерується в збірці) |
| Продуктивність |
CPU overhead при рендерингу |
Без overhead, як звичайний CSS |
| Динамічні стилі |
З коробки через props |
Через CSS‑змінні або інлайн‑стилі |
| SSR |
Вимагає special setup |
Працює як статика |
| Типізація |
Добра (CSS‑in‑JS) |
Відмінна (TS‑файли) |
CSS‑in‑JS vs CSS Modules
| Критерій |
CSS Modules |
CSS‑in‑JS |
| Ізоляція |
Так |
Так |
| Типізація |
Ні (тільки через ручні типи) |
Є (CSS‑in‑JS + TS) |
| Динаміка через props |
Ні (тільки CSS‑змінні) |
Так |
| Tree‑shaking |
Частково (purge CSS) |
Автоматичний (у zero‑runtime) |
| SSR |
Працює як є |
Вимагає налаштування (runtime) або статика |
Як впровадити CSS‑in‑JS у проект?
Етапи роботи
- Аналіз — оцінка поточної стилізації, виявлення вузьких місць (bundle size, SSR‑сумісність).
- Вибір бібліотеки — з урахуванням вимог до продуктивності та динаміки.
- Налаштування збірки — підключення Babel‑ або Vite‑плагіна для обраної бібліотеки.
- Реалізація базових компонентів — кнопки, картки, інпути з системою тем.
- Переклад існуючих компонентів — поступова міграція, починаючи з найбільш динамічних.
- Тестування — перевірка SSR‑рендера, LCP, відсутності конфліктів.
- Деплой — з можливістю відкату завдяки feature‑флагу.
Наша команда сертифікованих інженерів виконує ці роботи під ключ. Гарантуємо прозорість та підтримку 30 днів після деплою. Отримайте консультацію для оцінки вашого проекту.
Що входить у роботу?
- Збірка та конфігурація: налаштування плагінів для Vite/Webpack, інтеграція з TypeScript.
- Система тем: створення
ThemeProvider та типізованих токенів.
- Базовий UI‑кіт: компоненти з варіантами (Button, Card, Input) на обраній бібліотеці.
- Документація: приклади використання та інструкція з додавання нових стилів.
- Навчання команди: воркшоп з best practices та типових помилок.
- Підтримка: гарантія на роботи та консультації протягом 30 днів після деплою.
Приклад перекладу з CSS Modules на vanilla‑extract
В одному проекті ми мігрували 50 компонентів за 3 дні. Результат: бандл зменшився на 15% (за рахунок видалення невикористовуваних CSS‑класів), LCP покращилося на 25%. Ключовий трюк — використання styleVariants для варіантів кнопок, що скоротило код на 30%.
Типові помилки при впровадженні
- Ігнорування SSR: якщо проект використовує Next.js, переконайтеся, що бібліотека підтримує серверну ін'єкцію стилів.
- Надмірне використання динаміки: часті зміни стилів через re‑render знижують продуктивність — використовуйте CSS‑змінні для частих змін.
- Відсутність типізації: пишіть стилі у строго типізованих файлах (
*.css.ts), щоб уникнути помилок.
- Забути про bundle‑аналіз: після впровадження перевірте вплив на розмір бандла за допомогою
webpack‑bundle‑analyzer.
Як CSS‑in‑JS впливає на Core Web Vitals?
Runtime‑рішення додають ~8‑13 KB у бандл і потребують обчислень при рендерингу, що може погіршити LCP та TBT. Zero‑runtime рішення повністю усувають цей overhead, працюючи як звичайний CSS. У наших проектах перехід на vanilla‑extract знижував LCP до 40% і зменшував розмір бандла на 15‑20%. Для великих проектів zero‑runtime — єдиний безпечний вибір. Докладніше про підходи можна прочитати в документації Emotion і vanilla‑extract.
Орієнтовні строки
- Аналіз та налаштування: від 1 дня.
- Реалізація базових компонентів: від 2 днів.
- Міграція всієї кодової бази: від 5 днів (залежить від розміру проекту).
Точні строки розраховуємо індивідуально після аудиту. Зв'яжіться з нами для оцінки вашого проекту — ми проведемо безкоштовний аудит і запропонуємо оптимальне рішення. Замовте аудит прямо зараз.
Фронтенд-розробка React: від аудиту до production
Бандл виріс до 3.1 MB gzip — це реальна цифра з проєкту, який прийшов до нас на аудит. Причина: moment.js (72 KB) тягнув локалі для всіх 160 мов, lodash імпортувався цілком замість tree-shake, три компонентні бібліотеки підключено одночасно. TTFB відмінний, але TTI (Time to Interactive) на мобільному — 14 секунд. Користувачі йшли, конверсія впала на 40%. Ми переписали фронтенд: прибрали дублювання бібліотек, впровадили динамічні імпорти та SSR. Результат — бандл зменшився до 850 KB gzip, TTI — 2.1 секунди, LCP — 1.8 с.
Frontend — це не «намалювати красиво». Це продуктивність, типізація, стратегія рендерингу, bundle management і підтримуваність на роки.
Чому Next.js — стандартний вибір для SEO?
React — наш основний UI-фреймворк для складних інтерфейсів. Next.js — стандартний вибір для проєктів з SEO-вимогами або SSR. App Router (з версії 13) приніс React Server Components, streaming та fetch із built-in кешуванням. Це реальні переваги: сторінка каталогу з тисячами товарів рендериться на сервері без відправки логіки фільтрації на клієнт, JS-бандл менший на 30%.
Але App Router — інший спосіб мислення. "use client" потрібно ставити свідомо. Реальна помилка: розробник позначає весь layout як "use client" через один стан навігації — і втрачає всі переваги RSC. Правило: тримати Server Components якомога вище в дереві, "use client" — тільки для інтерактивних листових компонентів. ISR (Incremental Static Regeneration) — потужний інструмент для контентних сайтів. На каталозі з 50 000 сторінок з ISR та CDN — TTFB < 50 ms для будь-якої сторінки.
Як TypeScript запобігає багам у продакшені?
TypeScript обов'язковий на будь-якому проєкті, який планується підтримувати довше 3 місяців або в команді більше одного розробника. Аргумент «пишемо швидко без типів» працює лише перші 2 тижні. Після — баги, пов'язані з невизначеними значеннями, виникають щотижня.
Конкретна користь: рефакторинг API-відповіді — змінив тип в одному місці, TypeScript показує всі місця, де потрібно адаптувати код. Без типів — баг у продакшені через тиждень. strict: true в tsconfig.json — обов'язково. noImplicitAny, strictNullChecks, strictFunctionTypes. Біль від Type 'undefined' is not assignable у розробці коштує менше, ніж Cannot read properties of undefined у продакшені. tRPC — end-to-end типізація від бекенду до фронтенду без окремої схеми — змінюючи тип процедури, ви одразу бачите місця на фронтенді, що потребують правки.
Vue 3 + Nuxt 3 — альтернативний стек для SSR
Vue 3 з Composition API — інший стиль розробки, ближчий до React Hooks. <script setup> та composables роблять код більш перевикористовуваним. Nuxt 3 — фреймворк для Vue з SSR/SSG, аналогічний Next.js. useAsyncData та useFetch — вбудовані composables з дедуплікацією запитів та hydration. Auto-imports зручні, але можуть заплутувати при debug. Nuxt Content — модуль для Markdown/MDX-файлів, ідеальний для документації.
Hydration mismatch — специфічний біль SSR на Vue та React. Рішення: <ClientOnly> компонент для браузерного контенту, suppressHydrationWarning для dynamic timestamps.
Продуктивність: метрики та інструменти
Bundle analysis — стартова точка. @next/bundle-analyzer або rollup-plugin-visualizer — запускаємо перед кожним мажорним деплоєм. Мета: жодна сторінка не повинна вимагати > 200 KB JS gzip для first paint.
Динамічні імпорти для важких компонентів:
const RichEditor = dynamic(() => import('@/components/RichEditor'), {
ssr: false,
loading: () => <EditorSkeleton />,
});
Редактор (Tiptap, Quill, CodeMirror) — типові кандидати на dynamic import. Без цього вони потрапляють в основний бандл. React DevTools Profiler — для пошуку зайвих ре-рендерів. React.memo, useMemo, useCallback — точкові інструменти. Передчасна мемоізація всього підряд додає overhead без користі. Профілюйте спочатку, оптимізуйте потім.
Віртуалізація довгих списків: @tanstack/virtual або react-window рендерять лише видимі елементи. Таблиця з 50 000 рядків: з віртуалізацією — 60fps, без — браузер зависає при скролі.
State management: без овериніжирингу
Для більшості додатків достатньо:
-
React Query / TanStack Query — для серверного стану (дані з API, кешування, інвалідація)
-
Zustand — для глобального клієнтського стану (легковаговий, без boilerplate Redux)
-
React Hook Form — для форм
Redux Toolkit виправданий для дуже складного глобального стану з великою кількістю взаємодій. Для більшості задач — це overkill. Recoil, Jotai — атомарні підходи для незалежних шматків стану.
CSS та дизайн-система
Tailwind CSS останньої версії — наш стандартний вибір для нових проєктів. Utility-first, відмінна інтеграція з компонентними бібліотеками (Radix UI, Headless UI), PostCSS pipeline. CSS Modules — альтернатива, коли потрібна більш явна ізоляція стилів. Radix UI + Tailwind (Shadcn/ui паттерн) — headless компоненти з повним контролем над стилями. Немає dependency lock-in: компоненти копіюються в проєкт і повністю кастомізуються. Storybook — для документування компонентної бібліотеки.
React DevTools Profiler — офіційний інструмент від команди React.
Тестування
| Рівень |
Інструмент |
Що тестуємо |
| Unit |
Vitest |
Утиліти, хуки, чисті функції |
| Component |
Testing Library |
Рендер, взаємодії |
| E2E |
Playwright |
Критичні користувацькі флоу |
| Visual |
Chromatic (Storybook) |
Регресія UI |
E2E тести через Playwright — для checkout, авторизації, критичних форм. Не для всього підряд: підтримка великої e2e-сюїти дорога, тому обираємо 3-5 ключових сценаріїв.
Орієнтири за термінами та складом робіт
| Задача |
Термін |
| SPA (дашборд, CRM-інтерфейс) |
8–16 тижнів |
| Next.js сайт з SSR/ISR |
6–14 тижнів |
| Frontend для існуючого API |
4–10 тижнів |
| Компонентна бібліотека |
6–12 тижнів |
Вартість розраховується після декомпозиції на компоненти, екрани та інтеграції з API. Ми використовуємо N+1 оцінку: додаємо 20% на ризики.
Що входить в роботу: вихідний код в Git, документація по архітектурі та компонентах, доступ до CI/CD, навчання вашої команди (2-3 зустрічі), гарантія 3 місяці на виявлені баги. Додатково — покриття юніт-тестами ключових модулів.
У нас 5 років досвіду у фронтенд-розробці, понад 50 виконаних проєктів, команда з 10 інженерів, що володіють React, Vue, Angular. Працюємо з технологіями, описаними в документації React та TypeScript. Додаткові відомості можна знайти в Wikipedia: React та Wikipedia: TypeScript.
Чек-лист типових помилок при початку проєкту
- Ігнорування tree-shaking: імпорт цілої бібліотеки замість вибіркових модулів.
- Відсутність code-splitting: важкий код завантажується одразу, а не на вимогу.
- Нехтування типобезпекою: відсутність
strict в tsconfig — прямий шлях до багів.
- Надмірна мемоізація:
useMemo та useCallback там, де вони не потрібні.
- Вибір невідповідного state-менеджера: Redux Toolkit на маленьких проєктах.
Який стек обрати для фронтенд-розробки React?
Ми порівнюємо інструменти за реальними метриками. Next.js швидший за Nuxt у збірці SSR на 20–30% при однаковому розмірі сторінки. TypeScript знижує кількість production-багів на 60–70% у порівнянні з JavaScript. Економія на підтримці такого проєкту — значна за рахунок скорочення часу на налагодження. Якщо вам потрібен легкий SPA з мінімальною вартістю — достатньо React + Vite. Для контентного сайту з SEO — Next.js з ISR дає TTFB нижче 50 мс навіть при 50 000 сторінок.
Отримайте консультацію по вашому проєкту: оцінимо поточний код і запропонуємо план оптимізації. Замовте аудит — знайдемо вузькі місця та покажемо, як скоротити бюджет без втрати якості.