application public active Verified 2026-03-29

Topolo Social Studio

Hybrid macOS desktop and Cloudflare scaffold for social studio workflows.

Documentation Map

What It Is

Hybrid macOS desktop and Cloudflare scaffold for social studio workflows.

Topolo Social Studio is a new Topolo application scaffolded as a self-contained monorepo under `/Applications`. It pairs a local-rendered macOS desktop shell with Cloudflare-hosted web and worker surfaces, while keeping identity delegated to Topolo Auth.

Use `pnpm desktop:dev` when the Rust/Tauri toolchain is available. The Vite desktop shell still boots with `pnpm dev:desktop`.

Cloudflare production surfaces:

Architecture

Owners: socialize

Source repos: Applications/topolo-social-studio

Dependencies: topolo-auth

Repo shape

  • Applications/topolo-social-studio/README.md
  • Applications/topolo-social-studio/apps/
  • Applications/topolo-social-studio/docs/
  • Applications/topolo-social-studio/e2e/
  • Applications/topolo-social-studio/eslint.config.mjs
  • Applications/topolo-social-studio/output/
  • Applications/topolo-social-studio/package.json
  • Applications/topolo-social-studio/packages/
  • Applications/topolo-social-studio/playwright.config.ts
  • Applications/topolo-social-studio/pnpm-lock.yaml
  • Applications/topolo-social-studio/pnpm-workspace.yaml
  • Applications/topolo-social-studio/prettier.config.mjs
  • Applications/topolo-social-studio/tsconfig.base.json
  • Applications/topolo-social-studio/tsconfig.json
  • Applications/topolo-social-studio/vitest.config.ts

Runtime Surfaces

Hosts:

No primary host is registered.

topolo-social-studio-api

Config: Applications/topolo-social-studio/apps/api-worker/wrangler.toml

Main: src/index.ts

Routes: workers.dev or asset-only surface

topolo-social-studio-queue

Config: Applications/topolo-social-studio/apps/queue-worker/wrangler.toml

Main: src/index.ts

Routes: workers.dev or asset-only surface

API Reference

Coverage: curated

Source: Applications/topolo-social-studio/package.json

Source exists in repo: yes

Package-level inventory entry pending dedicated docs migration.

App API page: /reference/apps/topolo-social-studio

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:

No Auth service ID mapped in docs yet.

API key scopes

No API key scopes were found in the checked-in Auth catalog for this system.

Service permissions

No role/permission catalog rows were found in the checked-in Auth permissions seed.

Data Ownership

d1

Binding: DB

Target: 5795da0f-0a68-4d5b-b420-761592a09330

Environment: default

Source: Applications/topolo-social-studio/apps/api-worker/wrangler.toml

r2

Binding: ASSET_BUCKET

Target: topolo-social-studio-assets

Environment: default

Source: Applications/topolo-social-studio/apps/api-worker/wrangler.toml

d1

Binding: DB

Target: TODO_CREATE_TOPOLO_SOCIAL_STUDIO_STAGING_D1

Environment: staging

Source: Applications/topolo-social-studio/apps/api-worker/wrangler.toml

r2

Binding: ASSET_BUCKET

Target: topolo-social-studio-staging-assets

Environment: staging

Source: Applications/topolo-social-studio/apps/api-worker/wrangler.toml

d1

Binding: DB

Target: 5795da0f-0a68-4d5b-b420-761592a09330

Environment: default

Source: Applications/topolo-social-studio/apps/queue-worker/wrangler.toml

r2

Binding: ASSET_BUCKET

Target: topolo-social-studio-assets

Environment: default

Source: Applications/topolo-social-studio/apps/queue-worker/wrangler.toml

d1

Binding: DB

Target: TODO_CREATE_TOPOLO_SOCIAL_STUDIO_STAGING_D1

Environment: staging

Source: Applications/topolo-social-studio/apps/queue-worker/wrangler.toml

r2

Binding: ASSET_BUCKET

Target: topolo-social-studio-staging-assets

Environment: staging

Source: Applications/topolo-social-studio/apps/queue-worker/wrangler.toml

Queues / Cron / Workflows

Queue bindings:

  • DESKTOP_SYNC_QUEUE_BINDING -> topolo-social-studio-sync
  • GENERATION_QUEUE -> topolo-social-studio-generation
  • DESKTOP_SYNC_QUEUE_BINDING -> topolo-social-studio-staging-sync (staging)
  • GENERATION_QUEUE -> topolo-social-studio-staging-generation (staging)

Cron triggers

No cron triggers were detected.

Workflow signals

  • DESKTOP_SYNC_QUEUE_BINDING -> topolo-social-studio-sync
  • GENERATION_QUEUE -> topolo-social-studio-generation
  • DESKTOP_SYNC_QUEUE_BINDING -> topolo-social-studio-staging-sync
  • GENERATION_QUEUE -> topolo-social-studio-staging-generation

Environment Variables and Bindings

Environment variables:

ADDITIONAL_ALLOWED_ORIGINS API_WORKER_URL APP_ENV AUTH_BASE_URL BILLING_SUPPORT_CONTACT DESKTOP_APP_URL DESKTOP_SYNC_QUEUE GENERATION_QUEUE_NAME MARKETING_APP_URL QUEUE_CONSUMER_NAME TOPOLO_AUTH_SERVICE_ID TOPOLO_BUG_REPORTER_URL TOPOLO_LAUNCHER_URL

All wrangler bindings

  • DB (d1) -> 5795da0f-0a68-4d5b-b420-761592a09330
  • ASSET_BUCKET (r2) -> topolo-social-studio-assets
  • DESKTOP_SYNC_QUEUE_BINDING (queue) -> topolo-social-studio-sync
  • GENERATION_QUEUE (queue) -> topolo-social-studio-generation
  • DB (d1) -> TODO_CREATE_TOPOLO_SOCIAL_STUDIO_STAGING_D1 [staging]
  • ASSET_BUCKET (r2) -> topolo-social-studio-staging-assets [staging]
  • DESKTOP_SYNC_QUEUE_BINDING (queue) -> topolo-social-studio-staging-sync [staging]
  • GENERATION_QUEUE (queue) -> topolo-social-studio-staging-generation [staging]
  • DB (d1) -> 5795da0f-0a68-4d5b-b420-761592a09330
  • ASSET_BUCKET (r2) -> topolo-social-studio-assets
  • DB (d1) -> TODO_CREATE_TOPOLO_SOCIAL_STUDIO_STAGING_D1 [staging]
  • ASSET_BUCKET (r2) -> topolo-social-studio-staging-assets [staging]

Deployments

Deployment environments: staging

Routes: workers.dev or Pages-only delivery

Observability enabled: yes

Wrangler surfaces

  • Applications/topolo-social-studio/apps/api-worker/wrangler.toml -> topolo-social-studio-api
  • Applications/topolo-social-studio/apps/queue-worker/wrangler.toml -> topolo-social-studio-queue

Build and deploy commands

  • build — Applications/topolo-social-studio/package.json :: pnpm -r --if-present build
  • desktop:build:local — Applications/topolo-social-studio/package.json :: pnpm --filter @topolo-social-studio/desktop desktop:build:local
  • desktop:build:staging — Applications/topolo-social-studio/package.json :: pnpm --filter @topolo-social-studio/desktop desktop:build:staging
  • desktop:build:production — Applications/topolo-social-studio/package.json :: pnpm --filter @topolo-social-studio/desktop desktop:build:production
  • build — Applications/topolo-social-studio/apps/api-worker/package.json :: tsc -p tsconfig.json --noEmit
  • build — Applications/topolo-social-studio/apps/desktop/package.json :: tsc -p tsconfig.json --noEmit && vite build
  • desktop:build — Applications/topolo-social-studio/apps/desktop/package.json :: tauri build
  • desktop:build:local — Applications/topolo-social-studio/apps/desktop/package.json :: node ./scripts/desktop-release.mjs build --environment local
  • desktop:build:staging — Applications/topolo-social-studio/apps/desktop/package.json :: node ./scripts/desktop-release.mjs build --environment staging
  • desktop:build:production — Applications/topolo-social-studio/apps/desktop/package.json :: node ./scripts/desktop-release.mjs build --environment production
  • build — Applications/topolo-social-studio/apps/marketing-web/package.json :: tsc -p tsconfig.json --noEmit && vite build
  • build — Applications/topolo-social-studio/apps/queue-worker/package.json :: tsc -p tsconfig.json --noEmit

Failure Modes

  • No Auth service ID is registered for this system.
  • No primary host is registered in the system registry.

Debugging Runbooks

Start with these entrypoints:

  • Applications/topolo-social-studio/apps/api-worker/wrangler.toml
  • Applications/topolo-social-studio/apps/queue-worker/wrangler.toml
  • Applications/topolo-social-studio/package.json
  • Applications/topolo-social-studio/README.md
  • Applications/topolo-social-studio/apps/api-worker/package.json
  • Applications/topolo-social-studio/apps/desktop/package.json
  • Applications/topolo-social-studio/apps/marketing-web/package.json
  • Applications/topolo-social-studio/apps/queue-worker/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.