application public active Verified 2026-03-29

Topolo Quro

QR creation, redirect, and scan-tracking application with modern and legacy UI surfaces.

Documentation Map

What It Is

QR creation, redirect, and scan-tracking application with modern and legacy UI surfaces.

TopoloQuro is the Topolo QR creation, redirect, and scan-tracking application.

`Applications/TopoloQuro/quro-system/` contains the live surfaces that matter for the immediate roadmap:

Use `quro-system/quro-ui` as the primary UI surface.

Architecture

Owners: growth-platform

Source repos: Applications/TopoloQuro

Dependencies: topolo-auth

Repo shape

  • Applications/TopoloQuro/README.md
  • Applications/TopoloQuro/quro-system/

Runtime Surfaces

Hosts:

No primary host is registered.

quro-api

Config: Applications/TopoloQuro/quro-system/quro-api/wrangler.toml

Main: index.js

Routes: workers.dev or asset-only surface

quro-redirect-system

Config: Applications/TopoloQuro/quro-system/quro-redirect/wrangler.toml

Main: index.js

Routes: workers.dev or asset-only surface

quro-ui

Config: Applications/TopoloQuro/quro-system/quro-ui/wrangler.toml

Main: not declared

Routes: workers.dev or asset-only surface

API Reference

Coverage: readme

Source: Applications/TopoloQuro/README.md

Source exists in repo: yes

README identifies quro-api, quro-redirect, and the canonical current UI.

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

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_quro_api

API key scopes

codes.read

View generated codes

Resource pattern: none

codes.write

Manage generated codes

Resource pattern: none

series.read

View QR series

Resource pattern: none

series.write

Manage QR series

Resource pattern: none

analytics.read

View QR analytics

Resource pattern: none

analytics.write

Manage QR analytics exports

Resource pattern: none

settings.read

View Quro settings

Resource pattern: none

settings.write

Manage Quro settings

Resource pattern: none

Service permissions

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

Data Ownership

d1

Binding: QURO_METADATA

Target: 64df2761-0e21-403d-a1c1-88abb09448f3

Environment: default

Source: Applications/TopoloQuro/quro-system/quro-api/wrangler.toml

d1

Binding: QURO_METADATA

Target: 64df2761-0e21-403d-a1c1-88abb09448f3

Environment: default

Source: Applications/TopoloQuro/quro-system/quro-redirect/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:

APP_URL AUTH_BASE_URL SERVICE_ID VITE_API_BASE_URL VITE_SERVICE_ID kv_namespaces routes

All wrangler bindings

  • QURO_METADATA (d1) -> 64df2761-0e21-403d-a1c1-88abb09448f3
  • QURO_METADATA (d1) -> 64df2761-0e21-403d-a1c1-88abb09448f3

Deployments

Deployment environments: preview, production

Routes: workers.dev or Pages-only delivery

Observability enabled: no explicit setting found

Wrangler surfaces

  • Applications/TopoloQuro/quro-system/quro-api/wrangler.toml -> quro-api
  • Applications/TopoloQuro/quro-system/quro-redirect/wrangler.toml -> quro-redirect-system
  • Applications/TopoloQuro/quro-system/quro-ui/wrangler.toml -> quro-ui

Build and deploy commands

  • deploy — Applications/TopoloQuro/quro-system/quro-api/package.json :: wrangler deploy
  • deploy — Applications/TopoloQuro/quro-system/quro-redirect/package.json :: wrangler deploy
  • build — Applications/TopoloQuro/quro-system/quro-ui/package.json :: tsc -b && vite build
  • preview — Applications/TopoloQuro/quro-system/quro-ui/package.json :: vite preview --host 0.0.0.0 --port 3001
  • deploy — Applications/TopoloQuro/quro-system/quro-ui/package.json :: npm run build && wrangler pages deploy ./dist --project-name quro-ui
  • deploy:preview — Applications/TopoloQuro/quro-system/quro-ui/package.json :: npm run build && wrangler pages deploy ./dist --project-name quro-ui --env preview
  • deploy:github — Applications/TopoloQuro/quro-system/quro-ui-legacy/package.json :: npm run build:production && gh-pages -d .
  • deploy:netlify — Applications/TopoloQuro/quro-system/quro-ui-legacy/package.json :: npm run build:production && netlify deploy --prod
  • deploy:cloudflare — Applications/TopoloQuro/quro-system/quro-ui-legacy/package.json :: npm run build:production && wrangler pages deploy --project-name=quro-ui-legacy .
  • deploy — Applications/TopoloQuro/quro-system/quro-ui-legacy/package.json :: npm run deploy:cloudflare
  • build:production — Applications/TopoloQuro/quro-system/quro-ui-legacy/package.json :: echo 'Preparing legacy reference files for deployment...'

Failure Modes

  • No primary host is registered in the system registry.

Debugging Runbooks

Start with these entrypoints:

  • Applications/TopoloQuro/quro-system/quro-api/wrangler.toml
  • Applications/TopoloQuro/quro-system/quro-redirect/wrangler.toml
  • Applications/TopoloQuro/quro-system/quro-ui/wrangler.toml
  • Applications/TopoloQuro/README.md
  • Applications/TopoloQuro/quro-system/quro-api/package.json
  • Applications/TopoloQuro/quro-system/quro-redirect/package.json
  • Applications/TopoloQuro/quro-system/quro-ui/package.json
  • Applications/TopoloQuro/quro-system/quro-ui-legacy/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.