Shadcn/UI переходит на Base UI по умолчанию

Shadcn/UI переходит на Base UI по умолчанию

Shadcn/UI официально объявила о смене компонентной основы: начиная с июля 2026 года Base UI становится библиотекой по умолчанию для новых проектов. История начинается с января 2023 года, когда Shadcn/UI был построен на Radix, тогда это была лучшая доступная альтернатива для unstyled headless компонентов с хорошими API и доступностью, протестированная в миллионах приложений. Спустя несколько лет авторы Radix создали Base UI, новый проект, впитавший все знания, полученные при разработке Radix.

Когда в прошлом году Base UI объявили бета-версию, разработчики просили сделать миграцию. Команда Shadcn/UI сперва не стала насильно переключать пользователей (переход между библиотеками компонентов может сломать боевое приложение), а вместо этого полностью перестроила все компоненты для Base UI, сохраняя ту же абстракцию. В декабре 2025 появилась возможность выбирать библиотеку при создании проекта (npx shadcn create), в январе 2026 были опубликованы полные документы для Base UI.

После долгого наблюдения стало понятно: пользователи сами выбирают Base UI в соотношении 2 к 1 по сравнению с Radix при создании новых проектов. Base UI уже стабилен (версия 1.6.0, более 6 миллионов еженедельных загрузок), команда регулярно добавляет новые полезные компоненты, и сами разработчики Shadcn/UI запускают все новые проекты на Base UI.

Радикс не снимается с поддержки: обе библиотеки будут обновляться параллельно, каждый новый компонент выйдет для обеих (кроме компонентов, существующих только в Base UI). Пользователи уже на Radix могут остаться, это зрелая и проверенная библиотека. Для тех, кто хочет мигрировать, создан специальный skill, который работает прогрессивно: можно переводить по одному компоненту и его использованиям, сохраняя проект в рабочем состоянии. Skill сохраняет все кастомизации, пропсы и изменения, которые разработчик делал в коде.

Миграция создаёт три артефакта: работающий код (типизированный и собранный), отчёт на каждый компонент (что изменилось, что оставлено, чек-лист для проверки вручную) и чистую git-историю (один коммит на компонент на ветке, откат просто, удалить ветку).

Ключевые факты

  • Base UI теперь default в Shadcn/UI; Radix остаётся в поддержке и никуда не девается
  • Base UI стабилен (1.6.0), разработчики сами его выбирают 2:1 над Radix в новых проектах
  • Миграция необязательна; пользователи Radix могут остаться и продолжать работу
  • Для тех, кто хочет мигрировать, создан skill, работающий прогрессивно, по одному компоненту, с сохранением всех кастомизаций
  • Skill автоматически генерирует отчёты и чистую git-историю, миграция 60+ компонентов занимает около 25 минут

Почему это важно

Shadcn/UI, популярный выбор для быстрой сборки интерфейсов на React. Смена основной компонентной библиотеки, важное решение, которое влияет на опыт разработки, поддержку и развитие экосистемы. Base UI, созданный авторами Radix с накопленным опытом, обещает улучшения и новые возможности. Официальный переход показывает, что Base UI достиг уровня зрелости, достаточного для production-среды.

Кому это важно

Frontend-разработчики, использующие Shadcn/UI в новых проектах; команды, рассматривающие Shadcn/UI как основу для своих систем дизайна; открытые проекты, которые берут Shadcn/UI как зависимость; авторы кастомных реестров компонентов на базе Shadcn/UI.

Как это применить

Новые проекты получат Base UI автоматически (npx shadcn init). Для существующих проектов: если код не трогали и полагаетесь на дефолтные компоненты, можно ничего не менять, Radix продолжит работать. Если хотите переходить, используйте skill для миграции: он интегрируется с Claude Code, Cursor и другими агентами. Скрипты CI, запускающие npx shadcn init без интерактивности и ожидающие Radix, нужно обновить флагом -b radix. Кастомные реестры должны указать registry:base, чтобы закрепить версию их библиотеки.

Можно ли доверять

Источник, официальный changelog Shadcn/UI. Base UI, реальный проект от авторов Radix с 6M+ еженедельных загрузок и версией 1.6.0, что подтверждает стабильность. Миграция тестировалась на реальных проектах (60+ компонентов, 36 из них на Radix). Скрипт сохраняет все кастомизации и работает прогрессивно, что снижает риск регрессии.

Риски и подводные камни

Основной риск, для проектов в боевой эксплуатации на Radix: переход требует тщательного тестирования. Хотя skill работает прогрессивно, поведение Base UI может отличаться от Radix в некоторых компонентах, нужна ручная проверка. Скрипты CI могут сломаться, если не обновить флаги. Для того чтобы остаться на Radix, потребуется явно указать флаг -b radix при инициализации.

«Потому что вы владеете кодом. Вы добавили варианты, изменили классы, протянули новые пропсы. Codemod работает для компонентов, которые вы никогда не трогали, и ломается на остальных. Поэтому мы выбрали знание вместо этого: каждое переименование, каждое изменение пропса, каждое различие в поведении проверено вручную для обеих библиотек.»

— Документация Shadcn/UI о выборе skill вместо codemod для миграции