Configuration Reference

Complete reference for environment variables, Wrangler configuration, and SvelteKit config.

Environment Variables

Authentication

# Auth.js secret for session encryption
AUTH_SECRET=random-string-32-chars

# Google OAuth
AUTH_GOOGLE_CLIENT_ID=xxx.apps.googleusercontent.com
AUTH_GOOGLE_CLIENT_SECRET=GOCSPX-xxx

# Microsoft Entra ID
AUTH_MICROSOFT_ENTRA_ID_ID=xxx
AUTH_MICROSOFT_ENTRA_ID_SECRET=xxx

Database

# Write database (Neon primary region)
WRITE_DATABASE_URL=postgres://user:[email protected]/neondb

# Read database (for queries)
READ_DATABASE_URL=postgres://user:[email protected]/neondb

# Read replicas for migrations (JSON)
READ_DATABASE_MIGRATION_ONLY_URLS={"EU":"postgres://...","APAC":"postgres://..."}

JWT Keys

# Private key for signing JWTs (RS256)
PRIVATE_JWK_JSON={"kty":"RSA","d":"...","n":"...","e":"...","kid":"xxx"}

# Public key for JWKS endpoint
PUBLIC_JWK_JSON={"kty":"RSA","n":"...","e":"...","kid":"xxx"}

Analytics

# PostHog project API key
PUBLIC_POSTHOG_API_KEY=phc_xxx

Cloudflare (Deployment)

# Cloudflare account ID
CLOUDFLARE_ACCOUNT_ID=xxx

# Cloudflare API token
CLOUDFLARE_API_TOKEN=xxx

# Cloudflare zone ID for DNS
CLOUDFLARE_ZONE_ID=xxx

Wrangler Configuration

File: wrangler.toml

The Wrangler configuration defines Worker settings, build commands, placement mode, R2 bindings, and environment-specific overrides. Key configurations:

• Placement Mode: Smart (intelligent routing)

• Compatibility: Node.js compatibility enabled

• R2 Bindings: IMAGES_BUCKET for file storage

For deployment strategies and smart placement details, see Architecture: Cloudflare Deployment.

SvelteKit Configuration

File: svelte.config.js

import adapter from '@sveltejs/adapter-cloudflare';
import { vitePreprocess } from '@sveltejs/vite-plugin-svelte';

export default {
	preprocess: vitePreprocess(),
	kit: {
		adapter: adapter()
	}
};

Vite Configuration

File: vite.config.ts

export default defineConfig({
	plugins: [
		sveltekit(),
		visualizer({
			// Bundle analyzer
			filename: 'dist/bundle-analysis.html',
			open: false
		})
	],
	build: {
		target: 'esnext',
		minify: 'esbuild',
		rollupOptions: {
			output: {
				manualChunks: (id) => {
					// Code splitting strategy
					if (id.includes('svelte')) return 'vendor';
					if (id.includes('chart.js')) return 'charts';
					// ...
				}
			}
		}
	}
});

Drizzle Configuration

File: drizzle.config.ts

export default defineConfig({
	schema: './src/lib/server/db/schema',
	dbCredentials: { url: process.env.WRITE_DATABASE_URL },
	dialect: 'postgresql',
	entities: {
		roles: {
			provider: 'neon',
			include: ['refresh_ai_db_admin']
		}
	}
});

TypeScript Configuration

File: tsconfig.json

{
	"extends": "./.svelte-kit/tsconfig.json",
	"compilerOptions": {
		"strict": true,
		"noUnusedLocals": true,
		"noUnusedParameters": true,
		"noImplicitReturns": true
	}
}

Related Documentation

• CLI Commands

• Environment Management

---

Last updated: October 2025