@liquidityio/brand 2.3.0

package/README.md

@@ -0,0 +1,110 @@
+# @liquidityio/brand
+
+Liquidity's org config, theme seeds, fonts, and logo assets. Thin wrapper over [`@hanzo/branding`](https://github.com/hanzoai/branding).
+
+## Install
+
+```bash
+pnpm add @liquidityio/brand
+```
+
+## Usage
+
+### Tamagui
+
+```typescript
+import { tamaguiConfig } from '@liquidityio/brand'
+import { GuiProvider } from '@hanzo/gui'
+
+<GuiProvider config={tamaguiConfig}>
+  <App />
+</GuiProvider>
+```
+
+### Tailwind / shadcn
+
+One import in your app's main CSS:
+
+```css
+@import '@liquidityio/brand/tw-liquidity.css';
+```
+
+This pulls in `tailwindcss`, Liquidity's easing/fonts, the generated palettes, and the shadcn semantic color mappings — in the right order.
+
+### Brand data
+
+```typescript
+import { config, brandIdentity } from '@liquidityio/brand'
+import type { BrandIdentity, OrgConfig } from '@liquidityio/brand'
+import brandJson from '@liquidityio/brand/brand.json'
+
+// Logo assets
+// @liquidityio/brand/assets/logo/logo.svg
+// @liquidityio/brand/assets/logo/favicon.svg
+// @liquidityio/brand/assets/logo/wordmark.svg
+```
+
+## Structure
+
+```
+src/
+├── brand.json                     # identity + theme seeds (source of truth)
+├── brand-palettes.css             # generated by prebuild (gitignored)
+├── liquidity-tw-additions.css     # org-specific non-color TW tokens (easing, fonts)
+├── tw-liquidity.css               # bundle: tailwind + additions + palettes + semantic
+├── fonts.ts                       # Liquidity font defs (pplxSans)
+├── tamagui-config.ts              # calls createTamaguiConfig
+├── types.ts                       # BrandIdentity, OrgConfig
+└── index.ts                       # re-exports config, brandIdentity, tamaguiConfig
+assets/
+└── logo/                          # logo, logo-mono, logo-white, wordmark, favicon (SVG)
+```
+
+## Exports
+
+| Path | What |
+|------|------|
+| `@liquidityio/brand` | `config`, `brandIdentity`, `tamaguiConfig`, types |
+| `@liquidityio/brand/brand.json` | Raw brand data |
+| `@liquidityio/brand/tw-liquidity.css` | Single CSS bundle for apps |
+| `@liquidityio/brand/assets/*` | Logo files |
+
+## How it works
+
+Almost everything — theme engine, palette generation, components, shadcn mappings — lives in `@hanzo/branding`. This package just provides Liquidity-specific data:
+
+- **`brand.json`** — identity (name, domains, social, etc.) and 7 theme seeds
+- **`fonts.ts`** — pplxSans font definitions
+- **`liquidity-tw-additions.css`** — easing curves and font families
+- **`tamagui-config.ts`** — calls `createTamaguiConfig` from `@hanzo/branding/tg-config` with our seeds and fonts
+
+The `prebuild` script runs `generate-palettes` (shipped by `@hanzo/branding`), which reads `src/brand.json` and writes `src/brand-palettes.css`.
+
+## Build
+
+```bash
+pnpm build    # runs prebuild (generate-palettes), then tsup
+pnpm tc       # typecheck
+pnpm dev      # watch mode
+```
+
+## Publish
+
+```bash
+pnpm pub               # bump patch
+pnpm pub minor         # bump minor
+pnpm pub major         # bump major
+pnpm pub 2.0.0         # exact version
+```
+
+The script builds, bumps version, commits as `v{version}`, tags, and publishes. It refuses to run on a dirty tree. Push is left to you:
+
+```bash
+git push && git push --tags
+```
+
+## Consumers
+
+- `liquidityio/exchange` — securities exchange frontend
+- `liquidityio/id` — auth + onboarding app
+- `liquidityio/superadmin` — operator admin panel

package/assets/logo/favicon.svg

@@ -0,0 +1,6 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="64" height="64" viewBox="0 0 1024 1024">
+  <rect width="1024" height="1024" rx="200" fill="#111827"/>
+  <path d="M 220 220 L 220 720 L 680 720 L 680 620 L 330 620 L 330 220 Z" fill="white"/>
+  <path d="M 400 500 Q 500 420 600 500 Q 700 580 800 500" stroke="rgba(255,255,255,0.35)" stroke-width="12" fill="none" stroke-linecap="round"/>
+  <path d="M 400 560 Q 500 480 600 560 Q 700 640 800 560" stroke="rgba(255,255,255,0.2)" stroke-width="8" fill="none" stroke-linecap="round"/>
+</svg>

package/assets/logo/logo-mono.svg

@@ -0,0 +1,6 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1024" height="1024" viewBox="0 0 1024 1024">
+  <rect width="1024" height="1024" rx="200" fill="#111827"/>
+  <path d="M 220 220 L 220 720 L 680 720 L 680 620 L 330 620 L 330 220 Z" fill="white"/>
+  <path d="M 400 500 Q 500 420 600 500 Q 700 580 800 500" stroke="rgba(255,255,255,0.35)" stroke-width="12" fill="none" stroke-linecap="round"/>
+  <path d="M 400 560 Q 500 480 600 560 Q 700 640 800 560" stroke="rgba(255,255,255,0.2)" stroke-width="8" fill="none" stroke-linecap="round"/>
+</svg>

package/assets/logo/logo-white.svg

@@ -0,0 +1,5 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1024" height="1024" viewBox="0 0 1024 1024">
+  <path d="M 220 220 L 220 720 L 680 720 L 680 620 L 330 620 L 330 220 Z" fill="white"/>
+  <path d="M 400 500 Q 500 420 600 500 Q 700 580 800 500" stroke="rgba(255,255,255,0.5)" stroke-width="12" fill="none" stroke-linecap="round"/>
+  <path d="M 400 560 Q 500 480 600 560 Q 700 640 800 560" stroke="rgba(255,255,255,0.3)" stroke-width="8" fill="none" stroke-linecap="round"/>
+</svg>

package/assets/logo/logo.svg

@@ -0,0 +1,12 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1024" height="1024" viewBox="0 0 1024 1024">
+  <defs>
+    <linearGradient id="lqdtyGrad" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" style="stop-color:#3B82F6"/>
+      <stop offset="100%" style="stop-color:#1D4ED8"/>
+    </linearGradient>
+  </defs>
+  <rect width="1024" height="1024" rx="200" fill="url(#lqdtyGrad)"/>
+  <path d="M 220 220 L 220 720 L 680 720 L 680 620 L 330 620 L 330 220 Z" fill="white"/>
+  <path d="M 400 500 Q 500 420 600 500 Q 700 580 800 500" stroke="rgba(255,255,255,0.4)" stroke-width="12" fill="none" stroke-linecap="round"/>
+  <path d="M 400 560 Q 500 480 600 560 Q 700 640 800 560" stroke="rgba(255,255,255,0.25)" stroke-width="8" fill="none" stroke-linecap="round"/>
+</svg>

package/assets/logo/wordmark-white.svg

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="400" height="80" viewBox="0 0 400 80">
+  <text x="10" y="58" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif"
+    font-size="52" font-weight="700" letter-spacing="-1" fill="white">LIQUIDITY</text>
+</svg>

package/assets/logo/wordmark.svg

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="400" height="80" viewBox="0 0 400 80">
+  <text x="10" y="58" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif"
+    font-size="52" font-weight="700" letter-spacing="-1" fill="#111827">LIQUIDITY</text>
+</svg>

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@liquidityio/brand",
+  "version": "2.3.0",
+  "description": "Org config, theme seeds, and assets for Liquidity",
+  "main": "./src/index.ts",
+  "types": "./src/index.ts",
+  "exports": {
+    ".": "./src/index.ts",
+    "./brand.json": "./src/brand.json",
+    "./tw-liquidity.css": "./src/tw-liquidity.css",
+    "./assets/*": "./assets/*"
+  },
+  "files": [
+    "src",
+    "assets"
+  ],
+  "scripts": {
+    "tc": "tsc --noEmit",
+    "prebuild": "generate-palettes",
+    "build": "tsup src/index.ts --format cjs,esm --dts --clean",
+    "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
+    "pub": "./scripts/publish.sh"
+  },
+  "dependencies": {
+    "@hanzo/branding": "^2.0.2"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.9.3"
+  },
+  "author": "Liquidity",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/liquidityio/brand"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/brand-palettes.css

@@ -0,0 +1,175 @@
+/* Generated by @hanzo/branding — do not edit manually */
+
+:root {
+  --color-neutral-1: #fafafa;
+  --color-neutral-2: #f5f5f5;
+  --color-neutral-3: #ededed;
+  --color-neutral-4: #e0e0e0;
+  --color-neutral-5: #cccccc;
+  --color-neutral-6: #b3b3b3;
+  --color-neutral-7: #949494;
+  --color-neutral-8: #757575;
+  --color-neutral-9: #5c5c5c;
+  --color-neutral-10: #424242;
+  --color-neutral-11: #2e2e2e;
+  --color-neutral-12: #1a1a1a;
+  --color-primary-1: #f9fafb;
+  --color-primary-2: #f3f4f6;
+  --color-primary-3: #eaecf1;
+  --color-primary-4: #dadee7;
+  --color-primary-5: #bfc7d9;
+  --color-primary-6: #9daac8;
+  --color-primary-7: #7387b5;
+  --color-primary-8: #4e669c;
+  --color-primary-9: #3b4f7d;
+  --color-primary-10: #28385c;
+  --color-primary-11: #1b2741;
+  --color-primary-12: #0e1525;
+  --color-secondary-1: #faf9fb;
+  --color-secondary-2: #f4f2f8;
+  --color-secondary-3: #ece7f3;
+  --color-secondary-4: #dfd5ec;
+  --color-secondary-5: #c9b6e2;
+  --color-secondary-6: #ad8dd8;
+  --color-secondary-7: #8c5acd;
+  --color-secondary-8: #6c30ba;
+  --color-secondary-9: #542196;
+  --color-secondary-10: #3c1570;
+  --color-secondary-11: #290c50;
+  --color-secondary-12: #17052e;
+  --color-info-1: #f9f9fb;
+  --color-info-2: #f2f4f8;
+  --color-info-3: #e7ebf3;
+  --color-info-4: #d4dced;
+  --color-info-5: #b4c3e4;
+  --color-info-6: #8ba4da;
+  --color-info-7: #577dd1;
+  --color-info-8: #2d5abe;
+  --color-info-9: #1e459a;
+  --color-info-10: #123072;
+  --color-info-11: #0a2152;
+  --color-info-12: #04122f;
+  --color-success-1: #f9fbfa;
+  --color-success-2: #f2f8f4;
+  --color-success-3: #e7f3ec;
+  --color-success-4: #d5ecdd;
+  --color-success-5: #b6e2c6;
+  --color-success-6: #8ed7a9;
+  --color-success-7: #5ccc85;
+  --color-success-8: #33b864;
+  --color-success-9: #23944d;
+  --color-success-10: #166e37;
+  --color-success-11: #0d4f25;
+  --color-success-12: #062d14;
+  --color-warning-1: #fbfaf8;
+  --color-warning-2: #f8f5f1;
+  --color-warning-3: #f4eee6;
+  --color-warning-4: #efe1d2;
+  --color-warning-5: #e7ceb1;
+  --color-warning-6: #dfb686;
+  --color-warning-7: #d9994f;
+  --color-warning-8: #c87b23;
+  --color-warning-9: #a26116;
+  --color-warning-10: #79460c;
+  --color-warning-11: #573105;
+  --color-warning-12: #321b01;
+  --color-danger-1: #fbf9f9;
+  --color-danger-2: #f7f2f2;
+  --color-danger-3: #f3e8e8;
+  --color-danger-4: #ebd6d6;
+  --color-danger-5: #e0b8b8;
+  --color-danger-6: #d59090;
+  --color-danger-7: #c95f5f;
+  --color-danger-8: #b43636;
+  --color-danger-9: #912626;
+  --color-danger-10: #6c1919;
+  --color-danger-11: #4d0f0f;
+  --color-danger-12: #2c0707;
+}
+
+[data-color-scheme='dark'] {
+  --color-neutral-1: #0d0d0d;
+  --color-neutral-2: #1a1a1a;
+  --color-neutral-3: #242424;
+  --color-neutral-4: #303030;
+  --color-neutral-5: #424242;
+  --color-neutral-6: #575757;
+  --color-neutral-7: #707070;
+  --color-neutral-8: #8c8c8c;
+  --color-neutral-9: #a8a8a8;
+  --color-neutral-10: #c2c2c2;
+  --color-neutral-11: #dbdbdb;
+  --color-neutral-12: #f0f0f0;
+  --color-primary-1: #070b12;
+  --color-primary-2: #0f1524;
+  --color-primary-3: #161e32;
+  --color-primary-4: #1f2a42;
+  --color-primary-5: #2c3a58;
+  --color-primary-6: #3c4d71;
+  --color-primary-7: #51648f;
+  --color-primary-8: #7081a9;
+  --color-primary-9: #95a1bb;
+  --color-primary-10: #b6bdcd;
+  --color-primary-11: #d5d9e1;
+  --color-primary-12: #eeeff2;
+  --color-secondary-1: #0b0317;
+  --color-secondary-2: #17072c;
+  --color-secondary-3: #200b3c;
+  --color-secondary-4: #2c124f;
+  --color-secondary-5: #3d1b69;
+  --color-secondary-6: #502885;
+  --color-secondary-7: #693aa7;
+  --color-secondary-8: #865abe;
+  --color-secondary-9: #a487ca;
+  --color-secondary-10: #bfadd6;
+  --color-secondary-11: #dad1e6;
+  --color-secondary-12: #efecf3;
+  --color-info-1: #020917;
+  --color-info-2: #06122d;
+  --color-info-3: #0a1a3e;
+  --color-info-4: #102451;
+  --color-info-5: #19336b;
+  --color-info-6: #264488;
+  --color-info-7: #365baa;
+  --color-info-8: #5778c1;
+  --color-info-9: #859bcc;
+  --color-info-10: #acbad8;
+  --color-info-11: #d1d7e6;
+  --color-info-12: #eceef4;
+  --color-success-1: #03160a;
+  --color-success-2: #072c15;
+  --color-success-3: #0c3b1d;
+  --color-success-4: #134e29;
+  --color-success-5: #1d6838;
+  --color-success-6: #2a844b;
+  --color-success-7: #3ba562;
+  --color-success-8: #5cbd80;
+  --color-success-9: #88c9a0;
+  --color-success-10: #aed6bd;
+  --color-success-11: #d1e5d9;
+  --color-success-12: #ecf3ef;
+  --color-warning-1: #190e01;
+  --color-warning-2: #301b03;
+  --color-warning-3: #412606;
+  --color-warning-4: #56330b;
+  --color-warning-5: #714614;
+  --color-warning-6: #8f5b1f;
+  --color-warning-7: #b2752f;
+  --color-warning-8: #c89150;
+  --color-warning-9: #d1ab80;
+  --color-warning-10: #dbc4a9;
+  --color-warning-11: #e8dccf;
+  --color-warning-12: #f4f0eb;
+  --color-danger-1: #160404;
+  --color-danger-2: #2b0808;
+  --color-danger-3: #3a0d0d;
+  --color-danger-4: #4d1414;
+  --color-danger-5: #661f1f;
+  --color-danger-6: #812c2c;
+  --color-danger-7: #a23e3e;
+  --color-danger-8: #ba5e5e;
+  --color-danger-9: #c78a8a;
+  --color-danger-10: #d5afaf;
+  --color-danger-11: #e5d2d2;
+  --color-danger-12: #f3ecec;
+}

package/src/brand.json

@@ -0,0 +1,75 @@
+{
+  "identity": {
+    "name": "Liquidity",
+    "title": "Liquidity | Regulated Digital Assets",
+    "description": "Regulated digital asset exchange",
+    "shortName": "LQDTY",
+    "labsName": "Liquidity",
+    "legalEntity": "Liquidity Inc.",
+    "walletName": "Liquidity Wallet",
+    "protocolName": "Liquidity Protocol",
+    "copyrightHolder": "Liquidity Inc.",
+    "appDomain": "liquidity.io",
+    "docsDomain": "docs.liquidity.io",
+    "infoDomain": "info.liquidity.io",
+    "gatewayDomain": "api.liquidity.io",
+    "wsDomain": "ws.liquidity.io",
+    "helpUrl": "https://docs.liquidity.io",
+    "termsUrl": "https://liquidity.io/terms",
+    "privacyUrl": "https://liquidity.io/privacy",
+    "downloadUrl": "https://liquidity.io/wallet",
+    "complianceEmail": "compliance@liquidity.io",
+    "supportEmail": "support@liquidity.io",
+    "twitter": "https://x.com/liquidityio",
+    "farcaster": "",
+    "linkedin": "",
+    "tiktok": "",
+    "github": "https://github.com/liquidityio",
+    "discord": "",
+    "logoUrl": "https://cdn.jsdelivr.net/npm/@liquidityio/brand@latest/assets/logo/logo.svg",
+    "faviconUrl": "https://cdn.jsdelivr.net/npm/@liquidityio/brand@latest/assets/logo/favicon.svg"
+  },
+  "themes": {
+    "neutral":   { "seed": "#808080" },
+    "primary":   { "seed": "#1a2744" },
+    "secondary": { "seed": "#721be4" },
+    "info":      { "seed": "#2563eb" },
+    "success":   { "seed": "#16a34a" },
+    "warning":   { "seed": "#d97706" },
+    "danger":    { "seed": "#dc2626" }
+  },
+  "chains": {
+    "defaultChainId": 8675309,
+    "supported": [
+      8675309,
+      8675310,
+      8675311,
+      1337,
+      31337
+    ]
+  },
+  "rpc": {
+    "1": "https://eth.llamarpc.com",
+    "494949": "https://rpc.liquidity.io",
+    "42161": "https://arb1.arbitrum.io/rpc",
+    "8453": "https://mainnet.base.org",
+    "137": "https://polygon-rpc.com",
+    "8675309": "https://rpc.main.satschel.com",
+    "8675310": "https://rpc.test.satschel.com",
+    "8675311": "https://rpc.dev.satschel.com",
+    "1337": "http://localhost:8545/ext/bc/C/rpc",
+    "31337": "http://localhost:8545/ext/bc/C/rpc"
+  },
+  "api": {
+    "graphql": "",
+    "gateway": "https://api.liquidity.io",
+    "insights": "https://insights.satschel.com"
+  },
+  "iam": {
+    "provider": "https://id.liquidity.io",
+    "clientId": "liquidity-app"
+  },
+  "walletConnect": {
+    "projectId": ""
+  }
+}

package/src/fonts.ts

@@ -0,0 +1,45 @@
+import type { FontDef } from '@hanzo/branding/tg-config'
+
+export const bodyFont: FontDef = {
+  family: '"pplxSans", ui-sans-serif, system-ui, -apple-system, sans-serif',
+  size: {
+    1: 11, 2: 12, 3: 13, 4: 14, true: 14, 5: 15, 6: 16,
+    7: 18, 8: 20, 9: 24, 10: 30, 11: 36, 12: 44,
+    13: 52, 14: 62, 15: 74, 16: 88,
+  },
+  lineHeight: {
+    1: 16, 2: 18, 3: 19, 4: 21, true: 21, 5: 22, 6: 24,
+    7: 27, 8: 30, 9: 34, 10: 42, 11: 50, 12: 60,
+    13: 70, 14: 82, 15: 98, 16: 116,
+  },
+  weight: { 1: '400', 6: '500' },
+  letterSpacing: { 1: 0.15, 4: 0.1, true: 0.1, 6: 0, 8: -0.35, 12: -0.75 },
+}
+
+export const headingFont: FontDef = {
+  family: '"pplxSans", ui-sans-serif, system-ui, -apple-system, sans-serif',
+  size: {
+    1: 12, 2: 14, 3: 16, 4: 18, true: 18, 5: 20,
+    6: 24, 7: 30, 8: 36, 9: 44, 10: 52, 11: 62, 12: 74,
+  },
+  lineHeight: {
+    1: 16, 2: 18, 3: 22, 4: 24, true: 24, 5: 26,
+    6: 30, 7: 36, 8: 44, 9: 52, 10: 62, 11: 74, 12: 86,
+  },
+  weight: { 1: '500', 6: '550' },
+  letterSpacing: { 1: 0.2, 4: 0, 6: -0.2, 8: -0.5, 12: -1 },
+}
+
+export const monoFont: FontDef = {
+  family: '"pplxSansMono", ui-monospace, monospace',
+  size: {
+    1: 11, 2: 12, 3: 13, 4: 14, true: 14, 5: 15,
+    6: 16, 7: 18, 8: 20, 9: 24, 10: 30,
+  },
+  lineHeight: {
+    1: 18, 2: 20, 3: 22, 4: 24, true: 24, 5: 26,
+    6: 28, 7: 30, 8: 34, 9: 40, 10: 48,
+  },
+  weight: { 1: '400' },
+  letterSpacing: { 4: 0, true: 0 },
+}

package/src/index.ts

@@ -0,0 +1,8 @@
+import type { OrgConfig } from './types'
+import brandJson from './brand.json'
+
+export const config: OrgConfig = brandJson as OrgConfig
+export const brandIdentity = config.identity as Required<typeof config.identity>
+
+export { tamaguiConfig } from './tamagui-config'
+export type { BrandIdentity, OrgConfig } from './types'

package/src/liquidity-tw-additions.css

@@ -0,0 +1,21 @@
+/* ============================================================
+   Liquidity-specific Tailwind additions (non-color tokens)
+   ============================================================
+   Org-specific easing curves and typography on top of @hanzo/branding.
+*/
+
+@theme {
+  /* Easing */
+  --ease-out-cubic:    cubic-bezier(.33, 1, .68, 1);
+  --ease-in-out-cubic: cubic-bezier(.65, 0, .35, 1);
+  --ease-out-soft:     cubic-bezier(.36, 1.3, .64, 1);
+  --ease-in-out-quart: cubic-bezier(.76, 0, .24, 1);
+  --ease-out-quint:    cubic-bezier(.22, 1, .36, 1);
+  --ease-in-cubic:     cubic-bezier(.32, 0, .67, 0);
+  --ease-in-out-sine:  cubic-bezier(.37, 0, .63, 1);
+
+  /* Typography */
+  --font-sans:  "pplxSans", ui-sans-serif, system-ui, -apple-system, sans-serif;
+  --font-mono:  "pplxSansMono", ui-monospace, monospace;
+  --font-serif: "pplxSerif", ui-serif, Georgia, serif;
+}

package/src/tamagui-config.ts

@@ -0,0 +1,9 @@
+import { createTamaguiConfig, type ThemesConfig } from '@hanzo/branding/tg-config'
+import brandJson from './brand.json'
+import { bodyFont, headingFont, monoFont } from './fonts'
+
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export const tamaguiConfig: any = createTamaguiConfig({
+  themes: brandJson.themes as ThemesConfig,
+  fonts: { body: bodyFont, heading: headingFont, mono: monoFont },
+})

package/src/tw-liquidity.css

@@ -0,0 +1,9 @@
+/*
+ * Tailwind bundle for Liquidity apps.
+ * Apps just import this single file.
+ */
+
+@import 'tailwindcss';
+@import './liquidity-tw-additions.css';
+@import './brand-palettes.css';
+@import '@hanzo/branding/shadcn-semantic-tw-colors.css';

package/src/types.ts

@@ -0,0 +1,66 @@
+import type { ThemesConfig } from '@hanzo/branding/tg-config'
+
+/** Brand identity — name, domains, social, assets. */
+export interface BrandIdentity {
+  name: string
+  title: string
+  description: string
+  shortName: string
+  labsName: string
+  legalEntity: string
+  walletName: string
+  protocolName: string
+  copyrightHolder: string
+
+  // Domains
+  appDomain: string
+  docsDomain: string
+  infoDomain: string
+  gatewayDomain: string
+  wsDomain: string
+
+  // Links
+  helpUrl: string
+  termsUrl: string
+  privacyUrl: string
+  downloadUrl: string
+
+  // Contact
+  complianceEmail: string
+  supportEmail: string
+
+  // Social
+  twitter: string
+  farcaster: string
+  linkedin: string
+  tiktok: string
+  github: string
+  discord: string
+
+  // Assets
+  logoUrl: string
+  faviconUrl: string
+}
+
+/** Full org config — the shape of brand.json. */
+export interface OrgConfig {
+  identity: Partial<BrandIdentity>
+  themes: ThemesConfig
+  chains: {
+    defaultChainId: number
+    supported: number[]
+  }
+  rpc: Record<string, string>
+  api: {
+    graphql: string
+    gateway: string
+    insights: string
+  }
+  iam?: {
+    provider: string
+    clientId: string
+  }
+  walletConnect: {
+    projectId: string
+  }
+}