●Change8

Migrating to Drizzle ORM v1.0.0-beta.13

Version v1.0.0-beta.13 introduces 2 breaking changes. This guide details how to update your code.

Released: 2/2/2026

2
Breaking Changes
4
Migration Steps
12
Affected Symbols

⚠️ Check Your Code

If you use any of these symbols, you need to read this guide:

drizzle-kit.configdrizzle-orm/effect-postgresPgClient.layerdrizzlePgDrizzle.makeWithDefaultsPgDrizzle.makeEffectLogger.layerEffectLogger.DefaultEffectLogger.fromDrizzleEffectLogger.layerFromDrizzlePgDrizzle.DefaultServicesEffectCache.layerFromDrizzle

Breaking Changes

●Issue #1

The API for using Drizzle with Effect Postgres has been significantly updated to align better with Effect's style. Previously, users manually configured `PgClient.layer` and instantiated `drizzle(client, { logger: true, ... })`. Now, users should use `PgDrizzle.makeWithDefaults()` or `PgDrizzle.make({...})` and provide services like `PgClient.layer` and logging/caching layers separately.

●Issue #2

When using Effect Postgres, the default logger is now a no-op logger. To enable logging, you must explicitly provide `EffectLogger.layer` or a wrapped Drizzle logger via `Effect.provide`.

Migration Steps

  1. 1
    If using Drizzle Kit, replace `require()` calls in configuration/schema files with ES module syntax if you intend to use top-level await.
  2. 2
    When using `drizzle-orm/effect-postgres`, update initialization logic: replace manual `drizzle(client, ...)` instantiation with `PgDrizzle.makeWithDefaults()` or `PgDrizzle.make({...})`.
  3. 3
    If you relied on logging being enabled by default in Effect Postgres, you must now explicitly provide logging using `Effect.provide(EffectLogger.layer)` or similar.
  4. 4
    If using Effect Postgres, review the provided examples for correctly composing `PgClient.layer` and providing `PgDrizzle.DefaultServices`.

Release Summary

Drizzle Kit now supports top-level await in configuration and schema files, resolving module import errors. The Effect Postgres integration received major API updates to better align with Effect patterns, including configurable logging and caching layers.

Need More Details?

View the full release notes and all changes for Drizzle ORM v1.0.0-beta.13.

View Full Changelog