UrFU UI-Kit React

Публичная библиотека React-компонентов (v1.9.0) для экосистемы UrFU.

Стек: React 18, TypeScript, Vite, LESS, Storybook, VitePress.

🚀 Для пользователей библиотеки

Установка

npm install urfu-ui-kit-react

Базовая настройка

Импортируйте стили в корень приложения:

import "urfu-ui-kit-react/dist/style.css"

Использование компонента

import { Button, InputText, Select } from "urfu-ui-kit-react";

export function App() {
  return (
    <>
      <Button>Кнопка</Button>
      <InputText title="Имя" />
      <Select 
        title="Выбор" 
        options={[
          { value: '1', label: 'Опция 1' },
          { value: '2', label: 'Опция 2' }
        ]} 
      />
    </>
  );
}

Полная документация всех компонентов: https://uikit.my1.urfu.ru

👨‍💻 Для разработчиков библиотеки

Первичная настройка

# Установить зависимости
npm install

# Запустить Storybook (примеры компонентов)
npm run sb

# Запустить VitePress (документация)
npm run vp

# Запустить оба одновременно
npm run docs

Разработка

# Собрать библиотеку
npm run build

# Запустить линтер
npm run lint

# Собрать VitePress документацию
npm run vpb

Версионирование и публикация

1. Обновить версию в package.json
2. Добавить запись в docs/versioning.md
3. Обновить документацию затронутых компонентов
4. Запустить линтер и сборку
5. Опубликовать:

npm run pub

Важно: это публичная библиотека; все изменения API ломают потребителей (meetings, youth-science, kpis-npr). Избегайте breaking changes без координации.

📚 Компоненты

Форма и ввод

InputText, InputNumber, InputFile, InputExpandTextarea, Textarea, Select, SearchSelect, Multiselect, Checkbox, Radio, Search, Calendar, InputTime

Навигация

Menu, Tabs, Accordion, BreadCrumbs, TreeView

Отображение

Table, Status, Icon, Message, Preloader, Card, StickyActionBar

Взаимодействие

Button, Modal, Tooltip, Notification, Switch

📋 Требования

• React ^18.0.0
• React DOM ^18.0.0
• TypeScript ^5.2

📝 История версий

v1.9.0 (2026-05-25)

• Pagination: исправлено выравнивание на десктопе и мобильных устройствах

v1.8.7 и ранее — см. docs/versioning.md

🤝 Вопросы и обратная связь

• Документация: https://uikit.my1.urfu.ru
• Форма обратной связи: https://lk-form.my1.urfu.ru/uikit-feedback/submit