Skip to main content

Overview

The public Tuturuuu QR generator lives in the Tools app (apps/tools) at https://tools.tuturuuu.com/qr. It reuses the shared @tuturuuu/ui/custom/qr/qr component. The standalone apps/qr app and the qr.tuturuuu.com host were retired when apps/tools was introduced; qr.tuturuuu.com to tools.tuturuuu.com/qr is an operator redirect, not application code. See Tools for the app as a whole. The generator is public and does not own workspace auth, app-session cookies, or protected APIs. Existing apps/web QR generator routes are compatibility redirects to the Tools app QR route. The Tools root layout uses @tuturuuu/satellite/providers, so the public QR surface still supports system, light, and dark theme switching through the shared next-themes shell.

Routing Contract

  • /qr on the Tools host: canonical QR generator.
  • /en/qr and /vi/qr: canonicalize back to /qr while storing NEXT_LOCALE.
  • apps/web /qr-generator: redirects to <tools origin>/qr.
  • apps/web /{wsId}/qr-generator: redirects to <tools origin>/qr without forwarding the workspace ID.
Query strings are preserved during compatibility redirects. The redirect target is built by buildQrAppUrl in apps/web/src/lib/qr-app-url.ts, which resolves the Tools origin through apps/web/src/lib/tools-app-url.ts.

Local Development

  • bun dev:tools starts the Tools app through Portless.
  • Local app origin: https://tools.tuturuuu.localhost.
  • Direct fallback port: 7825.
  • App URL overrides: TOOLS_APP_URL or NEXT_PUBLIC_TOOLS_APP_URL.

CI/CD

The QR generator ships with the Cloudflare Tools Worker. Use the Tools cutover packet for qualification and rollback.

Validation

Use these focused checks when changing QR routing or deployment wiring:
Because the QR route touches TypeScript, workflow config, docs navigation, and translations, finish QR changes with bun validate when the shared worktree state allows it.