application public active Verified 2026-04-26

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.

Canonical documentation for Topolo Quro 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: growth-platform

Source repos: PlatformApplications/TopoloQuro

Dependencies: topolo-auth, applications-packages

Repo shape

  • PlatformApplications/TopoloQuro/README.md
  • PlatformApplications/TopoloQuro/migration.config.ts
  • PlatformApplications/TopoloQuro/quro-system/
  • PlatformApplications/TopoloQuro/topolo.cloudcontrol.json

Runtime Surfaces

Hosts:

https://quro.topolo.app
quro-api

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

Main: index.js

Routes: workers.dev or asset-only surface

quro-redirect-system

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

Main: index.js

Routes: workers.dev or asset-only surface

quro-ui

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

Main: not declared

Routes: workers.dev or asset-only surface

quro-ui-legacy

Config: PlatformApplications/TopoloQuro/quro-system/quro-ui-legacy/wrangler.toml

Main: not declared

Routes: workers.dev or asset-only surface

API Reference

Coverage: curated

Source: PlatformApplications/TopoloDocs/src/content/public/applications/quro.mdx

Source exists in repo: yes

Canonical Quro coverage now lives in the docs application. The canonical browser callback delegates one-time sso_code redemption to the shared Topolo auth client and no longer exposes a /sso?token= bridge route. The canonical branded login surface completes embedded password sign-in through shared Auth persistence and app-owned navigation on quro.topolo.app. The browser keeps same-tab sessionStorage access-token restore enabled by default after login and refresh so normal reloads do not appear logged out before cookie refresh completes. The API worker now also exposes authenticated `GET /api/widget` for TopoloOne live workspace.

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

analytics.read

View QR analytics

Resource pattern: none

analytics.write

Manage QR analytics exports

Resource pattern: none

api_keys.write

Manage Quro machine credentials

Resource pattern: none

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

settings.read

View Quro settings

Resource pattern: none

settings.write

Manage Quro settings

Resource pattern: none

Service permissions

analytics:read, analytics:write, api_keys:write, codes:read, codes:write, series:read, series:write, settings:read, settings:write

Data Ownership

d1

Binding: QURO_METADATA

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

Environment: default

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

d1

Binding: QURO_METADATA

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

Environment: default

Source: PlatformApplications/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

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: yes

Wrangler surfaces

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

Build and deploy commands

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

Failure Modes

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

Debugging Runbooks

Start with these entrypoints:

  • PlatformApplications/TopoloQuro/quro-system/quro-api/wrangler.toml
  • PlatformApplications/TopoloQuro/quro-system/quro-redirect/wrangler.toml
  • PlatformApplications/TopoloQuro/quro-system/quro-ui/wrangler.toml
  • PlatformApplications/TopoloQuro/quro-system/quro-ui-legacy/wrangler.toml
  • PlatformApplications/TopoloDocs/src/content/public/applications/quro.mdx
  • PlatformApplications/TopoloQuro/README.md
  • PlatformApplications/TopoloQuro/quro-system/quro-api/package.json
  • PlatformApplications/TopoloQuro/quro-system/quro-redirect/package.json
  • PlatformApplications/TopoloQuro/quro-system/quro-ui/package.json
  • PlatformApplications/TopoloQuro/quro-system/quro-ui-legacy/package.json

Change Log / Verification

Lifecycle: active

Last verified: 2026-04-26

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