Як перенести компонент
Що саме копіювати, у якому порядку і чого не робити.
Компоненти не встановлюються пакетом. Ви копіюєте файл у свій проєкт — і далі він ваш.
Завантажити з сайту
На кожній сторінці компонента є кнопка «Завантажити ZIP». Архів містить компонент, усі вкладені залежності, базові стилі та інструкцію. JSON-каталог і інструкція для агентів дозволяють отримувати ті самі файли без браузера та Git.
Порядок
1. Токени. Один раз на проєкт скопіюйте app/assets/css/tokens.css і
підключіть його. Це чистий CSS без синтаксису Tailwind: працює однаково на
v3 і v4.
2. Реєстрація токенів. На Tailwind v4 скопіюйте ще й theme.css. На v3
замість нього візьміть конфіг зі сторінки Токени
— класи утиліт будуть ті самі.
3. Сам компонент. Завантажте ZIP на його сторінці та перенесіть потрібні
файли зі збереженням структури каталогів. Разом із токенами підключіть
components.css — базові стилі, утиліти прокрутки та reduced-motion.
Мобільний viewport. Один раз на проєкт: viewport-fit=cover у meta
viewport. Без нього на iPhone безпечні зони компонентів (футер модалки,
нижній sheet, тостер) дорівнюють нулю. Деталі — на сторінці
Мобільні пристрої.
4. Залежності. Якщо на сторінці компонента є блок «Портування» зі
списком файлів — скопіюйте і їх. Наприклад, UiSelect без
uiFieldStyles.ts лишиться без стилів, а UiModal без чотирьох
композаблів overlay-ядра просто не працюватиме.
Що варто змінити після копіювання
Українські рядки. Типові підписи українські. Для i18n підключіть
setUiTextTranslator((message, values) => i18n.t(message, values))
з ~/composables/useUiText перед монтуванням застосунку. Якщо перекладач
читає реактивну мову, підписи оновлюються при її перемиканні.
Шляхи імпортів. Компоненти імпортують одне одного через ~/components/ui/…
і ~/composables/…. Якщо у вашому проєкті інший аліас — поправте.
Чого не робити
Не копіюйте компонент без токенів. Він виглядатиме зламаним, бо всі кольори посилаються на змінні, яких у проєкті немає. Це найчастіша помилка.
Не правте компонент, щоб він «вписався» в чужі кольори. Якщо кнопка на вашому фоні виглядає не так — виправляйте токени, а не класи всередині компонента. Інакше наступне оновлення доведеться зливати руками.
Не тягніть overlay-ядро двічі. Якщо в проєкті вже є UiModal, то для
UiDrawer чи UiConfirmDialog композабли копіювати вдруге не потрібно —
вони спільні, і саме тому вкладені оверлеї працюють правильно.