Как перейти на Tailwind CSS 4 и не сломать вёрстку в 2026 году
Команда миграции, переименованные утилиты, тихие изменения стилей и что значит переход Tailwind Labs в Shopify.
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 столбца
Листайте столбцы →Смахните влевоВсе 4 столбца
анонс Tailwind CSS v4.0, январь 2025 года
Это замер вендора на единственном проекте, железо в анонсе не названо. В отдельной оговорке авторы пишут, что на своих проектах видели ускорение полной пересборки больше чем в 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.
Масштаб распространения объясняет, почему тему миграции не получится отложить навсегда: новая версия уже стала основной. Плагин @tailwindcss/vite, которого в третьей версии не существовало, за ту же неделю скачали 66 млн раз.
Как обновить проект автоматически?
Запустить официальный инструмент миграции в отдельной ветке. По словам авторов, для большинства проектов он выполняет миграцию целиком: обновляет зависимости, переносит конфигурацию в CSS и исправляет классы в шаблонах.
Инструменту нужен Node.js 20 или новее. После него руководство советует внимательно просмотреть diff и проверить проект в браузере: в сложных проектах часть правок придётся доделать вручную. Порядок, который экономит время:
- Убедиться, что рабочее дерево чистое, и создать ветку: так изменения инструмента будут видны в общем diff.
- Запустить
npx @tailwindcss/upgradeи прочитать его вывод: там перечислено, что перенести не удалось. - Собрать проект и открыть страницы с формами, карточками и модальными окнами: именно на них видны изменения рамок, теней и колец фокуса.
- Пройти по списку ломающих изменений из руководства и поискать в коде оставшиеся случаи.
- Убрать из зависимостей
postcss-importиautoprefixer, если инструмент оставил их.
Что придётся проверить и поправить руками?
Сначала способ подключения, затем переименованные классы, затем изменения значений по умолчанию. Первое ломает сборку сразу, остальное тихо меняет внешний вид.
В третьей версии пакет tailwindcss сам был плагином PostCSS. В четвёртой интеграции разнесены по отдельным пакетам: @tailwindcss/postcss, @tailwindcss/vite и @tailwindcss/cli, а с версии 4.2 есть и @tailwindcss/webpack. Для проектов на Vite авторы рекомендуют перейти с PostCSS на отдельный плагин.
Команда 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 столбца
Листайте столбцы →Смахните влевоВсе 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 utilities или @layer components, нужно перевести на директиву @utility: четвёртая версия использует настоящие каскадные слои и больше не перехватывает @layer. Только утилиты, объявленные через @utility, работают с вариантами вроде hover: и lg:.
Последняя частая проблема касается 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.
Плагин добавляется в vite.config.ts так же, как в примере выше. В CSS-файле остаётся импорт и, при необходимости, тема:
Каждая переменная из @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.
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 Plus и ui.sh, но регистрация новых закрыта. Купить готовые компоненты Tailwind Plus новым клиентам больше нельзя. Суммы и условий сделки в анонсе нет.
После объявления вышли версии 4.3.4 (2 ноября) и 4.3.5 (6 ноября), до них релизов не было с 16 июля. Судить по этому о темпе разработки под крылом Shopify рано; репозиторий с 98,7 тыс. звёзд остаётся под лицензией MIT. Для равновесия полезно помнить и аргументы противников утилитарного подхода: мы переводили материал о том, как структурировать CSS без Tailwind.
Частые вопросы
Можно ли оставить tailwind.config.js после перехода на четвёртую версию?
Да. JS-конфиг поддерживается для обратной совместимости, но автоматически не подхватывается: его подключают директивой @config в CSS. Опции corePlugins, safelist и separator при этом не работают.
Работает ли Tailwind CSS 4 с Next.js и webpack?
Да. Для PostCSS есть пакет @tailwindcss/postcss, а с версии 4.2 появился отдельный плагин @tailwindcss/webpack, который, по словам авторов, заметно ускоряет сборку во фреймворках вроде Next.js.
Почему после обновления у всех блоков появились чёрные рамки?
В четвёртой версии цвет рамки по умолчанию равен currentColor вместо gray-200. Нужно добавить класс цвета к каждому border или вернуть прежнее поведение базовым стилем из руководства по обновлению.
Поддерживается ли ещё третья версия?
В npm у неё есть отдельный тег v3-lts, последняя версия 3.4.19 вышла в декабре 2025 года. Руководство по обновлению советует оставаться на 3.4 проектам, которым нужны браузеры старше Safari 16.4, Chrome 111 и Firefox 128.
Нужен ли 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