application public active Verified 2026-03-29

TopoloOne

Unified admin and platform dashboard that surfaces services, API keys, and operator workflows.

Documentation Map

What It Is

Unified admin and platform dashboard that surfaces services, API keys, and operator workflows.

> A polished, secure, multi-app SSO launchpad built for solo developers and small teams

[![TypeScript](https://img.shields.io/badge/TypeScript-007ACC?style=for-the-badge&logo=typescript&logoColor=white)](https://typescriptlang.org/) [![React](https://img.shields.io/badge/React-20232A?style=for-the-badge&logo=react&logoColor=61DAFB)](https://reactjs.org/) [![Vite](https://img.shields.io/badge/Vite-646CFF?style=for-the-badge&logo=vite&logoColor=white)](https://vitejs.dev/) [![Cloudflare](https://img.shields.io/badge/Cloudflare-F38020?style=for-the-badge&logo=cloudflare&logoColor=white)](https://workers.cloudflare.com/) [![pnpm](https://img.shields.io/badge/pnpm-F69220?style=for-the-badge&logo=pnpm&logoColor=white)](https://pnpm.io/)

![Performance](https://img.shields.io/badge/performance-pending-blue?logo=lighthouse&logoColor=white)

Architecture

Owners: platform-experience

Source repos: Applications/TopoloOne

Dependencies: topolo-auth

Repo shape

  • Applications/TopoloOne/DEV-SETUP.md
  • Applications/TopoloOne/PWA-ASSETS-NEEDED.md
  • Applications/TopoloOne/README.md
  • Applications/TopoloOne/apps/
  • Applications/TopoloOne/commitlint.config.js
  • Applications/TopoloOne/docs/
  • Applications/TopoloOne/lighthouserc.js
  • Applications/TopoloOne/package.json
  • Applications/TopoloOne/packages/
  • Applications/TopoloOne/playwright-report/
  • Applications/TopoloOne/playwright.config.ts
  • Applications/TopoloOne/pnpm-lock.yaml
  • Applications/TopoloOne/pnpm-workspace.yaml
  • Applications/TopoloOne/scripts/
  • Applications/TopoloOne/test-results/
  • Applications/TopoloOne/tests/

Runtime Surfaces

Hosts:

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

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

Main: dist/index.js

Routes: workers.dev or asset-only surface

topoloone-worker

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

Main: dist/index.js

Routes: one.topolo.app/*

topoloone-website

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

Main: worker/index.js

Routes: workers.dev or asset-only surface

API Reference

Coverage: curated

Source: Applications/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.

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: Applications/TopoloOne/apps/ai-chat-rag/wrangler.toml

kv

Binding: CHAT_CACHE

Target: 5ee16c92ffe34626aacbe45b94e416fe

Environment: preview

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

kv

Binding: CHAT_CACHE

Target: 5ee16c92ffe34626aacbe45b94e416fe

Environment: production

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

d1

Binding: ONECLICK_DB

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

Environment: default

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

kv

Binding: ONECLICK_KV

Target: 53140b1879254915bfb46179f09d197b

Environment: default

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

d1

Binding: ONECLICK_DB

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

Environment: preview

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

kv

Binding: ONECLICK_KV

Target: a4ed16d4573d45b8a05eefa54f18eb5f

Environment: preview

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

d1

Binding: ONECLICK_DB

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

Environment: production

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

kv

Binding: ONECLICK_KV

Target: a4ed16d4573d45b8a05eefa54f18eb5f

Environment: production

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

kv

Binding: WAITLIST_KV

Target: 97ef5229c1574541bb7d5dd6b437d5b6

Environment: default

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

kv

Binding: BOOKING_KV

Target: b45b9707d5984639b03f42e3f9e42fcb

Environment: default

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

kv

Binding: SUBS_KV

Target: 5cd7bce0ea88411d857169ea9ef46c2a

Environment: default

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

kv

Binding: WAITLIST_KV

Target: YOUR_STAGING_WAITLIST_KV_PREVIEW_ID

Environment: staging

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

kv

Binding: BOOKING_KV

Target: YOUR_STAGING_BOOKING_KV_PREVIEW_ID

Environment: staging

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

kv

Binding: SUBS_KV

Target: YOUR_STAGING_SUBS_KV_PREVIEW_ID

Environment: staging

Source: Applications/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 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) -> YOUR_STAGING_WAITLIST_KV_PREVIEW_ID [staging]
  • BOOKING_KV (kv) -> YOUR_STAGING_BOOKING_KV_PREVIEW_ID [staging]
  • SUBS_KV (kv) -> YOUR_STAGING_SUBS_KV_PREVIEW_ID [staging]

Deployments

Deployment environments: preview, production, staging

Routes: one.topolo.app/*

Observability enabled: yes

Wrangler surfaces

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

Build and deploy commands

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

Failure Modes

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

Debugging Runbooks

Start with these entrypoints:

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

Linked runbooks

Change Log / Verification

Lifecycle: active

Last verified: 2026-03-29

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