Configuration

Required Variables

These variables must be set in your .env file:

Cloudflare Variables

Set these variables in your .dev.vars file for local development:

Optional Variables

Additional variables for specific features:

wrangler.toml Configuration

Configure your Cloudflare Workers settings in wrangler.toml:

name = "your-app-name"
main = "src/worker.ts"
compatibility_date = "2024-01-01"

[vars]
ENVIRONMENT = "production"

[[kv_namespaces]]
binding = "KV"
id = "your-kv-namespace-id"

[[d1_databases]]
binding = "DB"
database_name = "your-db-name"
database_id = "your-db-id"

D1 Database

Set up your D1 database:

1. 1. Create a new D1 database in the Cloudflare dashboard
2. 2. Copy the database ID to your wrangler.toml
3. 3. Run migrations: pnpm db:migrate

KV Storage

Set up KV namespaces:

1. 1. Create a KV namespace in the Cloudflare dashboard
2. 2. Add the namespace ID to wrangler.toml
3. 3. Use the KV binding in your code

Session Configuration

Configure authentication settings in src/utils/auth.ts:

• Session duration and expiry
• Password requirements
• Rate limiting settings
• OAuth providers (if used)

Production Deployment

Deploy your application:

pnpm run deploy

This will build your application and deploy it to Cloudflare Pages.

Environment Management

Set up environment variables in Cloudflare Pages:

1. 1. Go to your project settings in Cloudflare Pages
2. 2. Navigate to the Environment Variables section
3. 3. Add production variables
4. 4. Configure preview environments if needed

Analytics and Logging

• Configure Cloudflare Analytics
• Set up error tracking
• Monitor Workers performance
• Track API usage and quotas

Health Checks

Set up monitoring endpoints:

• API health check endpoint
• Database connection monitoring
• KV storage status
• External service dependencies