application public active Verified 2026-04-10

TopoloOne

Unified admin dashboard plus worker-backed pricing, content, growth, and developer-acquisition surfaces for TopoloOne.

Documentation Map

What It Is

Unified admin dashboard plus worker-backed pricing, content, growth, and developer-acquisition surfaces for TopoloOne.

Canonical documentation for TopoloOne lives in `PlatformApplications/TopoloDocs`.

Use this repository for implementation only. Local product and operational docs have been retired in favor of the docs application.

Architecture

Owners: platform-experience

Source repos: PlatformApplications/TopoloOne

Dependencies: topolo-auth, topolo-nexus, topolo-developers

Repo shape

  • PlatformApplications/TopoloOne/README.md
  • PlatformApplications/TopoloOne/apps/
  • PlatformApplications/TopoloOne/commitlint.config.js
  • PlatformApplications/TopoloOne/docs/
  • PlatformApplications/TopoloOne/lighthouserc.js
  • PlatformApplications/TopoloOne/package.json
  • PlatformApplications/TopoloOne/packages/
  • PlatformApplications/TopoloOne/playwright-report/
  • PlatformApplications/TopoloOne/playwright.config.ts
  • PlatformApplications/TopoloOne/pnpm-lock.yaml
  • PlatformApplications/TopoloOne/pnpm-workspace.yaml
  • PlatformApplications/TopoloOne/scripts/
  • PlatformApplications/TopoloOne/test-results/
  • PlatformApplications/TopoloOne/tests/
  • PlatformApplications/TopoloOne/topolo.cloudcontrol.json

Runtime Surfaces

Hosts:

https://one.topolo.app https://one.topolo.io
ai-chat-rag

Config: PlatformApplications/TopoloOne/apps/ai-chat-rag/wrangler.toml

Main: dist/index.js

Routes: workers.dev or asset-only surface

topoloone

Config: PlatformApplications/TopoloOne/apps/dashboard-web/wrangler.toml

Main: not declared

Routes: workers.dev or asset-only surface

topoloone-worker

Config: PlatformApplications/TopoloOne/apps/dashboard-worker/wrangler.toml

Main: dist/index.js

Routes: one.topolo.app/*

topoloone-website

Config: PlatformApplications/TopoloOne/apps/marketing-site/wrangler.toml

Main: worker/index.js

Routes: workers.dev or asset-only surface

API Reference

Coverage: curated

Source: PlatformApplications/TopoloOne/apps/dashboard-web/src/lib/api.ts

Source exists in repo: yes

The dashboard contract is defined by the Auth-backed client routes it calls, while the marketing worker adds public checkout, waitlist, demo-booking, admin-session, and subscription-webhook ingestion endpoints plus static portfolio and developer acquisition routes. Public developer CTAs now hand off from TopoloOne into the separate TopoloDevelopers application on developers.topolo.app/signup.

App API page: /reference/apps/topolo-one

This system currently relies on a curated or README-derived contract surface instead of a source-controlled OpenAPI spec.

Auth and Permissions

Depends on Topolo Auth: yes

Service IDs:

svc_oneclick_dash

API key scopes

dashboard.read

View Topolo One dashboard

Resource pattern: none

apps.read

View application catalog

Resource pattern: none

apps.write

Manage applications and deployments

Resource pattern: none

workflows.read

View automation workflows

Resource pattern: none

workflows.write

Create and edit workflows

Resource pattern: none

launches.read

Generate or inspect launch flows

Resource pattern: none

widgets.read

Read widget and summary data

Resource pattern: none

notifications.read

View notification state

Resource pattern: none

notifications.write

Manage notification subscriptions

Resource pattern: none

settings.read

View system settings

Resource pattern: none

settings.write

Manage system configuration

Resource pattern: none

Service permissions

dashboard:read, apps:read, apps:write, workflows:read, workflows:write, launches:read, widgets:read, notifications:read, notifications:write, settings:read, settings:write

Data Ownership

kv

Binding: CHAT_CACHE

Target: 5ee16c92ffe34626aacbe45b94e416fe

Environment: default

Source: PlatformApplications/TopoloOne/apps/ai-chat-rag/wrangler.toml

kv

Binding: CHAT_CACHE

Target: 5ee16c92ffe34626aacbe45b94e416fe

Environment: preview

Source: PlatformApplications/TopoloOne/apps/ai-chat-rag/wrangler.toml

kv

Binding: CHAT_CACHE

Target: 5ee16c92ffe34626aacbe45b94e416fe

Environment: production

Source: PlatformApplications/TopoloOne/apps/ai-chat-rag/wrangler.toml

d1

Binding: ONECLICK_DB

Target: ace6619b-0dae-4248-870b-71561d9087e2

Environment: default

Source: PlatformApplications/TopoloOne/apps/dashboard-worker/wrangler.toml

kv

Binding: ONECLICK_KV

Target: 53140b1879254915bfb46179f09d197b

Environment: default

Source: PlatformApplications/TopoloOne/apps/dashboard-worker/wrangler.toml

d1

Binding: ONECLICK_DB

Target: ace6619b-0dae-4248-870b-71561d9087e2

Environment: preview

Source: PlatformApplications/TopoloOne/apps/dashboard-worker/wrangler.toml

kv

Binding: ONECLICK_KV

Target: a4ed16d4573d45b8a05eefa54f18eb5f

Environment: preview

Source: PlatformApplications/TopoloOne/apps/dashboard-worker/wrangler.toml

d1

Binding: ONECLICK_DB

Target: ace6619b-0dae-4248-870b-71561d9087e2

Environment: production

Source: PlatformApplications/TopoloOne/apps/dashboard-worker/wrangler.toml

kv

Binding: ONECLICK_KV

Target: a4ed16d4573d45b8a05eefa54f18eb5f

Environment: production

Source: PlatformApplications/TopoloOne/apps/dashboard-worker/wrangler.toml

kv

Binding: WAITLIST_KV

Target: 97ef5229c1574541bb7d5dd6b437d5b6

Environment: default

Source: PlatformApplications/TopoloOne/apps/marketing-site/wrangler.toml

kv

Binding: BOOKING_KV

Target: b45b9707d5984639b03f42e3f9e42fcb

Environment: default

Source: PlatformApplications/TopoloOne/apps/marketing-site/wrangler.toml

kv

Binding: SUBS_KV

Target: 5cd7bce0ea88411d857169ea9ef46c2a

Environment: default

Source: PlatformApplications/TopoloOne/apps/marketing-site/wrangler.toml

kv

Binding: WAITLIST_KV

Target: 97ef5229c1574541bb7d5dd6b437d5b6

Environment: staging

Source: PlatformApplications/TopoloOne/apps/marketing-site/wrangler.toml

kv

Binding: BOOKING_KV

Target: b45b9707d5984639b03f42e3f9e42fcb

Environment: staging

Source: PlatformApplications/TopoloOne/apps/marketing-site/wrangler.toml

kv

Binding: SUBS_KV

Target: 5cd7bce0ea88411d857169ea9ef46c2a

Environment: staging

Source: PlatformApplications/TopoloOne/apps/marketing-site/wrangler.toml

Queues / Cron / Workflows

Queue bindings:

No queue bindings were detected.

Cron triggers

No cron triggers were detected.

Workflow signals

No explicit queue/workflow script or cron signal was discovered.

Environment Variables and Bindings

Environment variables:

ALLOWED_ORIGINS AUTH_API_URL DASHBOARD_APP_ORIGIN ENVIRONMENT LOG_LEVEL NEXT_PUBLIC_SIGNUP_MODE NEXT_PUBLIC_SITE_URL NODE_ENV SERVICE_NAME

All wrangler bindings

  • CHAT_CACHE (kv) -> 5ee16c92ffe34626aacbe45b94e416fe
  • CHAT_CACHE (kv) -> 5ee16c92ffe34626aacbe45b94e416fe [preview]
  • CHAT_CACHE (kv) -> 5ee16c92ffe34626aacbe45b94e416fe [production]
  • ONECLICK_DB (d1) -> ace6619b-0dae-4248-870b-71561d9087e2
  • ONECLICK_KV (kv) -> 53140b1879254915bfb46179f09d197b
  • ONECLICK_DB (d1) -> ace6619b-0dae-4248-870b-71561d9087e2 [preview]
  • ONECLICK_KV (kv) -> a4ed16d4573d45b8a05eefa54f18eb5f [preview]
  • ONECLICK_DB (d1) -> ace6619b-0dae-4248-870b-71561d9087e2 [production]
  • ONECLICK_KV (kv) -> a4ed16d4573d45b8a05eefa54f18eb5f [production]
  • WAITLIST_KV (kv) -> 97ef5229c1574541bb7d5dd6b437d5b6
  • BOOKING_KV (kv) -> b45b9707d5984639b03f42e3f9e42fcb
  • SUBS_KV (kv) -> 5cd7bce0ea88411d857169ea9ef46c2a
  • WAITLIST_KV (kv) -> 97ef5229c1574541bb7d5dd6b437d5b6 [staging]
  • BOOKING_KV (kv) -> b45b9707d5984639b03f42e3f9e42fcb [staging]
  • SUBS_KV (kv) -> 5cd7bce0ea88411d857169ea9ef46c2a [staging]

Deployments

Deployment environments: preview, production, staging

Routes: one.topolo.app/*

Observability enabled: yes

Wrangler surfaces

  • PlatformApplications/TopoloOne/apps/ai-chat-rag/wrangler.toml -> ai-chat-rag (assets ./public) (build pnpm run build)
  • PlatformApplications/TopoloOne/apps/dashboard-web/wrangler.toml -> topoloone
  • PlatformApplications/TopoloOne/apps/dashboard-worker/wrangler.toml -> topoloone-worker (assets ./public) (build pnpm run build)
  • PlatformApplications/TopoloOne/apps/marketing-site/wrangler.toml -> topoloone-website (assets out)

Build and deploy commands

  • build — PlatformApplications/TopoloOne/apps/ai-chat-rag/package.json :: esbuild src/index.ts --bundle --outfile=dist/index.js --format=esm --platform=browser --target=es2022
  • deploy — PlatformApplications/TopoloOne/apps/ai-chat-rag/package.json :: wrangler deploy
  • deploy:dry-run — PlatformApplications/TopoloOne/apps/ai-chat-rag/package.json :: wrangler deploy --dry-run --outdir .wrangler/build
  • build — PlatformApplications/TopoloOne/apps/dashboard-web/package.json :: tsc && vite build --mode production
  • preview — PlatformApplications/TopoloOne/apps/dashboard-web/package.json :: vite preview
  • build — PlatformApplications/TopoloOne/apps/dashboard-worker/package.json :: esbuild src/index.ts --bundle --outfile=dist/index.js --format=esm --platform=browser --target=es2022
  • deploy — PlatformApplications/TopoloOne/apps/dashboard-worker/package.json :: wrangler deploy
  • deploy:dry-run — PlatformApplications/TopoloOne/apps/dashboard-worker/package.json :: wrangler deploy --dry-run --outdir .wrangler/build
  • build — PlatformApplications/TopoloOne/apps/marketing-site/package.json :: next build
  • build:cf — PlatformApplications/TopoloOne/apps/marketing-site/package.json :: echo 'Using static export instead of next-on-pages'
  • preview:cf — PlatformApplications/TopoloOne/apps/marketing-site/package.json :: wrangler pages dev .vercel/output/static
  • build — PlatformApplications/TopoloOne/package.json :: pnpm build:packages && pnpm build:apps
  • build:packages — PlatformApplications/TopoloOne/package.json :: pnpm --filter '@nodo/auth-client' build
  • build:apps — PlatformApplications/TopoloOne/package.json :: pnpm --filter '@nodo/dashboard-web' build && pnpm --filter '@nodo/dashboard-worker' build
  • build:web — PlatformApplications/TopoloOne/package.json :: pnpm --filter @nodo/dashboard-web build
  • build:worker — PlatformApplications/TopoloOne/package.json :: pnpm --filter @nodo/dashboard-worker build

Failure Modes

No default failure-mode heuristics are currently flagged for this system.

Debugging Runbooks

Start with these entrypoints:

  • PlatformApplications/TopoloOne/apps/ai-chat-rag/wrangler.toml
  • PlatformApplications/TopoloOne/apps/dashboard-web/wrangler.toml
  • PlatformApplications/TopoloOne/apps/dashboard-worker/wrangler.toml
  • PlatformApplications/TopoloOne/apps/marketing-site/wrangler.toml
  • PlatformApplications/TopoloOne/apps/dashboard-web/src/lib/api.ts
  • PlatformApplications/TopoloOne/README.md
  • PlatformApplications/TopoloOne/apps/ai-chat-rag/package.json
  • PlatformApplications/TopoloOne/apps/dashboard-web/package.json
  • PlatformApplications/TopoloOne/apps/dashboard-worker/package.json
  • PlatformApplications/TopoloOne/apps/marketing-site/package.json
  • PlatformApplications/TopoloOne/package.json

Change Log / Verification

Lifecycle: active

Last verified: 2026-04-10

Any code change to this system is expected to update the canonical docs in PlatformApplications/TopoloDocs and refresh the verification date.