pimenov.ai

UI Kit / документация

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

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

Открыть сайт

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

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

Как читать

Сначала идёт карта системы, потом семейства блоков, затем живые примеры. Если нужен ответ «где это уже используется», смотри строки «Где используется».

Статусы

Живой — блок уже участвует в публичном сайте. Черновик — используется только в лабораторных маршрутах. Справочно — старый или вспомогательный контур, не целевая основа системы.

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

Какие контуры уже живут на общих блоках

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

Контур

Справочные и старые маршруты

Справочно

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

База

Три базовых блока

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

База

Section

Живой

Что делает: Базовая обёртка секции: поверхность, градиент, разделение на две колонки и единый внешний ритм страницы.

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

База

SectionHeader

Живой

Что делает: Канонический заголовок секции: короткая метка, заголовок, пояснение и компактное действие.

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

База

CardsGrid

Живой

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

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

База на практике

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

Ниже не абстрактная схема, а тот ритм, из которого дальше собираются Обо мне, Работа со мной, Контакты, Политика, 404 и документационные страницы.

Section

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

SectionHeader

Держит язык заголовка: короткая метка, заголовок, пояснение и действие. Не размножаем новые варианты без необходимости.

CardsGrid

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

Списки и контент

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

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

Списки и контент

HorizontalCard

Живой

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

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

Списки и контент

ContentListSection

Живой

Что делает: Готовая оболочка для списка материалов: заголовок, действие и поток HorizontalCard.

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

Списки и кейсы

FeaturedCasesSection

Живой

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

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

Оболочка списка

CollectionShellBlock

Живой

Что делает: Стандартная оболочка страниц списков: метка, заголовок, подпись пагинации и список карточек.

Как использовать: Используй на страницах списков и пагинации, чтобы не собирать секцию результатов вручную.

Оболочка тега

TagPageHeaderBlock

Живой

Что делает: Заголовок страниц тегов: название тега, вводный текст, действие назад и чипы.

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

HorizontalCard / ContentListSection

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

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

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

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

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

Пример ContentListSection

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

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

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

Почему личный сайт — не визитка, а публичная система

Почему личный сайт — не визитка, а публичная система

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

Пример кейсов

Пример FeaturedCasesSection

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

Все кейсы

Призывы к действию

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

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

Призыв к действию

CtaBlock

Живой

Что делает: Главный переиспользуемый CTA для обзорных и черновых страниц: метка, заголовок, текст, основное и второе действие.

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

Завершение детальной страницы

DetailFooterStack

Живой

Что делает: Канонический финальный блок для детальных страниц: авторский CTA в стандартной обёртке без ручного финального блока на каждом маршруте.

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

Контентный CTA

BottomCtaSection

Живой

Что делает: Общая CTA-секция для контентных, теговых и детальных страниц с поддержкой форматированного текста и двух действий.

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

Блок CTA

Главный переиспользуемый CTA для обзорных и черновых страниц

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

Доказательства и FAQ

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

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

Доказательства и результат

ProofResultsBlock

Черновик

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

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

FAQ

FaqBlock

Черновик

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

Как использовать: Используй для коротких частых вопросов в черновых и сервисных секциях.

Доказательства и результат

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

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

одна страница

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

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

живой / черновик / справочно

Ясный статус

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

сначала переиспользование

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

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

Блок FAQ

Короткий FAQ о переиспользуемой системе

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

Чем UI Kit теперь отличается от черновых маршрутов?

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

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

База: Section, SectionHeader, CardsGrid. Поверх них — CtaBlock, оболочки списков, заголовки детальных страниц, семейство кейсов и другие общие блоки по задаче страницы.

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

Нет. Нужны канонические переиспользуемые блоки и реальные семейства сайта. Случайные одноразовые куски и старые справочные маршруты сюда тянуть не надо.

Кейсы и детальные страницы

Общие блоки для детальных страниц и кейсов

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

Детальная страница кейса

CaseHero

Живой

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

Как использовать: Используй как входной слой детальной страницы кейса, а не как декоративный первый экран.

Детальная страница кейса

CaseSection

Живой

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

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

Детальная страница кейса

CaseMetricCard / CaseBulletCard

Живой

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

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

Детальная страница кейса

RelatedCases

Живой

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

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

Заголовок детальной страницы

EditorialDetailHeader

Живой

Что делает: Общий заголовок для статей, блога и базы знаний: h1, лид, метаданные, чипы и опциональный связанный блок.

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

Черновые и справочные маршруты

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

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

Маршрут

/home-v2/

Черновик

Справочный черновик старого нового контура главной. После текущей итерации основная главная уже обновляется в `/`.

Маршрут

/services-v2/

Черновик

Справочный черновик старой упаковки услуг. Текущий публичный контур теперь развивается в `/services/`.

Маршрут

/preview/marketing-blocks/

Черновик

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

Маршрут

/preview/author-cta/

Черновик

Черновой просмотр канонического завершения детальных страниц через DetailFooterStack, без лишних вариантов и демонстрационного мусора.