Как перейти на Tailwind CSS 4 и не сломать вёрстку в 2026 году

Команда миграции, переименованные утилиты, тихие изменения стилей и что значит переход Tailwind Labs в Shopify.

Обложка: Как перейти на Tailwind CSS 4 и не сломать вёрстку в 2026 году

Tailwind CSS 4 — переписанная с нуля версия CSS-фреймворка, в которой конфигурация переехала из tailwind.config.js в сам CSS, а сборка ускорилась в разы. Текущая версия 4.3.5 вышла 6 ноября 2026 года, ветка 3.4 получает только исправления: последняя 3.4.19 вышла в декабре 2025 года. Пакет tailwindcss за неделю с 9 по 15 ноября скачали из npm 182 млн раз.

Для существующего проекта переход сводится к запуску npx @tailwindcss/upgrade и разбору того, что инструмент не смог поправить сам. Изменений, которые меняют внешний вид без единой ошибки сборки, в четвёртой версии достаточно: другой цвет рамок по умолчанию, другая толщина ring, сдвинутая шкала теней и скруглений.

Ниже — порядок миграции по официальному руководству, список правок, которые стоит проверить глазами, установка в новый проект и обзор обновлений из версий 4.1, 4.2 и 4.3. В конце разберём, что меняет для пользователей переход Tailwind Labs в Shopify, объявленный 9 сентября 2026 года.

Ключевые выводы
  • Tailwind CSS 4 работает в Safari 16.4, Chrome 111 и Firefox 128 и новее; проектам со старыми браузерами авторы советуют оставаться на 3.4.
  • Команда npx @tailwindcss/upgrade обновляет зависимости, переносит конфигурацию в CSS и правит шаблоны; ей нужен Node.js 20 или новее.
  • На проекте Catalyst полная сборка ускорилась с 378 до 100 мс, а инкрементальная без нового CSS — с 35 мс до 192 мкс, по замерам Tailwind Labs.
  • Без ошибок, но с другим результатом: рамки теперь цвета currentColor, ring стал толщиной 1px, shadow-sm надо заменить на shadow-xs.
  • Sass, Less и Stylus с четвёртой версией не работают; опции corePlugins, safelist и separator из JS-конфига не поддерживаются.
  • После перехода в Shopify фреймворк остаётся под лицензией MIT, а продажа Tailwind Plus новым клиентам закрыта.

Чем Tailwind CSS 4 отличается от третьей версии?

Поменялись 3 вещи: движок, способ настройки и требования к браузерам. В анонсе версии 4.0 от 22 января 2025 года автор фреймворка Адам Уотан называет её переписанной с нуля.

  • Конфигурация в CSS. Вместо tailwind.config.js дизайн-токены объявляются директивой @theme прямо в файле, куда импортирован Tailwind, и автоматически превращаются в обычные CSS-переменные вида --color-blue-500.
  • Подключение в 1 строку. Вместо 3 директив @tailwind base, components и utilities теперь используется стандартный @import "tailwindcss".
  • Автопоиск шаблонов. Массив content больше не нужен: фреймворк сам находит файлы с классами, пропуская всё из .gitignore и бинарные файлы. Дополнительный путь добавляет директива @source.
  • Меньше зависимостей. Импорт CSS-файлов и вендорные префиксы обрабатываются внутри, поэтому postcss-import и autoprefixer из проекта можно убрать.
  • Современный CSS под капотом. Каскадные слои, @property и color-mix() используются для базовых возможностей, отсюда и новые требования к браузерам.

Скорость сборки Tailwind Labs замеряла на собственном наборе компонентов Catalyst и приводит медианное время. Полная сборка стала быстрее в 3,78 раза, инкрементальная с новым CSS — в 8,8 раза, а пересборка без новых классов занимает микросекунды.

Время сборки Catalyst, замер Tailwind Labs

3 сервиса, 4 столбца
Время сборки Catalyst, замер Tailwind Labs
Сценарийv3.4v4.0Ускорение
Полная сборка378 мс100 мсв 3,78 раза
Инкрементальная, появился новый CSS44 мс5 мсв 8,8 раза
Инкрементальная, нового CSS нет35 мс192 мксв 182 раза
Листайте столбцы →Смахните влевоВсе 4 столбца
анонс Tailwind CSS v4.0, январь 2025 года
Как перейти на Tailwind CSS 4 и не сломать вёрстку в 2026 году_9
Медианное время сборки проекта Catalyst в Tailwind CSS 3.4 и 4.0, миллисекунды. График: Tproger по данным Tailwind Labs

Это замер вендора на единственном проекте, железо в анонсе не названо. В отдельной оговорке авторы пишут, что на своих проектах видели ускорение полной пересборки больше чем в 3,5 раза и инкрементальной больше чем в 8 раз.

Каким проектам переходить на четвёртую версию рано?

Тем, кому нужны старые браузеры или препроцессоры. Tailwind CSS 4 рассчитан на Safari 16.4, Chrome 111 (обе вышли в марте 2023 года) и Firefox 128 (июль 2024 года): от поддержки @property и color-mix() зависят базовые возможности фреймворка, сказано в разделе о совместимости. С версии 4.1 часть возможностей в старых браузерах, включая Safari 15, работает через запасные значения, но полной поддержки авторы не обещают. Для более старых браузеров руководство советует оставаться на 3.4; о режиме совместимости авторы пишут только, что изучают такую возможность.

Второе ограничение — препроцессоры. Четвёртая версия не предназначена для работы вместе с Sass, Less или Stylus: ни в основных таблицах стилей, ни в блоках <style> компонентов Vue, Svelte и Astro. Авторы предлагают считать препроцессором сам Tailwind: вложенность он разворачивает через Lightning CSS, импорты собирает сам, а переменные и математические функции есть в браузерах.

Третье — возможности JS-конфига, которые не перенесены в четвёртую версию. Опции corePlugins, safelist и separator не поддерживаются; вместо safelist используется @source inline(). Функция resolveConfig удалена: значения темы теперь читаются из CSS-переменных, в том числе из JavaScript через getComputedStyle.

Как перейти на Tailwind CSS 4 и не сломать вёрстку в 2026 году_15
Загрузки пакетов из npm за неделю с 9 по 15 ноября 2026 года, млн. График: Tproger по данным npm

Масштаб распространения объясняет, почему тему миграции не получится отложить навсегда: новая версия уже стала основной. Плагин @tailwindcss/vite, которого в третьей версии не существовало, за ту же неделю скачали 66 млн раз.

Как обновить проект автоматически?

Запустить официальный инструмент миграции в отдельной ветке. По словам авторов, для большинства проектов он выполняет миграцию целиком: обновляет зависимости, переносит конфигурацию в CSS и исправляет классы в шаблонах.

			git switch -c tailwind-v4
npx @tailwindcss/upgrade
		

Инструменту нужен Node.js 20 или новее. После него руководство советует внимательно просмотреть diff и проверить проект в браузере: в сложных проектах часть правок придётся доделать вручную. Порядок, который экономит время:

  1. Убедиться, что рабочее дерево чистое, и создать ветку: так изменения инструмента будут видны в общем diff.
  2. Запустить npx @tailwindcss/upgrade и прочитать его вывод: там перечислено, что перенести не удалось.
  3. Собрать проект и открыть страницы с формами, карточками и модальными окнами: именно на них видны изменения рамок, теней и колец фокуса.
  4. Пройти по списку ломающих изменений из руководства и поискать в коде оставшиеся случаи.
  5. Убрать из зависимостей postcss-import и autoprefixer, если инструмент оставил их.

Что придётся проверить и поправить руками?

Сначала способ подключения, затем переименованные классы, затем изменения значений по умолчанию. Первое ломает сборку сразу, остальное тихо меняет внешний вид.

В третьей версии пакет tailwindcss сам был плагином PostCSS. В четвёртой интеграции разнесены по отдельным пакетам: @tailwindcss/postcss, @tailwindcss/vite и @tailwindcss/cli, а с версии 4.2 есть и @tailwindcss/webpack. Для проектов на Vite авторы рекомендуют перейти с PostCSS на отдельный плагин.

			// postcss.config.mjs
export default {
  plugins: {
    "@tailwindcss/postcss": {},
  },
};
		
			// vite.config.ts
import { defineConfig } from "vite";
import tailwindcss from "@tailwindcss/vite";

export default defineConfig({
  plugins: [
    tailwindcss(),
  ],
});
		

Команда CLI тоже поменялась: вместо npx tailwindcss -i input.css -o output.css теперь npx @tailwindcss/cli -i input.css -o output.css.

Шкалы теней, скруглений и размытия сдвинули на одну ступень, чтобы у каждого значения было имя. Старые «голые» классы продолжают работать, но shadow-sm, rounded-sm и blur-sm теперь означают другое значение, поэтому без замены интерфейс станет чуть грубее.

Переименованные утилиты

10 сервисов, 2 столбца
Переименованные утилиты
v3v4
shadow-smshadow-xs
shadowshadow-sm
rounded-smrounded-xs
roundedrounded-sm
blur-smblur-xs
blurblur-sm
drop-shadow-smdrop-shadow-xs
backdrop-blur-smbackdrop-blur-xs
outline-noneoutline-hidden
ringring-3
Листайте столбцы →Смахните влевоВсе 2 столбца
руководство по обновлению Tailwind CSS

Кроме того, удалены утилиты, помеченные устаревшими ещё в третьей версии: вместо bg-opacity-* и text-opacity-* пишут модификатор прозрачности (bg-black/50), вместо flex-shrink-* и flex-grow-* — shrink-* и grow-*. Изменения, которые не дают ошибок и поэтому опаснее остальных:

  • Цвет рамок. border-* и divide-* раньше по умолчанию брали gray-200, теперь currentColor. Цвет нужно указать явно или вернуть прежнее поведение базовым стилем.
  • Кольцо фокуса. ring был толщиной 3px и цвета blue-500, стал 1px и currentColor. Замена: ring-3 ring-blue-500.
  • Кнопки и плейсхолдеры. У кнопок теперь cursor: default, как в браузерах, а цвет плейсхолдера равен цвету текста с прозрачностью 50% вместо gray-400.
  • Hover на телефонах. Вариант hover срабатывает только на устройствах с поддержкой наведения: он обёрнут в @media (hover: hover). Интерфейс, который раскрывался по тапу через hover, перестанет раскрываться.
  • Отступы space и divide. Селектор space-y-* заменён на :not(:last-child) с отступом снизу ради производительности на больших страницах; вёрстка с инлайновыми элементами может поплыть. Авторы советуют flex или grid с gap.
  • Порядок вариантов. Сложенные варианты применяются слева направо: first:*:pt-0 превращается в *:first:pt-0.
  • Синтаксис. Модификатор важности ставится в конец (flex!), CSS-переменная в произвольном значении пишется в круглых скобках (bg-(--brand-color) вместо bg-[--brand-color]), префикс выглядит как вариант (tw:flex).
  • Трансформации. rotate-*, scale-* и translate-* работают через отдельные CSS-свойства, поэтому transition-[opacity,transform] их больше не анимирует: в списке нужно перечислить сами свойства, например transition-[opacity,scale] для масштаба, а для поворота и сдвига добавить rotate и translate.

Если менять классы по всему проекту некогда, прежнее поведение рамок возвращает блок из руководства:

			@layer base {
  *,
  ::after,
  ::before,
  ::backdrop,
  ::file-selector-button {
    border-color: var(--color-gray-200, currentColor);
  }
}
		

Собственные классы, которые раньше объявлялись внутри @layer utilities или @layer components, нужно перевести на директиву @utility: четвёртая версия использует настоящие каскадные слои и больше не перехватывает @layer. Только утилиты, объявленные через @utility, работают с вариантами вроде hover: и lg:.

			/* v3 */
@layer utilities {
  .tab-4 {
    tab-size: 4;
  }
}

/* v4 */
@utility tab-4 {
  tab-size: 4;
}
		

Последняя частая проблема касается Vue, Svelte, Astro и CSS-модулей. Стили, которые собираются отдельно от основного файла, не видят тему и собственные утилиты, и @apply в них перестаёт работать. Решение — подключить основной файл директивой @reference "../../app.css"; в начале блока стилей: она даёт доступ к определениям и не дублирует CSS в бандле. Старый JS-конфиг при необходимости подключается явно, строкой @config "../../tailwind.config.js";, так как автоматически он больше не подхватывается.

Как подключить Tailwind CSS 4 к новому проекту?

Понадобятся 3 шага: поставить 2 пакета, добавить плагин в конфигурацию Vite и прописать строку импорта. Так выглядит установка через Vite, которую документация называет самым простым способом для Laravel, SvelteKit, React Router, Nuxt и SolidJS.

			npm create vite@latest my-project
cd my-project
npm install tailwindcss @tailwindcss/vite
		

Плагин добавляется в vite.config.ts так же, как в примере выше. В CSS-файле остаётся импорт и, при необходимости, тема:

			@import "tailwindcss";

@theme {
  --font-display: "Satoshi", "sans-serif";
  --breakpoint-3xl: 120rem;
  --color-avocado-100: oklch(0.99 0 0);
  --color-avocado-500: oklch(0.84 0.18 117.33);
  --ease-fluid: cubic-bezier(0.3, 0, 0, 1);
}
		

Каждая переменная из @theme порождает утилиты (font-display, bg-avocado-500, вариант 3xl:) и доступна как обычная CSS-переменная в :root, так что её можно использовать в инлайновых стилях и анимациях. По умолчанию в итоговый CSS попадают только те переменные, которые используются; вывести все позволяет @theme static. Про сам Vite и инструменты вокруг него у нас есть отдельный гайд.

Что добавили в версиях 4.1, 4.2 и 4.3 и что меняет переход в Shopify?

После 4.0 фреймворк получил 3 минорных релиза, и все они обходятся без миграции. Версия 4.1 в апреле 2025 года добавила тени текста и маски. Версия 4.2 в феврале 2026 года принесла 4 палитры (mauve, olive, mist, taupe), собственный плагин для webpack и новые утилиты логических свойств. Версия 4.3 от 8 мая 2026 года добавила стилизацию полос прокрутки, утилиты zoom-* и tab-*, @container-size для контейнерных запросов по высоте и составные варианты в @variant. Обновление внутри четвёртой ветки делается командой npm install tailwindcss@latest @tailwindcss/vite@latest.

9 сентября 2026 года Адам Уотан объявил, что Tailwind Labs присоединяется к Shopify. По его словам, фреймворк устанавливают больше 110 млн раз в неделю, а на нём построены интерфейсы ChatGPT, X, Cloudflare, Reddit и самого Shopify.

We're joining Shopify to give Tailwind a stable long-term home where it will be actively maintained for the millions of people who depend on it.
Адам Уотансоздатель Tailwind CSS (перевод: «Мы присоединяемся к Shopify, чтобы дать Tailwind стабильный дом на долгий срок, где его будут активно поддерживать для миллионов людей, которые от него зависят»)
Nothing changes with Tailwind CSS or any of our other open-source projects. Everything will always be MIT-licensed, and our team will continue to lead and maintain these projects for the community with the support of Shopify.
Адам Уотансоздатель Tailwind CSS (перевод: «Для Tailwind CSS и остальных наших проектов с открытым кодом ничего не меняется. Всё всегда будет под лицензией MIT, а наша команда продолжит вести и поддерживать эти проекты для сообщества при поддержке Shopify»)

Меняется коммерческая часть. Компания перестаёт развивать бизнес вокруг фреймворка: действующие клиенты сохраняют доступ к Tailwind Plus и ui.sh, но регистрация новых закрыта. Купить готовые компоненты Tailwind Plus новым клиентам больше нельзя. Суммы и условий сделки в анонсе нет.

После объявления вышли версии 4.3.4 (2 ноября) и 4.3.5 (6 ноября), до них релизов не было с 16 июля. Судить по этому о темпе разработки под крылом Shopify рано; репозиторий с 98,7 тыс. звёзд остаётся под лицензией MIT. Для равновесия полезно помнить и аргументы противников утилитарного подхода: мы переводили материал о том, как структурировать CSS без Tailwind.

Частые вопросы
1
Можно ли оставить tailwind.config.js после перехода на четвёртую версию?

Да. JS-конфиг поддерживается для обратной совместимости, но автоматически не подхватывается: его подключают директивой @config в CSS. Опции corePlugins, safelist и separator при этом не работают.

2
Работает ли Tailwind CSS 4 с Next.js и webpack?

Да. Для PostCSS есть пакет @tailwindcss/postcss, а с версии 4.2 появился отдельный плагин @tailwindcss/webpack, который, по словам авторов, заметно ускоряет сборку во фреймворках вроде Next.js.

3
Почему после обновления у всех блоков появились чёрные рамки?

В четвёртой версии цвет рамки по умолчанию равен currentColor вместо gray-200. Нужно добавить класс цвета к каждому border или вернуть прежнее поведение базовым стилем из руководства по обновлению.

4
Поддерживается ли ещё третья версия?

В npm у неё есть отдельный тег v3-lts, последняя версия 3.4.19 вышла в декабре 2025 года. Руководство по обновлению советует оставаться на 3.4 проектам, которым нужны браузеры старше Safari 16.4, Chrome 111 и Firefox 128.

5
Нужен ли Node.js, чтобы пользоваться Tailwind CSS 4?

Для плагинов Vite, PostCSS и webpack нужен, они ставятся через npm. Инструмент миграции @tailwindcss/upgrade требует Node.js 20 или новее.

Источники: Tailwind CSS: Upgrade guide, Tailwind CSS: Compatibility, Tailwind CSS: Installing with Vite, Tailwind CSS v4.0, Tailwind CSS v4.1, Tailwind CSS v4.3: Scrollbars, new colors, and more, Tailwind Labs is joining Shopify, GitHub: tailwindlabs/tailwindcss, релизы, npm: tailwindcss

Изображение на обложке: Tailwind Labs