Skip to main content
ThinkEx is a Cloudflare Worker app managed by Vite+. The repo pins Node 24 and expects the Vite+ managed environment for local work.

​
Prerequisites

  • Node.js 24 (>=24.11.0 <25) through Vite+ managed mode
  • pnpm 11
  • Docker, because local startup declares Cloudflare Container bindings
  • Infisical access for core team members, or a local .dev.vars file for contributors
If node, pnpm, or Corepack resolve to unexpected versions, run: 
vp env doctor

​
Install

vp install --frozen-lockfile

​
Run with Infisical

Core team members with Infisical access can run: 
pnpm dev
This injects dev:/app secrets and starts the dev server.

​
Run without Infisical

Contributors can use a local .dev.vars file: 
cp .dev.vars.example .dev.vars
pnpm serve:dev
Only two variables are required to boot the app: 
BETTER_AUTH_SECRET=local-development-secret
BETTER_AUTH_URL=http://localhost:3000
The auth page shows Continue as guest in local development, so Google OAuth credentials are not required for normal UI testing.

​
Force Local Cloudflare Bindings

Some bindings are remote by default. If you do not have Cloudflare credentials, run: 
CLOUDFLARE_VITE_FORCE_LOCAL=true pnpm serve:dev
This disables remote-only features such as deployed AI chat, browser rendering, and email invite delivery, but core workspace, document, and auth flows still run locally.

​
Database

Apply local D1 migrations before first auth or database use: 
pnpm db:migrate:local
The local D1 state persists under .wrangler/.

​
Docker

Docker must be running before the dev server starts because the Worker declares Cloudflare Containers for code execution and file conversion. The first startup may pull or build large images.

​
Validate Changes

pnpm verify
This runs Vite+ check, test, and build tasks with caching. For narrower local checks, use: 
pnpm check
pnpm test
pnpm build
pnpm doctor
pnpm doctor runs React Doctor against changed files. Use pnpm doctor:full when you intentionally want a full React scan.