application public active Verified 2026-03-29

Topolo Studio

Studio surface currently packaged alongside Showcase branding in the repository.

Documentation Map

What It Is

Studio surface currently packaged alongside Showcase branding in the repository.

Media asset generator for SaaS and mobile applications.

Showcase enables teams to generate stunning visual assets from their software products - screenshots, recordings, and UI flows. Generated content can be bundled into Content Packs and exported directly to Topolo Socialize for scheduling.

Copy `.dev.vars.example` to `.dev.vars` and configure:

Architecture

Owners: media-platform

Source repos: Applications/TopoloStudio

Dependencies: topolo-auth

Repo shape

  • Applications/TopoloStudio/README.md
  • Applications/TopoloStudio/apps/
  • Applications/TopoloStudio/docs/
  • Applications/TopoloStudio/package.json
  • Applications/TopoloStudio/packages/
  • Applications/TopoloStudio/pnpm-lock.yaml
  • Applications/TopoloStudio/wrangler.toml

Runtime Surfaces

Hosts:

No primary host is registered.

showcase-prod-api

Config: Applications/TopoloStudio/wrangler.toml

Main: packages/worker/dist/index.js

Routes: workers.dev or asset-only surface

API Reference

Coverage: curated

Source: Applications/TopoloStudio/package.json

Source exists in repo: yes

Inventory-level entry until dedicated docs and API contracts are migrated.

App API page: /reference/apps/topolo-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

kv

Binding: SESSIONS_KV

Target: 128c4af779d141fc9486808e3fb58e9c

Environment: dev

Source: Applications/TopoloStudio/wrangler.toml

kv

Binding: CACHE_KV

Target: d21ababcdc5a47978d5c1f173a317105

Environment: dev

Source: Applications/TopoloStudio/wrangler.toml

d1

Binding: PRIMARY_DB

Target: 50c52756-5513-43f5-94a6-80f7d16deb15

Environment: dev

Source: Applications/TopoloStudio/wrangler.toml

r2

Binding: ASSETS_BUCKET

Target: topolo-studio-assets

Environment: dev

Source: Applications/TopoloStudio/wrangler.toml

kv

Binding: SESSIONS_KV

Target: studio-stage-kv-sessions

Environment: stage

Source: Applications/TopoloStudio/wrangler.toml

kv

Binding: CACHE_KV

Target: studio-stage-kv-cache

Environment: stage

Source: Applications/TopoloStudio/wrangler.toml

d1

Binding: PRIMARY_DB

Target: studio-stage-db-primary

Environment: stage

Source: Applications/TopoloStudio/wrangler.toml

r2

Binding: ASSETS_BUCKET

Target: studio-stage-assets

Environment: stage

Source: Applications/TopoloStudio/wrangler.toml

kv

Binding: SESSIONS_KV

Target: studio-prod-kv-sessions

Environment: prod

Source: Applications/TopoloStudio/wrangler.toml

kv

Binding: CACHE_KV

Target: studio-prod-kv-cache

Environment: prod

Source: Applications/TopoloStudio/wrangler.toml

d1

Binding: PRIMARY_DB

Target: studio-prod-db-primary

Environment: prod

Source: Applications/TopoloStudio/wrangler.toml

r2

Binding: ASSETS_BUCKET

Target: studio-prod-assets

Environment: prod

Source: Applications/TopoloStudio/wrangler.toml

Queues / Cron / Workflows

Queue bindings:

  • GENERATION_QUEUE -> studio-generation-queue (dev)
  • RENDER_QUEUE -> studio-render-queue (dev)
  • GENERATION_QUEUE -> studio-stage-queue-generation (stage)
  • RENDER_QUEUE -> studio-stage-queue-render (stage)
  • GENERATION_QUEUE -> studio-prod-queue-generation (prod)
  • RENDER_QUEUE -> studio-prod-queue-render (prod)

Cron triggers

No cron triggers were detected.

Workflow signals

  • GENERATION_QUEUE -> studio-generation-queue
  • RENDER_QUEUE -> studio-render-queue
  • GENERATION_QUEUE -> studio-stage-queue-generation
  • RENDER_QUEUE -> studio-stage-queue-render
  • GENERATION_QUEUE -> studio-prod-queue-generation
  • RENDER_QUEUE -> studio-prod-queue-render

Environment Variables and Bindings

Environment variables:

API_URL ENVIRONMENT ORG_SLUG SERVICE_ID SKIP_AUTH TOPOLO_AUTH_DOMAIN

All wrangler bindings

  • SESSIONS_KV (kv) -> 128c4af779d141fc9486808e3fb58e9c [dev]
  • CACHE_KV (kv) -> d21ababcdc5a47978d5c1f173a317105 [dev]
  • PRIMARY_DB (d1) -> 50c52756-5513-43f5-94a6-80f7d16deb15 [dev]
  • ASSETS_BUCKET (r2) -> topolo-studio-assets [dev]
  • GENERATION_QUEUE (queue) -> studio-generation-queue [dev]
  • RENDER_QUEUE (queue) -> studio-render-queue [dev]
  • SESSIONS_KV (kv) -> studio-stage-kv-sessions [stage]
  • CACHE_KV (kv) -> studio-stage-kv-cache [stage]
  • PRIMARY_DB (d1) -> studio-stage-db-primary [stage]
  • ASSETS_BUCKET (r2) -> studio-stage-assets [stage]
  • GENERATION_QUEUE (queue) -> studio-stage-queue-generation [stage]
  • RENDER_QUEUE (queue) -> studio-stage-queue-render [stage]
  • SESSIONS_KV (kv) -> studio-prod-kv-sessions [prod]
  • CACHE_KV (kv) -> studio-prod-kv-cache [prod]
  • PRIMARY_DB (d1) -> studio-prod-db-primary [prod]
  • ASSETS_BUCKET (r2) -> studio-prod-assets [prod]
  • GENERATION_QUEUE (queue) -> studio-prod-queue-generation [prod]
  • RENDER_QUEUE (queue) -> studio-prod-queue-render [prod]

Deployments

Deployment environments: dev, stage, prod

Routes: workers.dev or Pages-only delivery

Observability enabled: no explicit setting found

Wrangler surfaces

  • Applications/TopoloStudio/wrangler.toml -> showcase-prod-api

Build and deploy commands

  • build — Applications/TopoloStudio/package.json :: pnpm -r build
  • build:worker — Applications/TopoloStudio/package.json :: pnpm --filter @showcase/worker build
  • build:web — Applications/TopoloStudio/package.json :: pnpm --filter @showcase/web build
  • deploy — Applications/TopoloStudio/package.json :: pnpm build:worker && wrangler deploy --env prod
  • deploy:dev — Applications/TopoloStudio/package.json :: pnpm build:worker && wrangler deploy --env dev
  • deploy:stage — Applications/TopoloStudio/package.json :: pnpm build:worker && wrangler deploy --env stage
  • build — Applications/TopoloStudio/apps/web/package.json :: tsc && vite build
  • preview — Applications/TopoloStudio/apps/web/package.json :: vite preview
  • build — Applications/TopoloStudio/packages/infra/package.json :: tsc
  • build — Applications/TopoloStudio/packages/worker/package.json :: tsc
  • deploy — Applications/TopoloStudio/packages/worker/package.json :: wrangler deploy --env prod
  • deploy:dev — Applications/TopoloStudio/packages/worker/package.json :: wrangler deploy --env dev
  • deploy:stage — Applications/TopoloStudio/packages/worker/package.json :: wrangler deploy --env stage

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/TopoloStudio/wrangler.toml
  • Applications/TopoloStudio/package.json
  • Applications/TopoloStudio/README.md
  • Applications/TopoloStudio/apps/web/package.json
  • Applications/TopoloStudio/packages/infra/package.json
  • Applications/TopoloStudio/packages/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.