Руководство по кастомизации

Оценка времени: 1–4 часа на брендинг + feature toggles. Требования: локально выполнен Quick Start.

Клоны Ring разделяют одну кодовую базу (ring-platform.org). Кастомизация — config-first (пресеты ring-config.json, env, локали). Вертикальные ниши поставляются как in-repo presets — не форкайте niche TypeScript в клон. См. Vertical presets.

Карта кастомизации

Where white-label settings live

1. `ring-config.json` (install-time SSOT)

Создаётся ./install.sh или копируется из ring-config.template.json. На runtime мержится с шаблоном в lib/ring-config-core.ts (также доступен server-side через lib/ring-config.ts).

Идентичность клона

json


{
  "clone": {
    "name": "my-ring-clone",
    "displayName": "My Platform",
    "description": "Regional opportunities network",
    "organization": "Your Org",
    "contactEmail": "contact@example.com"
  },
  "domains": {
    "production": "https://example.com",
    "development": "http://localhost:3000"
  },
  "platform": {
    "baseUrl": "https://example.com"
  }
}

Используется для SEO (lib/seo-metadata.ts), JSON-LD и getSiteBaseUrl().

Vertical presets (предпочтительнее code forks)

json


{
  "entities": { "preset": "platform" },
  "productFields": { "preset": "platform" },
  "productBadges": { "preset": "platform" }
}

Клоны в стиле Agricultural / GreenFood используют "agricultural" для всех трёх. Полный реестр: Vertical presets.

Блок branding

branding.logo, branding.colors, branding.darkColors, branding.fonts в шаблоне — положите ассеты в public/images/ (см. пути в шаблоне).

Опциональные env overrides (lib/site-branding.ts):

Feature flags

Включайте и выключайте модули без удаления кода:

Проверки на сервере: isFeatureEnabled() в lib/ring-config-core.ts и whitelabel/features.ts. При отключении фич убирайте маршруты из навигации.

Matcher defaults

Install-time пороги AI matcher живут под matcher в ring-config.json (getMatcherInstallDefaults()). Runtime DB overlay может применяться для production rings — см. AI customization.

Метаданные sidebar и navigation

sidebar и navigation.links в ring-config.json питают публичный instance config (getPublicInstanceConfig()). Основной chrome реализован в:

components/navigation/navigation.tsx
components/navigation/desktop-sidebar.tsx
components/navigation/bottom-navigation.tsx

Для кастомного варианта desktop nav следуйте Whitelabel navigation.

2. Главная страница (заменяет устаревший portal)

Layer	File	Role
Route	`app/(public)/[locale]/page.tsx`	Static metadata + рендер `HomeWrapper`
Layout shell	`components/wrappers/home-wrapper.tsx`	Responsive grid, right rail, session-aware chrome
Hero body	`components/common/pages/home.tsx`	DaVinci hero, CTA, feature rotator
Copy	`locales/{locale}/pages.json` → `home`	Primary hero title, subtitle, features[], строки right-rail

Не настраивайте отдельное приложение «portal» или lib/portal-config.ts — этот путь устарел. Маркетинговая главная всегда HomeWrapper на /.

Кастомизация hero copy (самый быстрый путь)

Отредактируйте locales/en/pages.json (зеркала uk, ru):

HomeContent читает через useTranslations('pages.home').

Кастомизация layout главной

Right rail (OSS marketplace / CTA Ringdom): HomeRightRail внутри home-wrapper.tsx, строки в pages.home.rightRail
Глубже UX — форкните home-wrapper.tsx или home.tsx; добавьте пути в .reggie-propagate-exclude.json

Блок hero в ring-config.json остаётся для клонов, которые читают его в другом месте; flagship home hero ведётся через i18n, как выше.

3. Интернационализация

SSOT: lib/locale-config.ts
Messages: locales/{locale}/**/*.json, загружает lib/i18n.ts
Routing: @/i18n/routing — никогда не снимайте locale prefixes вручную в client code

Полное руководство: Localization.

Защищённые locale-файлы (overlay deltas) перечислены в .reggie-propagate-exclude.json — обычно только locales/*/config.json, vendor.json.

4. Тема и визуальная полировка

Ring использует Tailwind 4 с CSS-переменными для light/dark (next-themes).

Задайте branding.colors / darkColors в ring-config.json (шаблон документирует ключи, выровненные с токенами shadcn)
Замените public/favicon.ico, public/images/logo-*.svg, apple-touch-icon.png
Тема по умолчанию: ring-config.json → "theme": { "default": "system" }

Избегайте правки сгенерированных design tokens в чужих клонах — предпочитайте ring-config + env brand overrides.

5. Payments и store (уровень клона)

PaymentConductor processors: env vars — Payment integration
Валюта / налог store: features.store в ring-config.json
WayForPay / Stripe: никогда не коммитьте секреты; в production используйте k8s secrets

6. Web3 и токены (опционально)

Адреса контрактов и treasury: env + Token economics. Задайте tokens.native в ring-config.json для display metadata.

7. Propagation Reggie — только thin overlay

Источник истины: всегда propagate из ring-platform.org. Exclude защищает brand/locale overlay — не vertical code.

Файл: .reggie-propagate-exclude.json в корне репозитория. Не исключайте niche fields, entity catalogs или форки home-wrapper — выбирайте presets. Подробности: Vertical presets.

8. Чеклист проверки

Branding — logo, favicon, NEXT_PUBLIC_BRAND_NAME, OG image на share previews
Home — hero на / совпадает с pages.home в каждой поддерживаемой локали
Presets — entities / productFields / productBadges соответствуют вертикали
Features — отключённые модули отдают 404 или скрыты из nav; нет мёртвых ссылок в sidebar
Auth — login/logout, role-gated admin на /admin
Build — чистый npm run build; smoke-тесты, если включены payments

Следующие шаги

Vertical presets

Ниши живут в platform; выбор через ring-config

Database selection

DB_BACKEND_MODE и стратегия миграций

Payment integration

WayForPay, Stripe, webhooks

AI customization

Тюнинг matcher и стоимость агентов

Дисциплина форка: сначала config + локали, затем форки компонентов, exclusions перед propagation. Клон должен апгрейдиться без merge wars.

Руководство по кастомизации

Оценка времени: 1–4 часа на брендинг + feature toggles. Требования: локально выполнен Quick Start.

Карта кастомизации

Where white-label settings live

1. `ring-config.json` (install-time SSOT)

Идентичность клона

json


{
  "clone": {
    "name": "my-ring-clone",
    "displayName": "My Platform",
    "description": "Regional opportunities network",
    "organization": "Your Org",
    "contactEmail": "contact@example.com"
  },
  "domains": {
    "production": "https://example.com",
    "development": "http://localhost:3000"
  },
  "platform": {
    "baseUrl": "https://example.com"
  }
}

Используется для SEO (lib/seo-metadata.ts), JSON-LD и getSiteBaseUrl().

Vertical presets (предпочтительнее code forks)

json


{
  "entities": { "preset": "platform" },
  "productFields": { "preset": "platform" },
  "productBadges": { "preset": "platform" }
}

Клоны в стиле Agricultural / GreenFood используют "agricultural" для всех трёх. Полный реестр: Vertical presets.

Блок branding

branding.logo, branding.colors, branding.darkColors, branding.fonts в шаблоне — положите ассеты в public/images/ (см. пути в шаблоне).

Опциональные env overrides (lib/site-branding.ts):

Feature flags

Включайте и выключайте модули без удаления кода:

Matcher defaults

Метаданные sidebar и navigation

sidebar и navigation.links в ring-config.json питают публичный instance config (getPublicInstanceConfig()). Основной chrome реализован в:

components/navigation/navigation.tsx
components/navigation/desktop-sidebar.tsx
components/navigation/bottom-navigation.tsx

Для кастомного варианта desktop nav следуйте Whitelabel navigation.

2. Главная страница (заменяет устаревший portal)

Layer	File	Role
Route	`app/(public)/[locale]/page.tsx`	Static metadata + рендер `HomeWrapper`
Layout shell	`components/wrappers/home-wrapper.tsx`	Responsive grid, right rail, session-aware chrome
Hero body	`components/common/pages/home.tsx`	DaVinci hero, CTA, feature rotator
Copy	`locales/{locale}/pages.json` → `home`	Primary hero title, subtitle, features[], строки right-rail

Кастомизация hero copy (самый быстрый путь)

Отредактируйте locales/en/pages.json (зеркала uk, ru):

HomeContent читает через useTranslations('pages.home').

Кастомизация layout главной

Right rail (OSS marketplace / CTA Ringdom): HomeRightRail внутри home-wrapper.tsx, строки в pages.home.rightRail
Глубже UX — форкните home-wrapper.tsx или home.tsx; добавьте пути в .reggie-propagate-exclude.json

3. Интернационализация

SSOT: lib/locale-config.ts
Messages: locales/{locale}/**/*.json, загружает lib/i18n.ts
Routing: @/i18n/routing — никогда не снимайте locale prefixes вручную в client code

Полное руководство: Localization.

Защищённые locale-файлы (overlay deltas) перечислены в .reggie-propagate-exclude.json — обычно только locales/*/config.json, vendor.json.

4. Тема и визуальная полировка

Ring использует Tailwind 4 с CSS-переменными для light/dark (next-themes).

Задайте branding.colors / darkColors в ring-config.json (шаблон документирует ключи, выровненные с токенами shadcn)
Замените public/favicon.ico, public/images/logo-*.svg, apple-touch-icon.png
Тема по умолчанию: ring-config.json → "theme": { "default": "system" }

Избегайте правки сгенерированных design tokens в чужих клонах — предпочитайте ring-config + env brand overrides.

5. Payments и store (уровень клона)

PaymentConductor processors: env vars — Payment integration
Валюта / налог store: features.store в ring-config.json
WayForPay / Stripe: никогда не коммитьте секреты; в production используйте k8s secrets

6. Web3 и токены (опционально)

Адреса контрактов и treasury: env + Token economics. Задайте tokens.native в ring-config.json для display metadata.

7. Propagation Reggie — только thin overlay

Источник истины: всегда propagate из ring-platform.org. Exclude защищает brand/locale overlay — не vertical code.

8. Чеклист проверки

Branding — logo, favicon, NEXT_PUBLIC_BRAND_NAME, OG image на share previews
Home — hero на / совпадает с pages.home в каждой поддерживаемой локали
Presets — entities / productFields / productBadges соответствуют вертикали
Features — отключённые модули отдают 404 или скрыты из nav; нет мёртвых ссылок в sidebar
Auth — login/logout, role-gated admin на /admin
Build — чистый npm run build; smoke-тесты, если включены payments

Следующие шаги

Vertical presets

Ниши живут в platform; выбор через ring-config

Database selection

DB_BACKEND_MODE и стратегия миграций

Payment integration

WayForPay, Stripe, webhooks

AI customization

Тюнинг matcher и стоимость агентов

Руководство по кастомизации

Оценка времени: 1–4 часа на брендинг + feature toggles. Требования: локально выполнен Quick Start.

Карта кастомизации

Where white-label settings live

1. `ring-config.json` (install-time SSOT)

Идентичность клона

json


{
  "clone": {
    "name": "my-ring-clone",
    "displayName": "My Platform",
    "description": "Regional opportunities network",
    "organization": "Your Org",
    "contactEmail": "contact@example.com"
  },
  "domains": {
    "production": "https://example.com",
    "development": "http://localhost:3000"
  },
  "platform": {
    "baseUrl": "https://example.com"
  }
}

Используется для SEO (lib/seo-metadata.ts), JSON-LD и getSiteBaseUrl().

Vertical presets (предпочтительнее code forks)

json


{
  "entities": { "preset": "platform" },
  "productFields": { "preset": "platform" },
  "productBadges": { "preset": "platform" }
}

Клоны в стиле Agricultural / GreenFood используют "agricultural" для всех трёх. Полный реестр: Vertical presets.

Блок branding

branding.logo, branding.colors, branding.darkColors, branding.fonts в шаблоне — положите ассеты в public/images/ (см. пути в шаблоне).

Опциональные env overrides (lib/site-branding.ts):

Feature flags

Включайте и выключайте модули без удаления кода:

Matcher defaults

Метаданные sidebar и navigation

sidebar и navigation.links в ring-config.json питают публичный instance config (getPublicInstanceConfig()). Основной chrome реализован в:

components/navigation/navigation.tsx
components/navigation/desktop-sidebar.tsx
components/navigation/bottom-navigation.tsx

Для кастомного варианта desktop nav следуйте Whitelabel navigation.

2. Главная страница (заменяет устаревший portal)

Layer	File	Role
Route	`app/(public)/[locale]/page.tsx`	Static metadata + рендер `HomeWrapper`
Layout shell	`components/wrappers/home-wrapper.tsx`	Responsive grid, right rail, session-aware chrome
Hero body	`components/common/pages/home.tsx`	DaVinci hero, CTA, feature rotator
Copy	`locales/{locale}/pages.json` → `home`	Primary hero title, subtitle, features[], строки right-rail

Кастомизация hero copy (самый быстрый путь)

Отредактируйте locales/en/pages.json (зеркала uk, ru):

HomeContent читает через useTranslations('pages.home').

Кастомизация layout главной

Right rail (OSS marketplace / CTA Ringdom): HomeRightRail внутри home-wrapper.tsx, строки в pages.home.rightRail
Глубже UX — форкните home-wrapper.tsx или home.tsx; добавьте пути в .reggie-propagate-exclude.json

3. Интернационализация

SSOT: lib/locale-config.ts
Messages: locales/{locale}/**/*.json, загружает lib/i18n.ts
Routing: @/i18n/routing — никогда не снимайте locale prefixes вручную в client code

Полное руководство: Localization.

Защищённые locale-файлы (overlay deltas) перечислены в .reggie-propagate-exclude.json — обычно только locales/*/config.json, vendor.json.

4. Тема и визуальная полировка

Ring использует Tailwind 4 с CSS-переменными для light/dark (next-themes).

Задайте branding.colors / darkColors в ring-config.json (шаблон документирует ключи, выровненные с токенами shadcn)
Замените public/favicon.ico, public/images/logo-*.svg, apple-touch-icon.png
Тема по умолчанию: ring-config.json → "theme": { "default": "system" }

Избегайте правки сгенерированных design tokens в чужих клонах — предпочитайте ring-config + env brand overrides.

5. Payments и store (уровень клона)

PaymentConductor processors: env vars — Payment integration
Валюта / налог store: features.store в ring-config.json
WayForPay / Stripe: никогда не коммитьте секреты; в production используйте k8s secrets

6. Web3 и токены (опционально)

Адреса контрактов и treasury: env + Token economics. Задайте tokens.native в ring-config.json для display metadata.

7. Propagation Reggie — только thin overlay

Источник истины: всегда propagate из ring-platform.org. Exclude защищает brand/locale overlay — не vertical code.

8. Чеклист проверки

Branding — logo, favicon, NEXT_PUBLIC_BRAND_NAME, OG image на share previews
Home — hero на / совпадает с pages.home в каждой поддерживаемой локали
Presets — entities / productFields / productBadges соответствуют вертикали
Features — отключённые модули отдают 404 или скрыты из nav; нет мёртвых ссылок в sidebar
Auth — login/logout, role-gated admin на /admin
Build — чистый npm run build; smoke-тесты, если включены payments

Следующие шаги

Vertical presets

Ниши живут в platform; выбор через ring-config

Database selection

DB_BACKEND_MODE и стратегия миграций

Payment integration

WayForPay, Stripe, webhooks

AI customization

Тюнинг matcher и стоимость агентов

json


{
  "features": {
    "entities": { "enabled": true },
    "opportunities": { "enabled": true, "types": ["offer", "request"] },
    "store": { "enabled": true, "multiVendor": true },
    "web3": { "enabled": false },
    "ai": { "enabled": true, "matcher": true },
    "messaging": { "enabled": true }
  }
}

json


{
  "customized_files": [
    "ring-config.json",
    "public/logo.svg",
    "public/logo-light.svg",
    "public/logo-dark.svg",
    "public/favicon.ico",
    "locales/en/config.json",
    "locales/uk/config.json",
    "locales/ru/config.json",
    "locales/en/vendor.json",
    "locales/uk/vendor.json",
    "locales/ru/vendor.json"
  ],
  "customized_directories": ["public/branding/"]
}

json


{
  "features": {
    "entities": { "enabled": true },
    "opportunities": { "enabled": true, "types": ["offer", "request"] },
    "store": { "enabled": true, "multiVendor": true },
    "web3": { "enabled": false },
    "ai": { "enabled": true, "matcher": true },
    "messaging": { "enabled": true }
  }
}

json


{
  "customized_files": [
    "ring-config.json",
    "public/logo.svg",
    "public/logo-light.svg",
    "public/logo-dark.svg",
    "public/favicon.ico",
    "locales/en/config.json",
    "locales/uk/config.json",
    "locales/ru/config.json",
    "locales/en/vendor.json",
    "locales/uk/vendor.json",
    "locales/ru/vendor.json"
  ],
  "customized_directories": ["public/branding/"]
}

json


{
  "features": {
    "entities": { "enabled": true },
    "opportunities": { "enabled": true, "types": ["offer", "request"] },
    "store": { "enabled": true, "multiVendor": true },
    "web3": { "enabled": false },
    "ai": { "enabled": true, "matcher": true },
    "messaging": { "enabled": true }
  }
}

json


{
  "customized_files": [
    "ring-config.json",
    "public/logo.svg",
    "public/logo-light.svg",
    "public/logo-dark.svg",
    "public/favicon.ico",
    "locales/en/config.json",
    "locales/uk/config.json",
    "locales/ru/config.json",
    "locales/en/vendor.json",
    "locales/uk/vendor.json",
    "locales/ru/vendor.json"
  ],
  "customized_directories": ["public/branding/"]
}

Documentation

Быстрый вход (CTO · аудиторы · агенты)

Documentation

Быстрый вход (CTO · аудиторы · агенты)

Documentation

Быстрый вход (CTO · аудиторы · агенты)

Loading documentation...

Documentation

Быстрый вход (CTO · аудиторы · агенты)

Loading documentation...

Documentation

Быстрый вход (CTO · аудиторы · агенты)

Loading documentation...

Documentation

Быстрый вход (CTO · аудиторы · агенты)

Loading documentation...

Loading documentation...

Loading documentation...

Руководство по кастомизации

Карта кастомизации

1. ring-config.json (install-time SSOT)

Идентичность клона

Vertical presets (предпочтительнее code forks)

Блок branding

Feature flags

Matcher defaults

Метаданные sidebar и navigation

2. Главная страница (заменяет устаревший portal)

Кастомизация hero copy (самый быстрый путь)

Кастомизация layout главной

3. Интернационализация

4. Тема и визуальная полировка

5. Payments и store (уровень клона)

6. Web3 и токены (опционально)

7. Propagation Reggie — только thin overlay

8. Чеклист проверки

Следующие шаги

Vertical presets

Database selection

Payment integration

AI customization

Руководство по кастомизации

Карта кастомизации

1. ring-config.json (install-time SSOT)

Идентичность клона

Vertical presets (предпочтительнее code forks)

Блок branding

Feature flags

Matcher defaults

Метаданные sidebar и navigation

2. Главная страница (заменяет устаревший portal)

Кастомизация hero copy (самый быстрый путь)

Кастомизация layout главной

3. Интернационализация

4. Тема и визуальная полировка

5. Payments и store (уровень клона)

6. Web3 и токены (опционально)

7. Propagation Reggie — только thin overlay

8. Чеклист проверки

Следующие шаги

Vertical presets

Database selection

Payment integration

AI customization

Руководство по кастомизации

Карта кастомизации

1. ring-config.json (install-time SSOT)

Идентичность клона

Vertical presets (предпочтительнее code forks)

Блок branding

Feature flags

Matcher defaults

Метаданные sidebar и navigation

2. Главная страница (заменяет устаревший portal)

Кастомизация hero copy (самый быстрый путь)

Кастомизация layout главной

3. Интернационализация

4. Тема и визуальная полировка

5. Payments и store (уровень клона)

6. Web3 и токены (опционально)

1. `ring-config.json` (install-time SSOT)

1. `ring-config.json` (install-time SSOT)

1. `ring-config.json` (install-time SSOT)