UI Kit / documentation hub

Reusable blocks: что делает каждый блок, где используется и как его применять

Это уже не demo-полигон. Это рабочая карта системы pimenov.ai: foundation primitives, shared families, preview-маршруты и реальные live usage points.

Открыть сайт

Что это за страница

Не полигон и не свалка примеров. Это карта reusable-системы pimenov.ai: какой блок за что отвечает, где уже используется и где остаётся preview/reference.

Как читать

Сначала идёт карта системы, потом block families, затем живые примеры. Если нужен ответ “где это уже используется”, смотри строки “Где используется”.

Статусы

Live — блок уже участвует в публичном сайте. Preview — используется только в лабораторных/демо-маршрутах. Reference — старый или вспомогательный контур, не целевая основа системы.

Карта системы

Какие контуры уже живут на reusable blocks

Смотри сюда первым делом, если нужно быстро понять состояние системы: что уже live, что остаётся preview и что пока только reference.

Контур

Reference / legacy

Reference

Старые или промежуточные страницы, которые можно использовать как reference, но не как целевой канон новой системы.

Foundation

Три базовых primitives

Если непонятно, с чего собирать новую страницу — начинать нужно отсюда. Большая часть публичного сайта уже строится на этих трёх блоках.

Foundation

Section

Live

Что делает: Базовая обёртка секции: surface, gradient, split-layout и единый внешний ритм страницы.

Как использовать: Используй, когда нужен самостоятельный смысловой блок страницы, а не просто div с отступами.

Foundation

SectionHeader

Live

Что делает: Канонический heading-pattern: kicker, title, text и compact action slot.

Как использовать: Используй для всех section headers, чтобы не собирать руками новый паттерн заголовка на каждой странице.

Foundation

CardsGrid

Live

Что делает: Минимальная responsive-сетка 2→3 колонки для explanatory cards и feature-блоков.

Как использовать: Используй, когда нужен карточечный explanatory layout без отдельной сложной grid-системы.

Foundation in practice

Как foundation собирается в реальную обзорную секцию

Ниже — не абстрактная схема, а тот ритм, из которого дальше собираются about/services/contact/privacy/not-found и documentation pages.

Section

Даёт surface и ритм. Не используем случайные ручные wrapper’ы, если это уже полноценная секция страницы.

SectionHeader

Держит heading-language: kicker, title, text и action. Не размножаем новые варианты заголовка без необходимости.

CardsGrid

Когда нужно объяснять мысль несколькими карточками — сначала пробуем CardsGrid, а не придумываем новый layout primitive.

List / content family

Блоки списков, подборок и теговых оболочек

Эти блоки собирают list/tag layers сайта: статьи, блог, база знаний, услуги и переходы по коллекциям материалов. Сначала — карта family, ниже — живые примеры реальных list-паттернов.

List / content

HorizontalCard

Live

Что делает: Базовая карточка для материалов и услуг в list-потоке.

Как использовать: Используй в контентных списках, когда важен спокойный вертикальный ритм с divider между карточками.

List / content

ContentListSection

Live

Что делает: Готовая оболочка для списка материалов: head + action + поток HorizontalCard.

Как использовать: Используй там, где нужен готовый контентный list-shell без ручной сборки header/list/empty state.

List / cases

FeaturedCasesSection

Live

Что делает: Секция с кейсами в виде компактной карточечной сетки и action на список кейсов.

Как использовать: Используй, когда кейсы нужны как proof-layer или быстрый вход в реальные проекты.

List / shell

CollectionShellBlock

Live

Что делает: Стандартный shell для list pages: kicker + title + pagination label + card list.

Как использовать: Используй на list/pagination страницах, чтобы не собирать result-section руками.

Tag / shell

TagPageHeaderBlock

Live

Что делает: Header для tag pages: титул тега, вводный текст, back action и chips.

Как использовать: Используй на tag routes, где нужен единый верхний контур и навигация между тегами.

HorizontalCard / ContentListSection

Так выглядит реальный list-pattern, а не абстрактная вертикальная карточка

Если блок называется HorizontalCard, его надо видеть в живом горизонтальном ритме. Ниже — один одиночный preview и затем короткая секция ContentListSection.

Notion как headless CMS для сайта

Notion как headless CMS для сайта

Пример того, как HorizontalCard ведёт себя в реальном контентном списке: картинка, текст, ссылка и спокойный вертикальный ритм.

Пример ContentListSection

Открыть блог
Notion как headless CMS для сайта

Notion как headless CMS для сайта

Пример того, как HorizontalCard ведёт себя в реальном контентном списке: картинка, текст, ссылка и спокойный вертикальный ритм.

Почему личный сайт — не визитка, а public system

Почему личный сайт — не визитка, а public system

Второй пример нужен не ради контента, а чтобы сразу видеть живой list-pattern вместо абстрактной карточки-описания.

Cases preview

Пример FeaturedCasesSection

Этот блок нужен, когда кейсы используются как proof-layer и быстрый вход в реальные проекты.

Все кейсы

CTA family

Чем заканчиваются страницы и куда ведут дальше

Это важный слой системы: после обзора, списка или detail-страницы пользователь должен понимать следующий шаг без ручных одноразовых решений.

CTA

CtaBlock

Live

Что делает: Главный reusable CTA для обзорных и preview-страниц: kicker, title, text, primary/secondary action.

Как использовать: Используй как финальный следующий шаг, когда после секции нужен один понятный переход без hero-логики.

CTA / detail

DetailFooterStack

Live

Что делает: Канонический footer-pattern для detail pages: author CTA в стандартной обёртке без ручного финального блока на каждом маршруте.

Как использовать: Используй, когда article/blog/knowledge/service detail должен заканчиваться единым contact-footer, а не одноразовым хвостом.

CTA / content

BottomCtaSection

Live

Что делает: Shared CTA section для content/tag/detail страниц с поддержкой rich text и двух действий.

Как использовать: Используй в list/tag/detail layers, когда нужен не авторский CTA, а более спокойный навигационный следующий шаг.

CTA block

Главный reusable CTA для overview и preview-страниц

Используй, когда нужен один явный следующий шаг и опциональный secondary route. Для detail pages ниже показан реальный footer-pattern, который уже живёт на сайте.

Proof / FAQ family

Компактные блоки доверия и пояснений

Это не про весь public-site, а про reusable baseline для preview и будущих точечных product/service sections.

Proof / result

ProofResultsBlock

Preview

Что делает: Компактный блок доказательств/результатов на 2–3 карточки поверх foundation primitives.

Как использовать: Используй там, где нужен быстрый proof-layer без полного case-study.

FAQ

FaqBlock

Preview

Что делает: Консервативный FAQ на native details/summary без клиентского JS.

Как использовать: Используй для коротких частых вопросов в preview/service-like sections.

Proof / Results block

Как этот family используется в UI Kit

Сверху ты читаешь описание блока, ниже видишь его живой baseline-пример на тех же самых primitives.

1 page

Карта системы

На этой странице должно быть видно, какой блок за что отвечает и где уже живёт на сайте.

live / preview / reference

Ясный статус

У каждого маршрута и блока должен быть понятный статус использования, чтобы не путать showcase и боевой контур.

reuse-first

Документация через саму систему

UI Kit сам должен быть собран на reusable blocks, а не только рассказывать про них словами.

FAQ block

Короткий FAQ о reusable system

Если надо быстро объяснить рамку системы, а не писать длинную справку — этот блок закрывает задачу спокойно и предсказуемо.

Чем UI Kit теперь отличается от preview?

Preview показывает отдельные эксперименты безопасно и изолированно. UI Kit — это уже documentation hub: карта системы, блоков, статусов и примеров использования.

Что считать каноном для новых страниц?

Foundation: Section, SectionHeader, CardsGrid. Поверх них — CtaBlock, list shells, detail headers, case family и другие shared blocks по задаче страницы.

Нужно ли тащить в UI Kit абсолютно всё?

Нет. Нужны канонические reusable blocks и реальные families сайта. Случайные одноразовые куски и legacy-reference сюда тянуть не надо.

Case / detail family

Shared blocks для detail pages и кейсов

Это слой, который делает detail-страницы сайта едиными: case-story, shared header, related blocks и завершение без ручных хвостов.

Case detail

CaseHero

Live

Что делает: Первый экран кейса: контекст, headline, actions и при необходимости ссылка на исходную статью.

Как использовать: Используй как entry layer для case detail page, а не как декоративный hero.

Case detail

CaseSection

Live

Что делает: Канонический смысловой section внутри кейса: eyebrow, title, intro и свободный слот под содержимое.

Как использовать: Используй для narrative-слоя case pages вместо ручного section-wrapper.

Case detail

CaseMetricCard / CaseBulletCard

Live

Что делает: Малые блоки для метрик, фактов и кратких тезисов внутри кейсовых секций.

Как использовать: Используй, когда кейсу нужно объяснять прогресс, контекст и выводы небольшими атомарными блоками.

Case detail

RelatedCases

Live

Что делает: Завершающий блок с переходом в соседние кейсы и route back на общий список кейсов.

Как использовать: Используй внизу case detail, когда нужен понятный переход в соседние разборы.

Detail header

EditorialDetailHeader

Live

Что делает: Shared header для статей, блога и базы знаний: h1, standfirst, meta line, chips и optional related block.

Как использовать: Используй для text/detail pages вместо отдельного hero на каждый тип материала.

Preview / reference routes

Куда смотреть, если нужен не live, а лабораторный контур

Это отдельные маршруты для разработки новой упаковки сайта. Их важно держать как документационную часть системы, но не путать с текущим public-site.

Route

/home-v2/

Preview

Новый home-contour, собранный как product/offer system на reusable sections.

Route

/preview/marketing-blocks/

Preview

Изолированный preview-контур для CTA / Proof / FAQ families: удобно проверять блоки отдельно, не раздувая сам UI Kit.

Route

/preview/author-cta/

Preview

Preview канонического detail-footer pattern через DetailFooterStack — без лишних variant-веток и showcase-мусора.

Route

/home-old/

Reference

Старый reference-контур главной. Не цель новой системы, а архивная точка сравнения.