Skip to content

Self-hosted house planner: true-scale 2D floor plan, 3D, satellite map overlay, sewer, electrical, water and underfloor heating with calculations, priced bill of materials. React + PHP, no database. By the team behind homedesignsai.pro

5.2 KB
Raw Blame

Общий дизайн: токены и примитивы

Весь интерфейс (план, 3D, карта, смета, «Участок и дом») собирается из одних токенов и одних примитивов. Своих цветов, теней, радиусов и своих кнопок в разделах не заводим: нужен новый вариант — добавляем его в примитив или токен, а не копию в своём CSS. CSS пишется без комментариев.

Токены — src/styles/tokens.css

Подключены глобально в src/main.tsx (вместе с src/styles/ui.css), в разделах импортировать не нужно, просто пользоваться var(--…).

группа переменные
фон и поверхности --bg (фон приложения), --surface (карточки), --surface-2 (ховер), --surface-3 (подложка сегментов)
текст --ink, --ink-2, --muted
линии --line, --line-strong
акцент --accent, --accent-hover, --accent-soft, --accent-ink
статусы --ok/--ok-soft, --warn/--warn-soft, --danger/--danger-soft
радиусы --radius-xs 6, --radius-sm 9, --radius 12, --radius-lg 16, --radius-pill
тени --shadow-sm, --shadow, --shadow-lg
отступы --space-1…--space-6 = 4, 8, 12, 16, 24, 32
шрифт --font, --font-mono, --text-xs 11, --text-sm 12.5, --text-md 14, --text-lg 17, --text-xl 22
контролы --control-h-sm 28, --control-h 32, --control-h-lg 38
раскладка --header-h 52 (шапка), --header-top, --chrome-top (верх для плавающих панелей под шапкой), --chrome-left, --z-chrome, --z-popover

Тема одна, светлая. Шапка приложения плавающая: полноэкранный раздел (3D, карта) рисует холст на всю вкладку, а свои панели ставит не выше var(--chrome-top).

Примитивы — src/ui/

Импорт из src/ui (barrel src/ui/index.ts): import { Button, Panel, Table, Th, Td } from '../ui'.

компонент пропсы для чего
Button variant: default | primary | ghost | danger, size: sm | md, pressed, icon, остальное как у <button> любые кнопки; primary — одна главная на экран
IconButton label (обязателен, идёт в title/aria-label), active, size, children — svg иконочные кнопки на тулбарах
Segmented options: {value,label,href?,title?}[], value, onChange, size переключатели режимов; с href — ссылки (так сделаны вкладки шапки)
Card padded (по умолчанию true), ref белая карточка с тенью
Panel title, eyebrow, actions, footer, ref карточка с шапкой и прокручиваемым телом
Badge tone: neutral | accent | ok | warn | danger статусы и счётчики
Input label, suffix (ед. изм.), size, invalid, ref, остальное как у <input> поля ввода и числа
Checkbox label, checked, onChange(checked: boolean) галочки (куплено и т. п.)
Table, Th, Td, Tr Table dense, Th/Td num (числа вправо, моноширинные цифры), Tr muted таблицы; шапка липкая
CanvasToolbar, ToolbarSeparator placement: top-left | top-right | top-center | bottom-*, direction: row | column плавающий тулбар поверх холста/3D/карты, сам встаёт под шапку
Menu, MenuItem, MenuSection Menu trigger={({open,toggle}) => …} width align, children — узлы или (close) => узлы; MenuItem hint; MenuSection title выпадающие меню (так сделано «⋯» в шапке)
cx cx('a', cond && 'b') склейка классов

Служебные классы из ui.css: .eyebrow (мелкий заголовок капсом), .muted (серый текст), .num (число вправо).

Навигация

Разделы переключаются только в шапке, адрес раздела — hash: #/plan, #/3d, #/map, #/estimate, #/info. Список — src/ui/useSection.ts. Раздел монтируется лениво из src/<раздел>/index.tsx (default export) и получает plan из стора, редактируемые разделы ещё onChange(nextPlan) — это та же запись, что и в редакторе: с отменой (⌘Z) и автосохранением на сервер. Экспорт/импорт JSON, сброс к исходному и версии — в меню «⋯» справа в шапке.