Vertical Presets (SSOT)

Ring white-labels share one platform codebase: ring-platform.org. Verticals are selected by preset name in ring-config.json. Typed catalogs live under features/*/presets/<preset>.ts (and home under components/pages/home-presets/<preset>.tsx).

Two sources of preset modules

Source	What lives there	When it wins
Platform (`ring-platform.org`)	Shared niches (`platform`, `agricultural`, …)	Base of every build
Clone project dir (e.g. `ring-greenfood-live`)	Branding, `ring-config.json`, custom `<preset>.ts` + registry overlays	Overwrite on collision after platform copy

Build merge (clone truth prevails)

Use ringdom-clone-build (ringdom-mcp):

Copy latest ring-platform.org → build tmp (skips node_modules / .next / .git)
Copy all files from the clone project dir onto that tmp — overwrite collisions
Docker / CI build from the tmp dir

Do not expect a thin overlay alone to be a runnable app — merge first.

Two tiers of content

Tier	What	Where
1 — data	Category lists, badge tokens, labels	`ring-config.json` maps + `locales/`
2 — typed logic	Entity catalogs, zod/forms, niche field UIs	`features/*/presets/<preset>.ts` (platform and/or clone overlay)

Config keys

GreenFood sets entities / productFields / productBadges to "agricultural" and home.preset to "mvm-landing".

Accessors (named preset SSOT)

All use the configured *.preset string. If a singular key is unset, entities and productBadges fall back to productFields.preset, then "platform" — no hard-coded niche if/else.

getEntitiesPreset() → features/entities/presets registry
getHomePreset() → components/pages/home-presets registry
getProductFieldsPreset() / getProductFieldsPresets()
getProductBadgesPreset() / getProductBadgesPresets()

Entities registry

Rule: preset names appear in ring-config + the registry map. Consumers call getEntityTypes() / getEntityTypeList() — never import agricultural.ts directly.

Custom niche on a clone: add features/entities/presets/<name>.ts in the clone project, overlay index.ts to register it, set entities.preset to that name, then ringdom-clone-build.

Bundle discipline: sync catalogs are lightweight UI lists. Heavy ERP field catalogs live in *-erp.ts modules loaded only via async loadErpEntityTypes().

Copy / icons layering (no hardcoded UI strings)

Catalog (presets/<name>.ts): ids, emoji, English fallback names/descriptions
Copy: locales/*/modules/entities.json → types.<id> + types.<id>Desc
Visual skin: components/entities/entity-type-icons.tsx TYPE_VISUALS map
Render: useEntityTypeLabel() / useEntityTypeDescription() — i18n first, catalog fallback

Home landing registry

Add a shared vertical (platform)

Add features/entities/presets/<name>.ts (+ optional <name>-erp.ts)
One line in ENTITIES_PRESET_REGISTRY (+ ERP_CATALOG_REGISTRY if needed)
Optional landing → components/pages/home-presets/<name>.tsx
Optional Tier-1 maps under productFieldsPresets / productBadgesPresets
i18n keys in locales/*/modules/entities.json
Document the preset id in ring-config.template.json

Target roster: platform, agricultural, then tourism, sport, business, pet, auto, connect, technopark, manufacturing.

Thin exclude (propagation)

.reggie-propagate-exclude.json protects overlay-only paths from being overwritten by Reggie:

ring-config.json
public/logo*.svg, favicon.ico, public/branding/
locales/{en,uk,ru}/config.json, vendor.json
Custom features/*/presets/<clone-only>.ts (+ registry overlay) when not upstreamed yet
Tier-3 plug: lib/overlay/registry.ts only (maps). Do not exclude lib/overlay/types.ts or lib/overlay/runtime.ts — those are platform SSOT.

Tier-3 overlay socket (platform) + plug (clone)

Path	Owner	Role
`lib/overlay/types.ts`	Platform	Contracts
`lib/overlay/runtime.ts`	Platform	`loadOverlayMessages` / `resolveOverlayHomeRail`
`lib/overlay/registry.ts`	Platform empty maps; clone overlays maps	Domain feature loaders

Consumers import from @/lib/overlay/runtime. Clones never duplicate loaders in registry.ts.

Operator checklist (calculator / Order Lab): Ringization playbook.

Propagation source remains ring-platform.org → clones for shared code. Clone-local custom presets stay in the clone dir and win at ringdom-clone-build.

GreenFood cutover

Deprecated

Hard-coded if (productPreset === 'agricultural') in accessors
Per-clone custom-types.ts / overrides.ts without a named preset module
switch (vertical) in feature code — use the registry
Building Docker images from a thin overlay without platform merge

Vertical Presets (SSOT)

Two sources of preset modules

Source	What lives there	When it wins
Platform (`ring-platform.org`)	Shared niches (`platform`, `agricultural`, …)	Base of every build
Clone project dir (e.g. `ring-greenfood-live`)	Branding, `ring-config.json`, custom `<preset>.ts` + registry overlays	Overwrite on collision after platform copy

Build merge (clone truth prevails)

Use ringdom-clone-build (ringdom-mcp):

Copy latest ring-platform.org → build tmp (skips node_modules / .next / .git)
Copy all files from the clone project dir onto that tmp — overwrite collisions
Docker / CI build from the tmp dir

Do not expect a thin overlay alone to be a runnable app — merge first.

Two tiers of content

Tier	What	Where
1 — data	Category lists, badge tokens, labels	`ring-config.json` maps + `locales/`
2 — typed logic	Entity catalogs, zod/forms, niche field UIs	`features/*/presets/<preset>.ts` (platform and/or clone overlay)

Config keys

GreenFood sets entities / productFields / productBadges to "agricultural" and home.preset to "mvm-landing".

Accessors (named preset SSOT)

All use the configured *.preset string. If a singular key is unset, entities and productBadges fall back to productFields.preset, then "platform" — no hard-coded niche if/else.

getEntitiesPreset() → features/entities/presets registry
getHomePreset() → components/pages/home-presets registry
getProductFieldsPreset() / getProductFieldsPresets()
getProductBadgesPreset() / getProductBadgesPresets()

Entities registry

Rule: preset names appear in ring-config + the registry map. Consumers call getEntityTypes() / getEntityTypeList() — never import agricultural.ts directly.

Custom niche on a clone: add features/entities/presets/<name>.ts in the clone project, overlay index.ts to register it, set entities.preset to that name, then ringdom-clone-build.

Bundle discipline: sync catalogs are lightweight UI lists. Heavy ERP field catalogs live in *-erp.ts modules loaded only via async loadErpEntityTypes().

Copy / icons layering (no hardcoded UI strings)

Catalog (presets/<name>.ts): ids, emoji, English fallback names/descriptions
Copy: locales/*/modules/entities.json → types.<id> + types.<id>Desc
Visual skin: components/entities/entity-type-icons.tsx TYPE_VISUALS map
Render: useEntityTypeLabel() / useEntityTypeDescription() — i18n first, catalog fallback

Home landing registry

Add a shared vertical (platform)

Add features/entities/presets/<name>.ts (+ optional <name>-erp.ts)
One line in ENTITIES_PRESET_REGISTRY (+ ERP_CATALOG_REGISTRY if needed)
Optional landing → components/pages/home-presets/<name>.tsx
Optional Tier-1 maps under productFieldsPresets / productBadgesPresets
i18n keys in locales/*/modules/entities.json
Document the preset id in ring-config.template.json

Target roster: platform, agricultural, then tourism, sport, business, pet, auto, connect, technopark, manufacturing.

Thin exclude (propagation)

.reggie-propagate-exclude.json protects overlay-only paths from being overwritten by Reggie:

ring-config.json
public/logo*.svg, favicon.ico, public/branding/
locales/{en,uk,ru}/config.json, vendor.json
Custom features/*/presets/<clone-only>.ts (+ registry overlay) when not upstreamed yet
Tier-3 plug: lib/overlay/registry.ts only (maps). Do not exclude lib/overlay/types.ts or lib/overlay/runtime.ts — those are platform SSOT.

Tier-3 overlay socket (platform) + plug (clone)

Path	Owner	Role
`lib/overlay/types.ts`	Platform	Contracts
`lib/overlay/runtime.ts`	Platform	`loadOverlayMessages` / `resolveOverlayHomeRail`
`lib/overlay/registry.ts`	Platform empty maps; clone overlays maps	Domain feature loaders

Consumers import from @/lib/overlay/runtime. Clones never duplicate loaders in registry.ts.

Operator checklist (calculator / Order Lab): Ringization playbook.

Propagation source remains ring-platform.org → clones for shared code. Clone-local custom presets stay in the clone dir and win at ringdom-clone-build.

GreenFood cutover

Deprecated

Hard-coded if (productPreset === 'agricultural') in accessors
Per-clone custom-types.ts / overrides.ts without a named preset module
switch (vertical) in feature code — use the registry
Building Docker images from a thin overlay without platform merge

Vertical Presets (SSOT)

Two sources of preset modules

Source	What lives there	When it wins
Platform (`ring-platform.org`)	Shared niches (`platform`, `agricultural`, …)	Base of every build
Clone project dir (e.g. `ring-greenfood-live`)	Branding, `ring-config.json`, custom `<preset>.ts` + registry overlays	Overwrite on collision after platform copy

Build merge (clone truth prevails)

Use ringdom-clone-build (ringdom-mcp):

Copy latest ring-platform.org → build tmp (skips node_modules / .next / .git)
Copy all files from the clone project dir onto that tmp — overwrite collisions
Docker / CI build from the tmp dir

Do not expect a thin overlay alone to be a runnable app — merge first.

Two tiers of content

Tier	What	Where
1 — data	Category lists, badge tokens, labels	`ring-config.json` maps + `locales/`
2 — typed logic	Entity catalogs, zod/forms, niche field UIs	`features/*/presets/<preset>.ts` (platform and/or clone overlay)

Config keys

GreenFood sets entities / productFields / productBadges to "agricultural" and home.preset to "mvm-landing".

Accessors (named preset SSOT)

All use the configured *.preset string. If a singular key is unset, entities and productBadges fall back to productFields.preset, then "platform" — no hard-coded niche if/else.

getEntitiesPreset() → features/entities/presets registry
getHomePreset() → components/pages/home-presets registry
getProductFieldsPreset() / getProductFieldsPresets()
getProductBadgesPreset() / getProductBadgesPresets()

Entities registry

Rule: preset names appear in ring-config + the registry map. Consumers call getEntityTypes() / getEntityTypeList() — never import agricultural.ts directly.

Custom niche on a clone: add features/entities/presets/<name>.ts in the clone project, overlay index.ts to register it, set entities.preset to that name, then ringdom-clone-build.

Bundle discipline: sync catalogs are lightweight UI lists. Heavy ERP field catalogs live in *-erp.ts modules loaded only via async loadErpEntityTypes().

Copy / icons layering (no hardcoded UI strings)

Catalog (presets/<name>.ts): ids, emoji, English fallback names/descriptions
Copy: locales/*/modules/entities.json → types.<id> + types.<id>Desc
Visual skin: components/entities/entity-type-icons.tsx TYPE_VISUALS map
Render: useEntityTypeLabel() / useEntityTypeDescription() — i18n first, catalog fallback

Home landing registry

Add a shared vertical (platform)

Add features/entities/presets/<name>.ts (+ optional <name>-erp.ts)
One line in ENTITIES_PRESET_REGISTRY (+ ERP_CATALOG_REGISTRY if needed)
Optional landing → components/pages/home-presets/<name>.tsx
Optional Tier-1 maps under productFieldsPresets / productBadgesPresets
i18n keys in locales/*/modules/entities.json
Document the preset id in ring-config.template.json

Target roster: platform, agricultural, then tourism, sport, business, pet, auto, connect, technopark, manufacturing.

Thin exclude (propagation)

.reggie-propagate-exclude.json protects overlay-only paths from being overwritten by Reggie:

ring-config.json
public/logo*.svg, favicon.ico, public/branding/
locales/{en,uk,ru}/config.json, vendor.json
Custom features/*/presets/<clone-only>.ts (+ registry overlay) when not upstreamed yet
Tier-3 plug: lib/overlay/registry.ts only (maps). Do not exclude lib/overlay/types.ts or lib/overlay/runtime.ts — those are platform SSOT.

Tier-3 overlay socket (platform) + plug (clone)

Path	Owner	Role
`lib/overlay/types.ts`	Platform	Contracts
`lib/overlay/runtime.ts`	Platform	`loadOverlayMessages` / `resolveOverlayHomeRail`
`lib/overlay/registry.ts`	Platform empty maps; clone overlays maps	Domain feature loaders

Consumers import from @/lib/overlay/runtime. Clones never duplicate loaders in registry.ts.

Operator checklist (calculator / Order Lab): Ringization playbook.

Propagation source remains ring-platform.org → clones for shared code. Clone-local custom presets stay in the clone dir and win at ringdom-clone-build.

GreenFood cutover

Deprecated

Hard-coded if (productPreset === 'agricultural') in accessors
Per-clone custom-types.ts / overrides.ts without a named preset module
switch (vertical) in feature code — use the registry
Building Docker images from a thin overlay without platform merge

json


{
  "entities": { "preset": "platform" },
  "home": { "preset": "platform" },
  "productFields": { "preset": "platform" },
  "productBadges": { "preset": "platform" },
  "productFieldsPresets": {
    "platform": { "storeCategories": ["commerce", "education", "…"] },
    "agricultural": { "storeCategories": ["organic-produce", "honey-sweets", "…"] }
  },
  "productBadgesPresets": {
    "platform": { "productBadges": ["new", "featured", "popular"] },
    "agricultural": { "productBadges": ["organic", "local", "regenerative"] }
  }
}

text


features/entities/presets/
  types.ts             # EntityTypeCatalog contract
  platform.ts          # export const entityTypes (26 industries)
  agricultural.ts      # healthy-living UI catalog (lightweight)
  agricultural-erp.ts  # heavy ERP field catalogs — async-only via loadErpEntityTypes()
  index.ts             # ENTITIES_PRESET_REGISTRY + getEntityTypes()

text


components/pages/
  home.tsx                       # platform default landing
  home-presets/mvm-landing.tsx   # multi-vendor-marketplace e-commerce landing
  home-content-resolver.tsx      # HOME_PRESET_REGISTRY + getHomePreset()

text


ensure ring-config: entities/productFields/productBadges = agricultural, home = mvm-landing
keep branding + locale deltas in ring-greenfood-live
ringdom-clone-build({ project_name: "ring-greenfood-live" })
build/deploy from .ringdom-build/ring-greenfood-live/<stamp>

json


{
  "entities": { "preset": "platform" },
  "home": { "preset": "platform" },
  "productFields": { "preset": "platform" },
  "productBadges": { "preset": "platform" },
  "productFieldsPresets": {
    "platform": { "storeCategories": ["commerce", "education", "…"] },
    "agricultural": { "storeCategories": ["organic-produce", "honey-sweets", "…"] }
  },
  "productBadgesPresets": {
    "platform": { "productBadges": ["new", "featured", "popular"] },
    "agricultural": { "productBadges": ["organic", "local", "regenerative"] }
  }
}

text


features/entities/presets/
  types.ts             # EntityTypeCatalog contract
  platform.ts          # export const entityTypes (26 industries)
  agricultural.ts      # healthy-living UI catalog (lightweight)
  agricultural-erp.ts  # heavy ERP field catalogs — async-only via loadErpEntityTypes()
  index.ts             # ENTITIES_PRESET_REGISTRY + getEntityTypes()

text


components/pages/
  home.tsx                       # platform default landing
  home-presets/mvm-landing.tsx   # multi-vendor-marketplace e-commerce landing
  home-content-resolver.tsx      # HOME_PRESET_REGISTRY + getHomePreset()

text


ensure ring-config: entities/productFields/productBadges = agricultural, home = mvm-landing
keep branding + locale deltas in ring-greenfood-live
ringdom-clone-build({ project_name: "ring-greenfood-live" })
build/deploy from .ringdom-build/ring-greenfood-live/<stamp>

json


{
  "entities": { "preset": "platform" },
  "home": { "preset": "platform" },
  "productFields": { "preset": "platform" },
  "productBadges": { "preset": "platform" },
  "productFieldsPresets": {
    "platform": { "storeCategories": ["commerce", "education", "…"] },
    "agricultural": { "storeCategories": ["organic-produce", "honey-sweets", "…"] }
  },
  "productBadgesPresets": {
    "platform": { "productBadges": ["new", "featured", "popular"] },
    "agricultural": { "productBadges": ["organic", "local", "regenerative"] }
  }
}

text


features/entities/presets/
  types.ts             # EntityTypeCatalog contract
  platform.ts          # export const entityTypes (26 industries)
  agricultural.ts      # healthy-living UI catalog (lightweight)
  agricultural-erp.ts  # heavy ERP field catalogs — async-only via loadErpEntityTypes()
  index.ts             # ENTITIES_PRESET_REGISTRY + getEntityTypes()

text


components/pages/
  home.tsx                       # platform default landing
  home-presets/mvm-landing.tsx   # multi-vendor-marketplace e-commerce landing
  home-content-resolver.tsx      # HOME_PRESET_REGISTRY + getHomePreset()

text


ensure ring-config: entities/productFields/productBadges = agricultural, home = mvm-landing
keep branding + locale deltas in ring-greenfood-live
ringdom-clone-build({ project_name: "ring-greenfood-live" })
build/deploy from .ringdom-build/ring-greenfood-live/<stamp>

Documentation

Quick entry (CTOs · auditors · agents)

Documentation

Quick entry (CTOs · auditors · agents)

Documentation

Quick entry (CTOs · auditors · agents)

Loading documentation...

Documentation

Quick entry (CTOs · auditors · agents)

Loading documentation...

Documentation

Quick entry (CTOs · auditors · agents)

Loading documentation...

Documentation

Quick entry (CTOs · auditors · agents)

Loading documentation...

Loading documentation...

Loading documentation...

Vertical Presets (SSOT)

Two sources of preset modules

Build merge (clone truth prevails)

Two tiers of content

Config keys

Accessors (named preset SSOT)

Entities registry

Copy / icons layering (no hardcoded UI strings)

Home landing registry

Add a shared vertical (platform)

Thin exclude (propagation)

Tier-3 overlay socket (platform) + plug (clone)

GreenFood cutover

Deprecated

Vertical Presets (SSOT)

Two sources of preset modules

Build merge (clone truth prevails)

Two tiers of content

Config keys

Accessors (named preset SSOT)

Entities registry

Copy / icons layering (no hardcoded UI strings)

Home landing registry

Add a shared vertical (platform)

Thin exclude (propagation)

Tier-3 overlay socket (platform) + plug (clone)

GreenFood cutover

Deprecated

Vertical Presets (SSOT)

Two sources of preset modules

Build merge (clone truth prevails)

Two tiers of content

Config keys

Accessors (named preset SSOT)

Entities registry

Copy / icons layering (no hardcoded UI strings)

Home landing registry

Add a shared vertical (platform)

Thin exclude (propagation)

Tier-3 overlay socket (platform) + plug (clone)

GreenFood cutover

Deprecated