Kuest Auth Worker

Single-page Kuest API credential generator built for Cloudflare Workers.

The UI is a React/Vite static asset bundle, and all /api/* requests are handled by a native Cloudflare Worker.

Runtime

• UI: React + Vite + Tailwind CSS.
• Wallet: Reown AppKit + Wagmi.
• Server: Cloudflare Worker TypeScript.
• Database: PostgreSQL insert into public.key_emails.

Environment Variables

Public fixed config lives in wrangler.jsonc under vars: KUEST_CHAIN_MODE, SITE_NAME, APP_URL, APP_ICON, CLOB_URL, RELAYER_URL, and KUEST_DEBUG_ERRORS.

For local development, copy .dev.vars.example to .dev.vars. For production, set the remaining values as Worker secrets/variables in Cloudflare.

Keep .env.example as a reminder of the non-public values required for redeploys.

Variable	Description
REOWN_APPKIT_PROJECT_ID	Reown / WalletConnect project id
POSTGRES_URL	PostgreSQL connection string used by the Worker; include SSL settings if your provider requires them

Development

npm install
npm run dev

npm run dev runs the Vite + Cloudflare Worker dev environment. The app fetches runtime config from /api/config, so .dev.vars must include REOWN_APPKIT_PROJECT_ID.

Validation

npm run check
npm run build

Deploy

npm run deploy

The build emits:

• dist/client: static UI assets.
• dist/kuest_auth: Worker bundle and generated Wrangler config.

Database

Apply the SQL migrations in db/migrations to any PostgreSQL database before first deploy.

psql "$POSTGRES_URL" -f db/migrations/0001_key_emails.sql