Drizzle Orm Drivers And Runtimes

1. Read references/database-runtime-matrix.md first.
2. If the task is serverless, edge, proxy, or performance-sensitive, read references/serverless-and-proxy-notes.md.
3. Match the runtime guide first, then adopt the import path and client example from that exact official guide.
4. Keep the chosen driver consistent across the app runtime and migration tooling.

When to deviate

• Split connection factories when the project genuinely spans multiple runtimes with different adapter needs.
• Use proxy-oriented or HTTP paths only when the deployment model actually requires them.
• Move to migrations skill when the hard problem is config or rollout rather than runtime connection setup.

Quick example

import { neon } from "@neondatabase/serverless";
import { drizzle } from "drizzle-orm/neon-http";

const sql = neon(process.env.DATABASE_URL!);
export const db = drizzle({ client: sql });

Guardrails

• Match driver imports to the actual runtime, not just the SQL dialect.
• Use the exact connect/get-started guide for the provider in front of you instead of porting assumptions across providers.
• Keep app runtime credentials and Drizzle Kit credentials aligned, but do not assume they share the same import surface.
• If a project spans local Node and edge/serverless runtimes, isolate the connection factories instead of forcing one adapter everywhere.
• Proxy-oriented or HTTP-based setups deserve their own connection guide; do not treat them as drop-in native-driver swaps.

Avoid

• choosing the driver by dialect name alone without checking runtime constraints
• copying provider setup across runtimes casually
• forcing one adapter across incompatible runtimes
• treating proxy/HTTP drivers as trivial native-driver replacements

Verification checklist

• the runtime and provider are identified first
• imports match the exact runtime guide
• app and migration tooling stay aligned
• multi-runtime apps isolate connection factories where needed
• proxy or HTTP setups are deliberate, not accidental

Common runtime surfaces

• PostgreSQL and hosted Postgres providers
• MySQL and PlanetScale/TiDB
• SQLite, Turso, D1, Durable Objects, Bun SQLite, Expo SQLite, OP-SQLite
• PGlite and Bun SQL
• AWS Data API
• Drizzle HTTP proxy

Maintenance

• Snapshot date: 2026-03-10
• Package snapshot: [email protected] latest

References

• references/database-runtime-matrix.md
• references/serverless-and-proxy-notes.md