Loading documentation...
Preparing Ring content
Концепции, ценность и типичные сценарии клонирования — меньше кода.
Концепции, ценность и типичные сценарии клонирования — меньше кода.
Preparing Ring content
Preparing Ring content
Preparing Ring content
Используйте вкладки Founder / Developer в боковой панели docs, чтобы фильтровать эту страницу. Общие разделы относятся к обеим аудиториям.
Статус: Layer1 chrome — это data manifest + закрытая карта иконок, а не варианты *-desktop-navigation.tsx на клон. Файла config/navigation.config.ts нет. Пакеты перезаписывают lib/navigation/primary-nav.ts. Клоны ремапят существующие id слотов в lib/navigation/primary-nav-overlay.ts. Неизвестные icon id рендерят глиф users.
| Прежняя привычка | Эквивалент в Ring |
|---|---|
Форкать vikka-desktop-navigation.tsx / greenfood-navigation.tsx | L2 пак перезаписывает lib/navigation/primary-nav.ts (слоты, hrefs, icon ids) |
| Импортировать вертикально-именованную Lucide-иконку в chrome | Добавить generic id в PRIMARY_NAV_ICONS на Layer1, затем ссылаться на этот id |
| Overlay новой mobile tab из клона | Overlay не может добавлять, скрывать или менять порядок слотов — меняйте манифест пака |
Копировать desktop-sidebar.tsx на клон | Держите chrome на Layer1; ремапьте только iconById / labelKeysById / hrefById |
home.preset не выбирает меню. Overflow-модули (каталог [...]) живут в lib/navigation/platform-menu.ts плюс ring-config.navigation.platformMenu. Пакеты не должны перезаписывать platform-menu.ts; вертикальные дефолты принадлежат в PACK.json.platformMenu и копируются на ring-config клона.
labelKeys). pack.json пака и overlay клона могут переопределять листья. См. Localization.hrefById на id этого слота (тот же контракт locale → string, что и у items пака).Не просите интегратора класть кастомный sidebar-компонент в components/navigation/ ради brand icons.
Нет. Уберите или замените слот в pack primary-nav.ts (compose overwrite). Overlay только патчит icon / labelKeys / href на id, которые уже существуют.
sun, прежде чем Layer1 его перечислит?getPrimaryNavIcon возвращает Users. Bar не падает; глиф неправильный, пока Layer1 не завезёт id.
Удалите форк. Направьте compose на pack primary-nav.ts + empty-or-remap primary-nav-overlay.ts. Файлы chrome остаются на Layer1.
platform-menu.ts?Layer1. Пакеты не должны rsync поверх него. Clone ring-config.navigation.platformMenu (items / exclude / extra) — это рычаг overflow-каталога.
Depends-on: L1 / L2 pack / L3 overlay compose and pack.json socket.
Same-workflow: nav labelKeys resolve through Layer1 → pack → overlay messages.
Prerequisite: chrome stays on Layer1; product stays on pack or clone overlay.
See-also: ring-config feature flags that hide routes from nav.
Используйте вкладки Founder / Developer в боковой панели docs, чтобы фильтровать эту страницу. Общие разделы относятся к обеим аудиториям.
Статус: Layer1 chrome — это data manifest + закрытая карта иконок, а не варианты *-desktop-navigation.tsx на клон. Файла config/navigation.config.ts нет. Пакеты перезаписывают lib/navigation/primary-nav.ts. Клоны ремапят существующие id слотов в lib/navigation/primary-nav-overlay.ts. Неизвестные icon id рендерят глиф users.
| Прежняя привычка | Эквивалент в Ring |
|---|---|
Форкать vikka-desktop-navigation.tsx / greenfood-navigation.tsx | L2 пак перезаписывает lib/navigation/primary-nav.ts (слоты, hrefs, icon ids) |
| Импортировать вертикально-именованную Lucide-иконку в chrome | Добавить generic id в PRIMARY_NAV_ICONS на Layer1, затем ссылаться на этот id |
| Overlay новой mobile tab из клона | Overlay не может добавлять, скрывать или менять порядок слотов — меняйте манифест пака |
Копировать desktop-sidebar.tsx на клон | Держите chrome на Layer1; ремапьте только iconById / labelKeysById / hrefById |
home.preset не выбирает меню. Overflow-модули (каталог [...]) живут в lib/navigation/platform-menu.ts плюс ring-config.navigation.platformMenu. Пакеты не должны перезаписывать platform-menu.ts; вертикальные дефолты принадлежат в PACK.json.platformMenu и копируются на ring-config клона.
labelKeys). pack.json пака и overlay клона могут переопределять листья. См. Localization.hrefById на id этого слота (тот же контракт locale → string, что и у items пака).Не просите интегратора класть кастомный sidebar-компонент в components/navigation/ ради brand icons.
Нет. Уберите или замените слот в pack primary-nav.ts (compose overwrite). Overlay только патчит icon / labelKeys / href на id, которые уже существуют.
sun, прежде чем Layer1 его перечислит?getPrimaryNavIcon возвращает Users. Bar не падает; глиф неправильный, пока Layer1 не завезёт id.
Удалите форк. Направьте compose на pack primary-nav.ts + empty-or-remap primary-nav-overlay.ts. Файлы chrome остаются на Layer1.
platform-menu.ts?Layer1. Пакеты не должны rsync поверх него. Clone ring-config.navigation.platformMenu (items / exclude / extra) — это рычаг overflow-каталога.
Depends-on: L1 / L2 pack / L3 overlay compose and pack.json socket.
Same-workflow: nav labelKeys resolve through Layer1 → pack → overlay messages.
Prerequisite: chrome stays on Layer1; product stays on pack or clone overlay.
See-also: ring-config feature flags that hide routes from nav.
Используйте вкладки Founder / Developer в боковой панели docs, чтобы фильтровать эту страницу. Общие разделы относятся к обеим аудиториям.
Статус: Layer1 chrome — это data manifest + закрытая карта иконок, а не варианты *-desktop-navigation.tsx на клон. Файла config/navigation.config.ts нет. Пакеты перезаписывают lib/navigation/primary-nav.ts. Клоны ремапят существующие id слотов в lib/navigation/primary-nav-overlay.ts. Неизвестные icon id рендерят глиф users.
| Прежняя привычка | Эквивалент в Ring |
|---|---|
Форкать vikka-desktop-navigation.tsx / greenfood-navigation.tsx | L2 пак перезаписывает lib/navigation/primary-nav.ts (слоты, hrefs, icon ids) |
| Импортировать вертикально-именованную Lucide-иконку в chrome | Добавить generic id в PRIMARY_NAV_ICONS на Layer1, затем ссылаться на этот id |
| Overlay новой mobile tab из клона | Overlay не может добавлять, скрывать или менять порядок слотов — меняйте манифест пака |
Копировать desktop-sidebar.tsx на клон | Держите chrome на Layer1; ремапьте только iconById / labelKeysById / hrefById |
home.preset не выбирает меню. Overflow-модули (каталог [...]) живут в lib/navigation/platform-menu.ts плюс ring-config.navigation.platformMenu. Пакеты не должны перезаписывать platform-menu.ts; вертикальные дефолты принадлежат в PACK.json.platformMenu и копируются на ring-config клона.
labelKeys). pack.json пака и overlay клона могут переопределять листья. См. Localization.hrefById на id этого слота (тот же контракт locale → string, что и у items пака).Не просите интегратора класть кастомный sidebar-компонент в components/navigation/ ради brand icons.
Нет. Уберите или замените слот в pack primary-nav.ts (compose overwrite). Overlay только патчит icon / labelKeys / href на id, которые уже существуют.
sun, прежде чем Layer1 его перечислит?getPrimaryNavIcon возвращает Users. Bar не падает; глиф неправильный, пока Layer1 не завезёт id.
Удалите форк. Направьте compose на pack primary-nav.ts + empty-or-remap primary-nav-overlay.ts. Файлы chrome остаются на Layer1.
platform-menu.ts?Layer1. Пакеты не должны rsync поверх него. Clone ring-config.navigation.platformMenu (items / exclude / extra) — это рычаг overflow-каталога.
Depends-on: L1 / L2 pack / L3 overlay compose and pack.json socket.
Same-workflow: nav labelKeys resolve through Layer1 → pack → overlay messages.
Prerequisite: chrome stays on Layer1; product stays on pack or clone overlay.
See-also: ring-config feature flags that hide routes from nav.
shopping-basket | ShoppingBasket |
shopping-bag | ShoppingBag |
building | Building2 |
newspaper | Newspaper |
tv | Tv |
sparkles | Sparkles |
gamepad | Gamepad2 |
hexagon | Hexagon |
map | Map |
layout-grid | LayoutGrid |
wallet | Wallet |
bell | Bell |
heart | Heart |
shopping-cart | ShoppingCart |
message-circle | MessageCircle |
list-todo | ListTodo |
settings | Settings |
sun | Sun |
orbit | Orbit |
calendar | Calendar |
scale | Scale |
hash | Hash |
type | Type |
moon | Moon |
compass | Compass |
Добавьте generic глиф сюда, прежде чем пак или overlay сошлётся на новый id. Не накладывайте этот файл иконками с именами клона.
Layer1 поставляет export const PRIMARY_NAV_OVERLAY = {} в lib/navigation/primary-nav-overlay.ts, чтобы webpack всегда резолвил импорт. Клон перезаписывает этот файл (не primary-nav.ts) так:
getPrimaryNavManifest() прогоняет BASE_MANIFEST через applyHrefOverlay / applyMobileOverlay. Id, которых нет в манифесте пака/L1, игнорируются.
components/navigation/bottom-navigation.tsx рендерит navItems.slice(0, 2), затем center add control, затем navItems.slice(2). Компоненты иконок берутся из getPrimaryNavIcon. Desktop rail: sidebar-rail.tsx и sidebar-synced-layout.tsx используют тот же helper.
Оркестратор: components/navigation/navigation.tsx динамически импортирует desktop-sidebar.tsx и bottom-navigation.tsx. Публичного реестра вариантов DesktopNavigation нет.
Нужен новый глиф? Сначала зафиксируйте его на Layer1 (ring/web/lib/navigation/primary-nav-icons.ts), затем укажите id в слоте пака. Cursor skill layer2-preset-operator владеет pack primary-nav.ts; ringization-implementer владеет L3 overlay remap. Никто не должен копировать chrome.
Стартовый промпт (ничего не меняет, пока вы не одобрите):
Add generic Lucide id
<id>to Layer1lib/navigation/primary-nav-icons.tsbefore pack<pack>references it. Do not import vertical-named icons in chrome. Overlay may only remap existing slot ids inprimary-nav-overlay.ts.
Подтвердите, что id слота существует в составленном манифесте primary-nav.ts (массивы mobile / desktop). Overlay не может изобретать id.
Если icon id отсутствует в PRIMARY_NAV_ICONS, добавьте Lucide-импорт и запись карты на Layer1. Неизвестные id тихо падают обратно на users.
Установите icon на слоте пака или PRIMARY_NAV_OVERLAY.iconById[slotId] на клоне. Держите platform-menu.ts на Layer1; вертикальные overflow-дефолты кладите в PACK.json.platformMenu.
Next-step: locale env used by href builders and next-intl.
shopping-basket | ShoppingBasket |
shopping-bag | ShoppingBag |
building | Building2 |
newspaper | Newspaper |
tv | Tv |
sparkles | Sparkles |
gamepad | Gamepad2 |
hexagon | Hexagon |
map | Map |
layout-grid | LayoutGrid |
wallet | Wallet |
bell | Bell |
heart | Heart |
shopping-cart | ShoppingCart |
message-circle | MessageCircle |
list-todo | ListTodo |
settings | Settings |
sun | Sun |
orbit | Orbit |
calendar | Calendar |
scale | Scale |
hash | Hash |
type | Type |
moon | Moon |
compass | Compass |
Добавьте generic глиф сюда, прежде чем пак или overlay сошлётся на новый id. Не накладывайте этот файл иконками с именами клона.
Layer1 поставляет export const PRIMARY_NAV_OVERLAY = {} в lib/navigation/primary-nav-overlay.ts, чтобы webpack всегда резолвил импорт. Клон перезаписывает этот файл (не primary-nav.ts) так:
getPrimaryNavManifest() прогоняет BASE_MANIFEST через applyHrefOverlay / applyMobileOverlay. Id, которых нет в манифесте пака/L1, игнорируются.
components/navigation/bottom-navigation.tsx рендерит navItems.slice(0, 2), затем center add control, затем navItems.slice(2). Компоненты иконок берутся из getPrimaryNavIcon. Desktop rail: sidebar-rail.tsx и sidebar-synced-layout.tsx используют тот же helper.
Оркестратор: components/navigation/navigation.tsx динамически импортирует desktop-sidebar.tsx и bottom-navigation.tsx. Публичного реестра вариантов DesktopNavigation нет.
Нужен новый глиф? Сначала зафиксируйте его на Layer1 (ring/web/lib/navigation/primary-nav-icons.ts), затем укажите id в слоте пака. Cursor skill layer2-preset-operator владеет pack primary-nav.ts; ringization-implementer владеет L3 overlay remap. Никто не должен копировать chrome.
Стартовый промпт (ничего не меняет, пока вы не одобрите):
Add generic Lucide id
<id>to Layer1lib/navigation/primary-nav-icons.tsbefore pack<pack>references it. Do not import vertical-named icons in chrome. Overlay may only remap existing slot ids inprimary-nav-overlay.ts.
Подтвердите, что id слота существует в составленном манифесте primary-nav.ts (массивы mobile / desktop). Overlay не может изобретать id.
Если icon id отсутствует в PRIMARY_NAV_ICONS, добавьте Lucide-импорт и запись карты на Layer1. Неизвестные id тихо падают обратно на users.
Установите icon на слоте пака или PRIMARY_NAV_OVERLAY.iconById[slotId] на клоне. Держите platform-menu.ts на Layer1; вертикальные overflow-дефолты кладите в PACK.json.platformMenu.
Next-step: locale env used by href builders and next-intl.
shopping-basket | ShoppingBasket |
shopping-bag | ShoppingBag |
building | Building2 |
newspaper | Newspaper |
tv | Tv |
sparkles | Sparkles |
gamepad | Gamepad2 |
hexagon | Hexagon |
map | Map |
layout-grid | LayoutGrid |
wallet | Wallet |
bell | Bell |
heart | Heart |
shopping-cart | ShoppingCart |
message-circle | MessageCircle |
list-todo | ListTodo |
settings | Settings |
sun | Sun |
orbit | Orbit |
calendar | Calendar |
scale | Scale |
hash | Hash |
type | Type |
moon | Moon |
compass | Compass |
Добавьте generic глиф сюда, прежде чем пак или overlay сошлётся на новый id. Не накладывайте этот файл иконками с именами клона.
Layer1 поставляет export const PRIMARY_NAV_OVERLAY = {} в lib/navigation/primary-nav-overlay.ts, чтобы webpack всегда резолвил импорт. Клон перезаписывает этот файл (не primary-nav.ts) так:
getPrimaryNavManifest() прогоняет BASE_MANIFEST через applyHrefOverlay / applyMobileOverlay. Id, которых нет в манифесте пака/L1, игнорируются.
components/navigation/bottom-navigation.tsx рендерит navItems.slice(0, 2), затем center add control, затем navItems.slice(2). Компоненты иконок берутся из getPrimaryNavIcon. Desktop rail: sidebar-rail.tsx и sidebar-synced-layout.tsx используют тот же helper.
Оркестратор: components/navigation/navigation.tsx динамически импортирует desktop-sidebar.tsx и bottom-navigation.tsx. Публичного реестра вариантов DesktopNavigation нет.
Нужен новый глиф? Сначала зафиксируйте его на Layer1 (ring/web/lib/navigation/primary-nav-icons.ts), затем укажите id в слоте пака. Cursor skill layer2-preset-operator владеет pack primary-nav.ts; ringization-implementer владеет L3 overlay remap. Никто не должен копировать chrome.
Стартовый промпт (ничего не меняет, пока вы не одобрите):
Add generic Lucide id
<id>to Layer1lib/navigation/primary-nav-icons.tsbefore pack<pack>references it. Do not import vertical-named icons in chrome. Overlay may only remap existing slot ids inprimary-nav-overlay.ts.
Подтвердите, что id слота существует в составленном манифесте primary-nav.ts (массивы mobile / desktop). Overlay не может изобретать id.
Если icon id отсутствует в PRIMARY_NAV_ICONS, добавьте Lucide-импорт и запись карты на Layer1. Неизвестные id тихо падают обратно на users.
Установите icon на слоте пака или PRIMARY_NAV_OVERLAY.iconById[slotId] на клоне. Держите platform-menu.ts на Layer1; вертикальные overflow-дефолты кладите в PACK.json.platformMenu.
Next-step: locale env used by href builders and next-intl.