# drizzle-team/drizzle-orm architecture

> Architecture diagram of the GitHub repository drizzle-team/drizzle-orm, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-10). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/drizzle-team/drizzle-orm
- Repository: https://github.com/drizzle-team/drizzle-orm

## Overview

Drizzle is a TypeScript ORM ecosystem: developers declare schemas and build typed SQL-like or relational queries, then execute them through database-specific drivers. Drizzle Kit handles schema inspection and migration workflows; Drizzle Seed generates and inserts related test data. The README also documents Studio and validation-schema integrations. The graph preserves these major capabilities, but sampled implementation excerpts are limited, so undocumented internal calls are not inferred; unsampled subsystems use exact directory paths from the tree.

Main entry points: [`drizzle-kit/src/index.ts`](https://github.com/drizzle-team/drizzle-orm/blob/main/drizzle-kit/src/index.ts) (Kit CLI), [`drizzle-seed/src/services/SeedService.ts`](https://github.com/drizzle-team/drizzle-orm/blob/main/drizzle-seed/src/services/SeedService.ts) (Seed Service), [`drizzle-orm/src/mysql-core/query-builders/select.ts`](https://github.com/drizzle-team/drizzle-orm/blob/main/drizzle-orm/src/mysql-core/query-builders/select.ts) (Typed Query Builders), [`drizzle-seed/src/index.ts`](https://github.com/drizzle-team/drizzle-orm/blob/main/drizzle-seed/src/index.ts) (Seed API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_orm["Typed ORM"]
  node_schema["Schema Declaration<br/>[table.ts]"]
  node_query["Typed Query Builders<br/>[select.ts]"]
  node_pgquery["Postgres Queries<br/>[query-builder.ts]"]
  node_subquery["Subqueries<br/>[subquery.ts]"]
  node_relational["Relational Queries<br/>[query.ts]"]
  node_dialects["SQL Dialects<br/>[dialect.ts]"]
  node_sessions["Database Sessions<br/>[session.ts]"]
  node_drivers["Database Drivers<br/>[driver.ts]"]
end

subgraph group_kit["Schema and Migrations"]
  node_kitcli["Kit CLI<br/>[index.ts]"]
  node_validation["Schema Validation<br/>[schemaValidator.ts]"]
  node_serialize["Schema Serializers"]
  node_introspect["Database Introspection<br/>[introspect-pg.ts]"]
  node_migrations["Migration Workflows<br/>[migrate.ts]"]
  node_push["Schema Push<br/>[push.ts]"]
  node_studio["Drizzle Studio<br/>[studio.ts]"]
end

subgraph group_seed["Data Seeding"]
  node_seedapi["Seed API<br/>[index.ts]"]
  node_seedservice["Seed Service<br/>[SeedService.ts]"]
  node_generators["Value Generators<br/>[Generators.ts]"]
  node_generatorfuncs["Generator Functions<br/>[GeneratorFuncs.ts]"]
  node_seedtypes["Seed Model Types<br/>[seedService.ts]"]
  node_firstnames["Name Dataset<br/>[firstNames.ts]"]
end

subgraph group_integrations["Schema Integrations"]
  node_zod["Zod Schemas<br/>[schema.ts]"]
  node_typebox["TypeBox Schemas<br/>[schema.ts]"]
  node_valibot["Valibot Schemas<br/>[schema.ts]"]
  node_arktype["ArkType Schemas<br/>[schema.ts]"]
end

node_developer(("Developer"))
node_database[("SQL Databases")]

node_developer -->|"declares schema"| node_schema
node_developer -->|"builds queries"| node_query
node_query -.->|"executes SQL"| node_database
node_developer -->|"runs migrations"| node_kitcli
node_kitcli -->|"validates config"| node_validation
node_validation -->|"selects schema format"| node_serialize
node_kitcli -.->|"inspects database"| node_introspect
node_kitcli -.->|"applies migrations"| node_migrations
node_kitcli -->|"pushes changes"| node_push
node_kitcli -->|"provides browsing"| node_studio
node_developer -->|"seeds data"| node_seedapi
node_seedapi -->|"creates generators"| node_seedservice
node_seedservice -->|"selects generators"| node_generators
node_seedservice -->|"uses generator functions"| node_generatorfuncs
node_generators -->|"uses name data"| node_firstnames
node_seedservice -->|"uses seed types"| node_seedtypes
node_seedapi -->|"inserts generated data"| node_database
node_developer -->|"derives schemas"| node_zod
node_developer -.->|"derives schemas"| node_typebox
node_developer -.->|"derives schemas"| node_valibot
node_developer -.->|"derives schemas"| node_arktype
node_pgquery -->|"builds selects"| node_query
node_relational -.->|"executes relational query"| node_database
node_query -.->|"supports subqueries"| node_subquery
node_drivers -.->|"connects to"| node_database

click node_schema "https://github.com/drizzle-team/drizzle-orm/blob/main/drizzle-orm/src/table.ts"
click node_query "https://github.com/drizzle-team/drizzle-orm/blob/main/drizzle-orm/src/mysql-core/query-builders/select.ts"
click node_pgquery "https://github.com/drizzle-team/drizzle-orm/blob/main/drizzle-orm/src/pg-core/query-builders/query-builder.ts"
click node_subquery "https://github.com/drizzle-team/drizzle-orm/blob/main/drizzle-orm/src/subquery.ts"
click node_relational "https://github.com/drizzle-team/drizzle-orm/blob/main/drizzle-orm/src/sqlite-core/query-builders/query.ts"
click node_dialects "https://github.com/drizzle-team/drizzle-orm/blob/main/drizzle-orm/src/mysql-core/dialect.ts"
click node_sessions "https://github.com/drizzle-team/drizzle-orm/blob/main/drizzle-orm/src/mysql-core/session.ts"
click node_drivers "https://github.com/drizzle-team/drizzle-orm/blob/main/drizzle-orm/src/node-postgres/driver.ts"
click node_kitcli "https://github.com/drizzle-team/drizzle-orm/blob/main/drizzle-kit/src/index.ts"
click node_validation "https://github.com/drizzle-team/drizzle-orm/blob/main/drizzle-kit/src/schemaValidator.ts"
click node_serialize "https://github.com/drizzle-team/drizzle-orm/tree/main/drizzle-kit/src/serializer"
click node_introspect "https://github.com/drizzle-team/drizzle-orm/blob/main/drizzle-kit/src/introspect-pg.ts"
click node_migrations "https://github.com/drizzle-team/drizzle-orm/blob/main/drizzle-kit/src/cli/commands/migrate.ts"
click node_push "https://github.com/drizzle-team/drizzle-orm/blob/main/drizzle-kit/src/cli/commands/push.ts"
click node_studio "https://github.com/drizzle-team/drizzle-orm/blob/main/drizzle-kit/src/serializer/studio.ts"
click node_seedapi "https://github.com/drizzle-team/drizzle-orm/blob/main/drizzle-seed/src/index.ts"
click node_seedservice "https://github.com/drizzle-team/drizzle-orm/blob/main/drizzle-seed/src/services/SeedService.ts"
click node_generators "https://github.com/drizzle-team/drizzle-orm/blob/main/drizzle-seed/src/services/Generators.ts"
click node_generatorfuncs "https://github.com/drizzle-team/drizzle-orm/blob/main/drizzle-seed/src/services/GeneratorFuncs.ts"
click node_seedtypes "https://github.com/drizzle-team/drizzle-orm/blob/main/drizzle-seed/src/types/seedService.ts"
click node_firstnames "https://github.com/drizzle-team/drizzle-orm/blob/main/drizzle-seed/src/datasets/firstNames.ts"
click node_zod "https://github.com/drizzle-team/drizzle-orm/blob/main/drizzle-zod/src/schema.ts"
click node_typebox "https://github.com/drizzle-team/drizzle-orm/blob/main/drizzle-typebox/src/schema.ts"
click node_valibot "https://github.com/drizzle-team/drizzle-orm/blob/main/drizzle-valibot/src/schema.ts"
click node_arktype "https://github.com/drizzle-team/drizzle-orm/blob/main/drizzle-arktype/src/schema.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_schema,node_query,node_pgquery,node_subquery,node_relational,node_dialects,node_sessions,node_drivers toneBlue
class node_kitcli,node_validation,node_serialize,node_introspect,node_migrations,node_push,node_studio,node_database toneAmber
class node_seedapi,node_seedservice,node_generators,node_generatorfuncs,node_seedtypes,node_firstnames toneMint
class node_zod,node_typebox,node_valibot,node_arktype toneRose
class node_developer toneIndigo
```

## Components

### Typed ORM

- [Schema Declaration](https://github.com/drizzle-team/drizzle-orm/blob/main/drizzle-orm/src/table.ts): `drizzle-orm/src/table.ts`
- [Typed Query Builders](https://github.com/drizzle-team/drizzle-orm/blob/main/drizzle-orm/src/mysql-core/query-builders/select.ts): `drizzle-orm/src/mysql-core/query-builders/select.ts`
- [Postgres Queries](https://github.com/drizzle-team/drizzle-orm/blob/main/drizzle-orm/src/pg-core/query-builders/query-builder.ts): `drizzle-orm/src/pg-core/query-builders/query-builder.ts`
- [Subqueries](https://github.com/drizzle-team/drizzle-orm/blob/main/drizzle-orm/src/subquery.ts): `drizzle-orm/src/subquery.ts`
- [Relational Queries](https://github.com/drizzle-team/drizzle-orm/blob/main/drizzle-orm/src/sqlite-core/query-builders/query.ts): `drizzle-orm/src/sqlite-core/query-builders/query.ts`
- [SQL Dialects](https://github.com/drizzle-team/drizzle-orm/blob/main/drizzle-orm/src/mysql-core/dialect.ts): `drizzle-orm/src/mysql-core/dialect.ts`
- [Database Sessions](https://github.com/drizzle-team/drizzle-orm/blob/main/drizzle-orm/src/mysql-core/session.ts): `drizzle-orm/src/mysql-core/session.ts`
- [Database Drivers](https://github.com/drizzle-team/drizzle-orm/blob/main/drizzle-orm/src/node-postgres/driver.ts): `drizzle-orm/src/node-postgres/driver.ts`

### Schema and Migrations

- [Kit CLI](https://github.com/drizzle-team/drizzle-orm/blob/main/drizzle-kit/src/index.ts): `drizzle-kit/src/index.ts`
- [Schema Validation](https://github.com/drizzle-team/drizzle-orm/blob/main/drizzle-kit/src/schemaValidator.ts): `drizzle-kit/src/schemaValidator.ts`
- [Schema Serializers](https://github.com/drizzle-team/drizzle-orm/tree/main/drizzle-kit/src/serializer): `drizzle-kit/src/serializer`
- [Database Introspection](https://github.com/drizzle-team/drizzle-orm/blob/main/drizzle-kit/src/introspect-pg.ts): `drizzle-kit/src/introspect-pg.ts`
- [Migration Workflows](https://github.com/drizzle-team/drizzle-orm/blob/main/drizzle-kit/src/cli/commands/migrate.ts): `drizzle-kit/src/cli/commands/migrate.ts`
- [Schema Push](https://github.com/drizzle-team/drizzle-orm/blob/main/drizzle-kit/src/cli/commands/push.ts): `drizzle-kit/src/cli/commands/push.ts`
- [Drizzle Studio](https://github.com/drizzle-team/drizzle-orm/blob/main/drizzle-kit/src/serializer/studio.ts): `drizzle-kit/src/serializer/studio.ts`

### Data Seeding

- [Seed API](https://github.com/drizzle-team/drizzle-orm/blob/main/drizzle-seed/src/index.ts): `drizzle-seed/src/index.ts`
- [Seed Service](https://github.com/drizzle-team/drizzle-orm/blob/main/drizzle-seed/src/services/SeedService.ts): `drizzle-seed/src/services/SeedService.ts`
- [Value Generators](https://github.com/drizzle-team/drizzle-orm/blob/main/drizzle-seed/src/services/Generators.ts): `drizzle-seed/src/services/Generators.ts`
- [Generator Functions](https://github.com/drizzle-team/drizzle-orm/blob/main/drizzle-seed/src/services/GeneratorFuncs.ts): `drizzle-seed/src/services/GeneratorFuncs.ts`
- [Seed Model Types](https://github.com/drizzle-team/drizzle-orm/blob/main/drizzle-seed/src/types/seedService.ts): `drizzle-seed/src/types/seedService.ts`
- [Name Dataset](https://github.com/drizzle-team/drizzle-orm/blob/main/drizzle-seed/src/datasets/firstNames.ts): `drizzle-seed/src/datasets/firstNames.ts`

### Schema Integrations

- [Zod Schemas](https://github.com/drizzle-team/drizzle-orm/blob/main/drizzle-zod/src/schema.ts): `drizzle-zod/src/schema.ts`
- [TypeBox Schemas](https://github.com/drizzle-team/drizzle-orm/blob/main/drizzle-typebox/src/schema.ts): `drizzle-typebox/src/schema.ts`
- [Valibot Schemas](https://github.com/drizzle-team/drizzle-orm/blob/main/drizzle-valibot/src/schema.ts): `drizzle-valibot/src/schema.ts`
- [ArkType Schemas](https://github.com/drizzle-team/drizzle-orm/blob/main/drizzle-arktype/src/schema.ts): `drizzle-arktype/src/schema.ts`

### Other components

- **Developer**
- **SQL Databases**

## Connections

- Developer → Schema Declaration: declares schema
- Developer → Typed Query Builders: builds queries
- Typed Query Builders → SQL Databases: executes SQL
- Developer → Kit CLI: runs migrations
- Kit CLI → Schema Validation: validates config (evidence: `drizzle-kit/src/index.ts`)
- Schema Validation → Schema Serializers: selects schema format (evidence: `drizzle-kit/src/schemaValidator.ts`)
- Kit CLI → Database Introspection: inspects database
- Kit CLI → Migration Workflows: applies migrations
- Kit CLI → Schema Push: pushes changes
- Kit CLI → Drizzle Studio: provides browsing
- Developer → Seed API: seeds data
- Seed API → Seed Service: creates generators (evidence: `drizzle-seed/src/index.ts`)
- Seed Service → Value Generators: selects generators (evidence: `drizzle-seed/src/services/SeedService.ts`)
- Seed Service → Generator Functions: uses generator functions (evidence: `drizzle-seed/src/services/SeedService.ts`)
- Value Generators → Name Dataset: uses name data (evidence: `drizzle-seed/src/services/Generators.ts`)
- Seed Service → Seed Model Types: uses seed types (evidence: `drizzle-seed/src/services/SeedService.ts`)
- Seed API → SQL Databases: inserts generated data (evidence: `drizzle-seed/src/index.ts`)
- Developer → Zod Schemas: derives schemas
- Developer → TypeBox Schemas: derives schemas
- Developer → Valibot Schemas: derives schemas
- Developer → ArkType Schemas: derives schemas
- Postgres Queries → Typed Query Builders: builds selects (evidence: `drizzle-orm/src/pg-core/query-builders/query-builder.ts`)
- Relational Queries → SQL Databases: executes relational query
- Typed Query Builders → Subqueries: supports subqueries
- Database Drivers → SQL Databases: connects to
