Розробка UI-компонентів на Bitrix24 UI Kit (React)

Розробляєте UI-компоненти для Бітрікс24? Готові UI-кіти не враховують дизайн-систему порталу — доводиться вручну підганяти стилі, кольори та відступи. Bitrix24 UI Kit вирішує цю проблему: його React-компоненти успадковують тему порталу автоматично. Ми, команда з 5+ років досвіду, використовуємо @bitrix24/b24ui для створення інтерфейсів — від кнопок до складних дашбордів, які не відрізнити від рідних. За даними офіційної документації, використання UI Kit прискорює розробку в 2–3 рази. Отримайте консультацію — оцінимо ваш проєкт за один день. Економія на типовому проєкті — від 30 000 грн.

Які проблеми вирішує Bitrix24 UI Kit?

Стандартні UI-фреймворки вимагають ручної адаптації під тему порталу, RTL та специфіку Бітрікс24. Bitrix24 UI Kit позбавляє цього: компоненти успадковують стилі порталу, включаючи темну тему. Розробка з ним у 2–3 рази швидша, ніж написання з нуля. Вбудована підтримка RTL та багатомовності скорочує обсяг коду на третину. Завдяки готовим компонентам ви економите до 40% бюджету на розробку інтерфейсів — наприклад, на проєкті дашборду це до 40 000 грн. Використання UI Kit у 2,5 рази дешевше за індивідуальну розробку.

Як інтегрувати Bitrix24 UI Kit з React?

Інтеграція виконується через пакет @bitrix24/b24ui. Він містить готові React-компоненти, які автоматично підхоплюють тему порталу через <cite>B24ThemeProvider</cite>. Для роботи з REST API використовується @bitrix24/b24jssdk з повною типізацією TypeScript. Встановлення одного пакету замінює ручну адаптацію кожного компонента.

import { B24ThemeProvider, Button, Input, Table } from '@bitrix24/b24ui';

Приклад налаштування теми та використання токенів

function App() {
  return (
    <B24ThemeProvider>
      <Dashboard />
    </B24ThemeProvider>
  );
}

// Хук для роботи з темою
function ThemeAwareComponent() {
  const { theme, isDark } = useB24Theme();
  return <div className={isDark ? 'dark-specific' : ''}>...</div>;
}

Тема синхронізується з порталом через BX24.getTheme() та подію зміни теми — користувач перемикає тему в Бітрікс24, і додаток відображає зміну миттєво.

Як кастомізувати компоненти Bitrix24 UI Kit?

Кастомізація можлива двома способами: через передачу пропсів (наприклад, color, size) та через CSS-змінні дизайн-токенів. Як зазначають розробники, дизайн-токени дозволяють легко змінювати візуальний стиль. Якщо потрібно розширити функціональність — створюєте компонент-обгортку, який успадковує стилі UI Kit. Дизайн-токени доступні як CSS-змінні: --b24-color-base-3, --b24-radius-md, --b24-font-family. Повний перелік в офіційній документації.

Налаштування та ініціалізація теми

Використовуйте B24ThemeProvider для автоматичної синхронізації. Хук useB24Theme повертає об'єкт теми та прапор isDark. При зміні теми в порталі додаток оновлюється без перезавантаження.

Кейс: дашборд KPI для відділу продажів (наш клієнт)

Наш клієнт — великий відділ продажів із 30 менеджерами. Потрібен дашборд KPI з реальними даними з CRM Бітрікс24. Інтерфейс має бути стилістично не відмінний від порталу, підтримувати темну тему та працювати без навчання. Використані компоненти UI Kit: Table для таблиці менеджерів, Badge для статусів (виконано/ні), Avatar для фото, Select для періоду, Button для експорту. Кастомні компоненти поверх UI Kit: прогрес-бар KPI (через CSS-змінні UI Kit), спарклайн-графіки (Recharts зі стилізацією під палітру Бітрікс24), таблиця рейтингу з drag-and-drop сортуванням. Дані отримували через REST API CRM з використанням @bitrix24/b24jssdk. Запити асинхронні з кешуванням. Результат: користувачі не сприймають дашборд як сторонній додаток — інтерфейс органічно вписаний. Час розробки скоротився на 40%, економія для клієнта склала 35 000 грн порівняно з альтернативою.

Порівняння: свій UI проти Bitrix24 UI Kit

Таким чином, UI Kit у 2-3 рази ефективніший за написання з нуля.

Що входить у розробку

• Аудит вимог до інтерфейсу, складання компонентного плану
• Налаштування проєкту: @bitrix24/b24jssdk, @bitrix24/b24ui, TypeScript
• Розробка компонентів: базові (з UI Kit) + кастомні (поверх дизайн-токенів)
• Підтримка темної теми, тестування в обох варіантах
• Документування кастомних компонентів для команди підтримки
• Передача вихідного коду, інструкція з розгортання

Наша команда (5+ років досвіду) забезпечує повний цикл.

Популярні компоненти Bitrix24 UI Kit

Процес роботи

1. Аналітика — вивчаємо вимоги, прототипуємо
2. Проєктування — визначаємо склад компонентів, їх кастомізацію
3. Реалізація — пишемо код, використовуємо B24ThemeProvider
4. Тестування — перевіряємо всі стани (світла/темна тема, RTL, багатомовність)
5. Деплой — розгортаємо додаток на порталі, налаштовуємо CI/CD

Ми маємо 5+ років досвіду в Бітрікс24.

Терміни та вартість

Базовий набір екранів на UI Kit — 1–2 тижні (від 60 000 грн). Кастомна дизайн-система поверх UI Kit токенів — від 3 тижнів (від 120 000 грн). Наша команда з 5+ років досвіду реалізувала понад 20 проєктів на Бітрікс24 — гарантуємо якість та дотримання термінів. Зв'яжіться з нами для оцінки вашого проєкту за один день.

Вступ

Перше, що ми робимо, отримавши макет від «чистого» дизайнера — дивимося, як він ляже на bitrix:catalog.section і bitrix:catalog.element. У половині випадків нестандартний фільтр на макеті означає переписування bitrix:catalog.smart.filter з нуля. А це не 2 години — це тиждень. Тому ми проектуємо інтерфейс одразу під компонентну архітектуру Бітрікс, а не адаптуємо після. З нами ви отримуєте дизайн, який розробник збере без костилів та переробок.

Редизайн на Бітрікс часто впирається в одне й те саме: дані приходять з 1С через CommerceML, а дизайнер цього не враховує. Ми закладаємо в макети реальну структуру торговельного каталогу — властивості інфоблоків, типи цін, залишки по складах. Тоді картка товару не ламається, коли з'являється 15 характеристик і 4 ціни. Це скорочує ітерації узгодження на 30% та економить бюджет замовника — в середньому на значну суму на одному проекті.

Чому UX/UI для Бітрікс потребує особливого підходу?

Дизайнер намалював картку товару з трьома вкладками, кастомним конфігуратором та акордеоном характеристик. Красиво. Потім розробник відкриває шаблон catalog.element і розуміє: дані приходять із властивостей інфоблоку плоским списком, а пов'язані товари тягнуться через CATALOG_ELEMENT_ID. Половину макету потрібно перемалювати. Ми це знаємо — тому малюємо те, що можна зібрати без костилів.

Ось що ми закладаємо на етапі дизайну:

• Компонентна сітка — інтерфейс будується з реальних компонентів Бітрікс: bitrix:catalog, bitrix:sale.basket.basket, bitrix:sale.order.ajax, bitrix:system.auth.form. Дизайнер знає, які дані віддає кожен компонент і які параметри у нього є. Це дозволяє уникнути доопрацювань на стадії верстки. Як зазначає документація платформи, «Компонентна модель 1С-Бітрікс дозволяє будувати інтерфейси з готових блоків без дублювання логіки».
• Візуальний редактор — контент-менеджер буде правити контент через адміністративну панель. Блочна структура, гнучкі секції, керовані банери — все це продумується до Figma.
• Дані з 1С — товари, ціни типу BASE, RETAIL, залишки зі складів приходять через CommerceML. Картка товару враховує реальний обсяг даних: 15 характеристик, 4 типи цін, залишки по 3 складах — а не ідеальні три рядки з макету.
• Семантична верстка — ієрархія H1–H6, мікророзмітка Product/Offer, alt-тексти. Все закладається на етапі дизайну, тому що «допиляти SEO потім» означає переверстувати шаблони.

Типові проблеми дизайну та їх вирішення

Дослідження до відкриття Figma

Перш ніж малювати — копаємо в дані.

Ми формуємо персони та сценарії на основі Яндекс.Метрики (Вебвізор, теплові карти), GA4 та інтерв'ю. Не абстрактні «чоловік 25-45 років», а конкретні: «закупник, який формує замовлення за артикулами з Excel за 10 хвилин». Це дозволяє точніше проектувати прототипи.

При редизайні проводимо UX-аудит поточного сайту: воронки конверсій, записи сесій, точки відтоку. На одному проекті виявили, що 40% користувачів кидали кошик на кроці вибору доставки — тому що компонент sale.order.ajax рендерив 12 служб доставки без групування. Переробили — конверсія зросла на 18% (це дало додатковий дохід). Конкурентний розбір — не «подивилися красиві сайти», а структурний аналіз: навігація каталогу, кількість кроків до чекауту, робота фільтра на мобільних.

Прототипування

Прототип перевіряє логіку до витрати бюджету на візуал.

• Wireframes — схеми ключових сторінок: головна, каталог (catalog.section), картка (catalog.element), кошик (sale.basket.basket), чекаут (sale.order.ajax), особистий кабінет. Визначаємо пріоритет інформації.
• Клікабельні прототипи — Figma з переходами, модалками, роботою фільтрів. Замовник «торкається» сайту до початку розробки.
• Тести з користувачами — модеровані сесії з представниками ЦА. Проблему навігації дешевше зловити тут, ніж після верстки 40 шаблонів компонентів.

Покроковий процес проектування UX/UI для Бітрікс

1. Дизайн-аналітика — збір даних Метрики, інтерв'ю, аудит поточного інтерфейсу. Виявляємо точки відтоку (якщо конверсія падає на етапі вибору доставки — бачимо це у воронці).
2. Прототипування — wireframes + клікабельний прототип. Перевіряємо сценарії: пошук товару, додавання в кошик, оформлення замовлення. Ітерації до затвердження.
3. Створення дизайн-системи — типографіка, кольори, UI-компоненти, модульна сітка. Все прив'язуємо до компонентної моделі Бітрікс.
4. Дизайн ключових сторінок — макети під всі breakpoints (320–2560px). Враховуємо реальні дані: властивості інфоблоків, типи цін, залишки.
5. Передача в розробку — Figma з Dev Mode, експорт SVG/WebP/AVIF, документація по компонентах. Допомагаємо розробнику адаптувати шаблони під новий дизайн.

Дизайн-система

Для кожного проекту збираємо масштабовану систему — єдиний словник для дизайнерів та фронтенду.

• Типографіка — шрифтові пари, оптимізовані під кирилицю та веб-рендеринг. Розмірна шкала, інтерліньяж, ієрархія заголовків.
• Кольори — основні, акцентні, стани (hover, active, disabled, error). Контрастність за WCAG 2.1 AA мінімум.
• Модульна сітка — фіксовані відступи, консистентність від 320px до 2560px.
• UI-компоненти — кнопки, форми, картки, таблиці, повідомлення, іконки. Кожен — з варіантами станів та адаптивними версіями.
• Документація — правила застосування, щоб новий дизайнер не «винаходив» стилі. На практиці без неї через півроку в проекті 4 відтінки сірого та 3 варіанти кнопки «Купити».

Що дає дизайн-система для Бітрікс?

Вона прискорює розробку інтерфейсу в 2–3 рази, тому що верстальник отримує готові класи та відступи, а не вгадує їх за макетом. На одному проекті після впровадження дизайн-системи час на верстку нової сторінки каталогу скоротився з 5 днів до 1,5.

Що входить у роботу

На виході ви отримуєте:

• Figma-файл з дизайн-системою та макетами всіх сторінок (включаючи мобільні та планшетні версії).
• Інтерактивний прототип для узгодження та тестування.
• Документацію по компонентах (стилі, відступи, поведінки).
• Доступи до файлів та фінальні експорти в SVG/WebP/AVIF.
• Рекомендації щодо доопрацювання шаблонів Бітрікс під новий дизайн.
• Пост-релізну підтримку (до 2 тижнів) — допомагаємо розробнику розібратися в макетах.

Ми — сертифіковані партнери 1С-Бітрікс з 15+ років досвіду. Гарантуємо, що дизайн буде реалізований на вашій версії платформи. З нами працювали понад 50 інтернет-магазинів та корпоративних порталів — від лендінгів до маркетплейсів.

Mobile-first: не формальність, а порядок роботи

Проектуємо спочатку мобільну версію, потім розширюємо.

• Touch-friendly — мінімум 44x44px для інтерактивних елементів, достатні відступи. Свайп для галереї, pull-to-refresh для каталогу.
• Форми — автотип клавіатури (inputmode="numeric" для телефону, type="email" для пошти), маски введення через IMask, автозаповнення через DaData. Кожне зайве поле — мінус до конверсії, це не теорія, а те, що видно у воронках Метрики.
• Адаптивні зображення — різні ресайзи та кропи для мобільних/десктопних через <picture> та srcset. Art direction для банерів — на мобільному не зменшуємо, а показуємо інший кроп.

Як ми працюємо в Figma?

• Структура файлу — сторінки: дослідження, wireframes, UI-kit, макети за breakpoints, анімації. Не каша, а навігований проект.
• Auto Layout — компоненти на Flexbox-логіці, коректно тягнуться при зміні контенту. Розробник бачить у макеті ту саму модель, що буде в CSS.
• Variables та Variants — змінні для кольорів та відступів, компоненти з варіантами станів. Зміна теми — перемикання однієї колекції.
• Dev Mode — точні значення, експорт SVG/WebP/AVIF, інспектування CSS. Розробник отримує все без «вгадування по пікселям».

Usability testing

Як ми вимірюємо ефективність дизайну?

• Модеровані тести — реальні користувачі виконують завдання: знайти товар, додати в кошик, оформити замовлення. Фіксуємо, де спотикаються.
• A/B-тести — два варіанти на живому трафіку. Перемагає конверсія, а не думка арт-директора.
• Евристичний аудит — за принципами Нільсена: видимість статусу, відповідність очікуванням, єдність, запобігання помилкам.
• Доступність — контраст, клавіатурна навігація, alt-тексти, aria-мітки. Не факультатив, а вимога.

Конверсійний дизайн

• Візуальна ієрархія — CTA, ціни, акції виділені через розмір, колір, контраст. Погляд йде туди, куди потрібно бізнесу — перевіряється через eye-tracking або теплові карти.
• Мінімальне тертя — скорочуємо кроки до цільової дії. На одному проекті прибрали обов'язкову реєстрацію при чекауті — конверсія в замовлення піднялася на 18%.
• Соціальні докази — рейтинги, відгуки, кейси, логотипи партнерів. Інтегровані в дизайн, а не приліплені внизу сторінки.
• Мікроанімації — товар летить у кошик, форма підтверджує відправку. Направляють увагу та знижують тривожність при виконанні дії.

Строки та результати

Оцінимо ваш проект за 1 робочий день. Отримайте консультацію — зв'яжіться з нами. Замовте проектування інтерфейсу під ключ: від досліджень до фінальних макетів.