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
/qron the Tools host: canonical QR generator./en/qrand/vi/qr: canonicalize back to/qrwhile storingNEXT_LOCALE.apps/web /qr-generator: redirects to<tools origin>/qr.apps/web /{wsId}/qr-generator: redirects to<tools origin>/qrwithout forwarding the workspace ID.
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:toolsstarts the Tools app through Portless.- Local app origin:
https://tools.tuturuuu.localhost. - Direct fallback port:
7825. - App URL overrides:
TOOLS_APP_URLorNEXT_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:bun validate when the shared worktree
state allows it.