Initial commit

templates/drizzle.config.ts

@@ -0,0 +1,84 @@
+import { defineConfig } from 'drizzle-kit';
+
+/**
+ * Drizzle Kit Configuration for Cloudflare D1
+ *
+ * This configuration uses the D1 HTTP driver to connect to your Cloudflare D1
+ * database for running migrations, introspection, and Drizzle Studio.
+ *
+ * IMPORTANT: Never commit credentials to version control!
+ * Use environment variables for all sensitive data.
+ */
+export default defineConfig({
+  // Schema location (can be a single file or directory)
+  schema: './src/db/schema.ts',
+
+  // Output directory for generated migrations
+  // This should match the migrations_dir in wrangler.jsonc
+  out: './migrations',
+
+  // Database dialect (D1 is SQLite-based)
+  dialect: 'sqlite',
+
+  // Driver for connecting to D1 via HTTP API
+  driver: 'd1-http',
+
+  // Cloudflare credentials (from environment variables)
+  dbCredentials: {
+    accountId: process.env.CLOUDFLARE_ACCOUNT_ID!,
+    databaseId: process.env.CLOUDFLARE_DATABASE_ID!,
+    token: process.env.CLOUDFLARE_D1_TOKEN!,
+  },
+
+  // Enable verbose output for debugging
+  verbose: true,
+
+  // Enable strict mode (recommended)
+  strict: true,
+});
+
+/**
+ * How to get credentials:
+ *
+ * 1. CLOUDFLARE_ACCOUNT_ID
+ *    - Go to Cloudflare Dashboard
+ *    - Click on your account
+ *    - Account ID is shown in the right sidebar
+ *
+ * 2. CLOUDFLARE_DATABASE_ID
+ *    - Run: wrangler d1 list
+ *    - Find your database and copy the Database ID
+ *    - Or create a new database: wrangler d1 create my-database
+ *
+ * 3. CLOUDFLARE_D1_TOKEN
+ *    - Go to Cloudflare Dashboard → My Profile → API Tokens
+ *    - Click "Create Token"
+ *    - Use template "Edit Cloudflare Workers" or create custom token
+ *    - Make sure it has D1 permissions
+ */
+
+/**
+ * Create a .env file in your project root:
+ *
+ * CLOUDFLARE_ACCOUNT_ID=your-account-id-here
+ * CLOUDFLARE_DATABASE_ID=your-database-id-here
+ * CLOUDFLARE_D1_TOKEN=your-api-token-here
+ *
+ * Never commit .env to Git! Add it to .gitignore.
+ */
+
+/**
+ * Usage:
+ *
+ * # Generate migration from schema changes
+ * npx drizzle-kit generate
+ *
+ * # Push schema directly to database (dev only, not recommended for prod)
+ * npx drizzle-kit push
+ *
+ * # Open Drizzle Studio to browse your database
+ * npx drizzle-kit studio
+ *
+ * # Introspect existing database
+ * npx drizzle-kit introspect
+ */