RepUI Workbench

REPUI ROADMAP

Компоненты RepUI

Направление развития серверной UI-библиотеки для Django и HTMX. Roadmap отражает готовность контрактов, доступность, темизацию и применимость.

Базовая система готова HTMX-first Без обязательного SPA Django-native Без React runtime
Порядок не является обещанием сроков. Компонент считается готовым после проверки HTML-контракта, клавиатуры, доступности, light/dark-тем и поведения после HTMX-перерендера.

На что ориентируется RepUI

Четыре принципа, которые определяют API и критерии готовности компонентов.

Server-first

Сервер формирует HTML, Django остаётся источником состояния, а JavaScript усиливает интерфейс.

HTMX-friendly

Компоненты должны переживать swap, повторный mount и частичное обновление без утечек runtime.

Нативная семантика

HTML, фокус, клавиатура и браузерные состояния остаются основой поведения, а не обходным путём.

Token-driven

Компоненты читают semantic tokens и поддерживают официальные темы без жёстко зашитых цветов.

Текущее состояние

Что уже можно использовать и что сейчас проходит стабилизацию контрактов.

Основной набор

Уже используется в Workbench и прикладных композициях.

Actions и содержимое

Используется
  • Button, Icon, IconButton
  • Badge, Chip
  • Typography, InlineCode, Divider

Layout и surfaces

  • Page, Stack, Grid, Container
  • Card, Panel
  • Hero, Theme Preview

Navigation и collections

  • List, ListItemButton, Listbox
  • Menu, Menubar, Navbar
  • Tabs, Pagination, Tree

Интерактивные компоненты

Работают, но их контракты ещё укрепляются тестами и реальными интеграциями.

Формы и поиск

Стабилизация
  • Choice, Select
  • Autocomplete, Search
  • Combobox — серверная фильтрация в развитии

Overlay и feedback

  • Dialog, Drawer, Sheet, Popover
  • Tooltip, Toast, Alert
  • OverlayPortal, DismissLayer

Общие механики

  • Roving focus и keyboard ownership
  • Theme engine и portal context
  • HTMX lifecycle и destroy

Следующие этапы

01

Укрепить существующие контракты

Сейчас

Клавиатура, HTMX lifecycle, portal context и baseline-проверки официальных тем.

02

Закрыть базовые формы

Следующее

TextField, Textarea, FormControl, RadioGroup, Switch и FieldError.

03

Loading и feedback

Запланировано

Spinner, Progress, Skeleton и loading-состояния форм при HTMX submit.

04

Данные и навигация

По потребности

Table, Breadcrumbs, Accordion, EmptyState и DataList.

05

Специализированные компоненты

Не приоритет

Slider, Rating, Stepper, Timeline и сложные data-grid сценарии.

Когда компонент считается готовым

Готовность — это проверяемый контракт, а не только наличие шаблона.

  • минимальный HTML и нативная семантика;
  • мышь, touch и клавиатура;
  • light/dark во всех официальных темах;
  • disabled, focus, error и loading;
  • повторный mount после HTMX swap;
  • валидация Django tag API;
  • тесты и Workbench-страница;
  • нет hardcoded цветов и layout overrides темы.
RepUI не стремится копировать каталоги MUI, Ant Design, Bootstrap или Chakra UI. Это серверная Django-библиотека: React и обязательный клиентский runtime не входят в её архитектуру. Новый компонент появляется, когда у него есть реальный серверный сценарий и устойчивый контракт.