Loading documentation...
Preparing Ring Platform content
Concepts, value, and typical clone scenarios — less code.
Concepts, value, and typical clone scenarios — less code.
Preparing Ring Platform content
Preparing Ring Platform content
Preparing Ring Platform content
What this section is: Ring is a white-label platform — one open-source codebase, your brand, your domain. These docs are for operators and builders who run a clone (yourself or with Ringdom). They are not the Ringdom order flow.
Use when you control infrastructure (laptop, VPS, your k3s) and want the full source tree.
| Step | Action |
|---|---|
| 1 | Quick Start — install.sh or manual clone + .env.local + Postgres |
| 2 | Customization guide — ring-config.json, locales, HomeWrapper |
| 3 | Self-hosted deployment — Docker / production process |
| 4 | Deep guides below — database, payments, tokens, AI |
Agentic setup: Manual clone pairs well with Cursor + LegioX — describe your vertical; the agent walks env.local.template, migrations, and ring-config.json. The bash installer automates the same baseline.
| Doc | Purpose |
|---|---|
| This hub | Choose OSS vs Ringdom; map of child guides |
| Quick Start | OSS only — local smoke test |
| Customization guide | After you have a clone (OSS or Ringdom) — brand, features, home, propagation |
| Architecture | How Ring works internally |
| Localization | Locale env + locales/ SSOT |
| Child pages below | Database mode, payments, tokens, white-label clones, AI, case studies |
Quick Start gets OSS developers running; the guides below are where every operator makes the platform theirs.
| Advantage | What it means |
|---|---|
| Full product surface | Opportunities, entities, store, messaging, news, wallet, admin — per-clone toggles |
| Postgres-primary | DB_BACKEND_MODE=k8s-postgres-fcm; Firebase for FCM push, not primary SQL |
| Config-first | ring-config.json + env + locales/ before forking components |
| PaymentConductor | WayForPay, Stripe, ledger + webhooks |
| Safe upgrades | Reggie propagate from ring-greenfood-live + .reggie-propagate-exclude.json |
install.sh or manual clone — localhost smoke test
ring-config, HomeWrapper, locales, feature flags
DB_BACKEND_MODE matrix — links to architecture SSOT
RING contracts, membership, treasury
Logo, colors, typography
Tailwind CSS v4 tokens
Enable/disable platform domains
Add languages and locale SSOT
| Clone | Vertical |
|---|---|
| ring-greenfood-live | Ag marketplace — Reggie propagation source |
| ring-vikka-ua | Regional newsroom |
| ring-zemna-ai | Scientific publishing + agent chat |
| ring-petfriend-app | Map marketplace, EN/UA |
| ring-ring-ck-ua | Regional IT opportunities |
| ring-wellness-gov-ua | Healthcare / civic |
| ring-subiworx-com | Local services SMB |
OSS builders: Quick Start. Ringdom settlers: ringdom.org chat first, then Customization guide after handoff.
What this section is: Ring is a white-label platform — one open-source codebase, your brand, your domain. These docs are for operators and builders who run a clone (yourself or with Ringdom). They are not the Ringdom order flow.
Use when you control infrastructure (laptop, VPS, your k3s) and want the full source tree.
| Step | Action |
|---|---|
| 1 | Quick Start — install.sh or manual clone + .env.local + Postgres |
| 2 | Customization guide — ring-config.json, locales, HomeWrapper |
| 3 | Self-hosted deployment — Docker / production process |
| 4 | Deep guides below — database, payments, tokens, AI |
Agentic setup: Manual clone pairs well with Cursor + LegioX — describe your vertical; the agent walks env.local.template, migrations, and ring-config.json. The bash installer automates the same baseline.
| Doc | Purpose |
|---|---|
| This hub | Choose OSS vs Ringdom; map of child guides |
| Quick Start | OSS only — local smoke test |
| Customization guide | After you have a clone (OSS or Ringdom) — brand, features, home, propagation |
| Architecture | How Ring works internally |
| Localization | Locale env + locales/ SSOT |
| Child pages below | Database mode, payments, tokens, white-label clones, AI, case studies |
Quick Start gets OSS developers running; the guides below are where every operator makes the platform theirs.
| Advantage | What it means |
|---|---|
| Full product surface | Opportunities, entities, store, messaging, news, wallet, admin — per-clone toggles |
| Postgres-primary | DB_BACKEND_MODE=k8s-postgres-fcm; Firebase for FCM push, not primary SQL |
| Config-first | ring-config.json + env + locales/ before forking components |
| PaymentConductor | WayForPay, Stripe, ledger + webhooks |
| Safe upgrades | Reggie propagate from ring-greenfood-live + .reggie-propagate-exclude.json |
install.sh or manual clone — localhost smoke test
ring-config, HomeWrapper, locales, feature flags
DB_BACKEND_MODE matrix — links to architecture SSOT
RING contracts, membership, treasury
Logo, colors, typography
Tailwind CSS v4 tokens
Enable/disable platform domains
Add languages and locale SSOT
| Clone | Vertical |
|---|---|
| ring-greenfood-live | Ag marketplace — Reggie propagation source |
| ring-vikka-ua | Regional newsroom |
| ring-zemna-ai | Scientific publishing + agent chat |
| ring-petfriend-app | Map marketplace, EN/UA |
| ring-ring-ck-ua | Regional IT opportunities |
| ring-wellness-gov-ua | Healthcare / civic |
| ring-subiworx-com | Local services SMB |
OSS builders: Quick Start. Ringdom settlers: ringdom.org chat first, then Customization guide after handoff.
What this section is: Ring is a white-label platform — one open-source codebase, your brand, your domain. These docs are for operators and builders who run a clone (yourself or with Ringdom). They are not the Ringdom order flow.
Use when you control infrastructure (laptop, VPS, your k3s) and want the full source tree.
| Step | Action |
|---|---|
| 1 | Quick Start — install.sh or manual clone + .env.local + Postgres |
| 2 | Customization guide — ring-config.json, locales, HomeWrapper |
| 3 | Self-hosted deployment — Docker / production process |
| 4 | Deep guides below — database, payments, tokens, AI |
Agentic setup: Manual clone pairs well with Cursor + LegioX — describe your vertical; the agent walks env.local.template, migrations, and ring-config.json. The bash installer automates the same baseline.
| Doc | Purpose |
|---|---|
| This hub | Choose OSS vs Ringdom; map of child guides |
| Quick Start | OSS only — local smoke test |
| Customization guide | After you have a clone (OSS or Ringdom) — brand, features, home, propagation |
| Architecture | How Ring works internally |
| Localization | Locale env + locales/ SSOT |
| Child pages below | Database mode, payments, tokens, white-label clones, AI, case studies |
Quick Start gets OSS developers running; the guides below are where every operator makes the platform theirs.
| Advantage | What it means |
|---|---|
| Full product surface | Opportunities, entities, store, messaging, news, wallet, admin — per-clone toggles |
| Postgres-primary | DB_BACKEND_MODE=k8s-postgres-fcm; Firebase for FCM push, not primary SQL |
| Config-first | ring-config.json + env + locales/ before forking components |
| PaymentConductor | WayForPay, Stripe, ledger + webhooks |
| Safe upgrades | Reggie propagate from ring-greenfood-live + .reggie-propagate-exclude.json |
install.sh or manual clone — localhost smoke test
ring-config, HomeWrapper, locales, feature flags
DB_BACKEND_MODE matrix — links to architecture SSOT
RING contracts, membership, treasury
Logo, colors, typography
Tailwind CSS v4 tokens
Enable/disable platform domains
Add languages and locale SSOT
| Clone | Vertical |
|---|---|
| ring-greenfood-live | Ag marketplace — Reggie propagation source |
| ring-vikka-ua | Regional newsroom |
| ring-zemna-ai | Scientific publishing + agent chat |
| ring-petfriend-app | Map marketplace, EN/UA |
| ring-ring-ck-ua | Regional IT opportunities |
| ring-wellness-gov-ua | Healthcare / civic |
| ring-subiworx-com | Local services SMB |
OSS builders: Quick Start. Ringdom settlers: ringdom.org chat first, then Customization guide after handoff.
EU MiCA, US, UK, Ukraine, FATF — official sources
Safe UI overrides
| Empire hub + settler funnel |
EU MiCA, US, UK, Ukraine, FATF — official sources
Safe UI overrides
| Empire hub + settler funnel |
EU MiCA, US, UK, Ukraine, FATF — official sources
Safe UI overrides
| Empire hub + settler funnel |