Skip to content

Troubleshooting ​

DATABASE_URL is required ​

Ensure apps/api/.dev.vars exists and contains DATABASE_URL. For bun db:* scripts, also set it in packages/db/.env.

BETTER_AUTH_SECRET must be at least 32 characters ​

Generate one: openssl rand -hex 32

Invalid origin error from Better Auth ​

Add your origin to TRUSTED_ORIGINS in apps/api/src/index.ts.

tRPC UNAUTHORIZED errors ​

  • The API CORS config includes your frontend origin
  • credentials: true is set in the CORS config
  • The auth client baseURL matches the actual API URL

Mobile app can't reach the API ​

Use your LAN IP (192.168.x.x:8787) instead of localhost on physical devices.

bun db:generate produces no changes ​

Expected on first run if the drizzle/ folder is missing — it generates all tables from scratch.

Could not find module '@blazestack/...' ​

Run bun install from the repo root to restore workspace symlinks.

Cloudflare Worker Cannot read properties of undefined at startup ​

You have module-level code accessing process.env or performing I/O. Move createDb() and createAuth() inside the request handler or tRPC context factory.

Released under the MIT License.