Generators

A Prisma schema can have one or more generators, represented by the generator block:

generator client {

  provider = "prisma-client"

  output   = "../generated/prisma"

}

A generator determines which assets are created when you run the prisma generate command.

The default generator for Prisma Client is prisma-client, which outputs plain TypeScript code and requires a custom output path (read more about it in the blog post on generating into node_modules).

Alternatively, you can configure any npm package that complies with our generator specification.

The prisma-client generator gives you control over where Prisma Client is generated and how it is bundled across different JavaScript environments (such as ESM, Bun, Deno, ...).

It generates Prisma Client into a custom directory in your application's codebase that's specified via the output field on the generator block. This gives you full visibility and control over the generated code. It also splits the generated Prisma Client library into multiple files.

Here are the main differences compared to prisma-client-js:

• Requires an output path; no "magic" generation into node_modules any more
• Doesn't load .env at runtime; use dotenv or set environment variables manually instead
• Supports ESM and CommonJS via the moduleFormat field
• More flexible thanks to additional fields
• Outputs plain TypeScript that's bundled just like the rest of your application code

The prisma-client generator has been Generally Available since v6.16.0 and is the default generator as of Prisma ORM v7.

Follow these steps to use the new prisma-client generator in your project.

Update your generator block:

generator client {

  provider = "prisma-client"            // Required

  output   = "../src/generated/prisma"  // Required

}

The output option is required and tells Prisma ORM where to put the generated Prisma Client code. You can choose any location suitable for your project structure. For instance, if you have the following layout:

.

├── package.json

├── prisma

│   └── schema.prisma

├── src

│   └── index.ts

└── tsconfig.json

Then ../src/generated/prisma places the generated code in src/generated/prisma relative to schema.prisma.

Generate Prisma Client by running:

bunx prisma generate

pnpm prisma generate

yarn prisma generate

npx prisma generate

This generates the code for Prisma Client (including the query engine binary) into the specified output folder.

The new generator includes both the TypeScript client code and the query engine. Including the query engine in version control can cause compatibility issues on different machines. To avoid this, add the generated directory to .gitignore:

# Keep the generated Prisma Client + query engine out of version control

/src/generated/prisma

After generating the Prisma Client, import it from the path you specified:

import { PrismaClient } from "./generated/prisma/client";

const prisma = new PrismaClient();

Prisma Client is now ready to use in your project.

If you're importing types generated for your models, you can do so as follows:

import { UserModel, PostModel } from "./generated/prisma/models";

If you're importing types generated for your enums, you can do so as follows:

import { Role, User } from "./generated/prisma/enums";

If you need to access generated types in your frontend code, you can import them as follows:

import { Role } from "./generated/prisma/browser";

Note that ./generated/prisma/browser does not expose a PrismaClient.

Use the following options in the generator client { ... } block. Only output is required. The other fields have defaults or are inferred from your environment and tsconfig.json.

generator client {

  // Required

  provider = "prisma-client"

  output   = "../src/generated/prisma"

  // Optional

  engineType             = "client"

  runtime                = "nodejs"

  moduleFormat           = "esm"

  generatedFileExtension = "ts"

  importFileExtension    = "ts"

}

Below are the options for the prisma-client generator:

The new prisma-client generator creates individual .ts files which allow for a more fine granular import of types. This can improve compile and typecheck performance and be useful for tree-shaking, too. You can still use the top level barrel files that export all types through a single import.

The overall structure of the generated output looks like this:

generated/

└── prisma

    ├── browser.ts

    ├── client.ts

    ├── commonInputTypes.ts

    ├── enums.ts

    ├── internal

    │   ├── ...

    ├── models

    │   ├── Post.ts

    │   └── User.ts

    └── models.ts

For use in your server code.

• Provides access to the PrismaClient instance and all model and utility types.
• Provides best compatibility with the prisma-client-js generated output.
• Contains transitive dependencies on server only-packages, so cannot be used in browser contexts.

Example:

import { Prisma, type Post, PrismaClient } from "./generated/prisma/client";

For using types in your frontend (i.e. code that runs in the browser).

• Contains no transitive dependencies on Node.js or other server-only packages.
• Contains no real PrismaClient constructor.
• Contains all model and enum types and values.
• Provides access to various utilities like Prisma.JsonNull and Prisma.Decimal.
• Available since v6.16.0.

Example:

import { Prisma, type Post } from "./generated/prisma/browser";

Isolated access to user defined enum types and values.

• Contains no transitive dependencies and is very slim.
• Can be used on backend and frontend.
• Prefer this for optimal tree shaking and typecheck performance when accessing enums.

Example:

import { MyEnum } from "./generated/prisma/enums";

Isolated access to all model types.

• Can be used on backend and frontend.
• Contains all models including their derived utility types like <ModelName>WhereInput or <ModelName>UpdateInput>.

Example:

import type {

  UserModel,

  PostModel,

  PostWhereInput,

  UserUpdateInput,

} from "./generated/prisma/models";

Isolated access to the types for an individual model.

• Can be used on backend and frontend.
• Contains the models including its derived utility types like <ModelName>WhereInput or <ModelName>UpdateInput>.

Example:

import type { UserModel, UserWhereInput, UserUpdateInput } from "./generated/prisma/models/User";

Provides shared utility types that you should rarely directly need.

Example:

import type { IntFilter } from "./generated/prisma/commonInputTypes";

• Requires an output path on the generator block
• No Prisma.validator function; you can use TypeScript native satisfies keyword instead

To see what the new prisma-client generator looks like in practice, check out our minimal and ready-to-run examples:

The prisma-client-js generator requires the @prisma/client npm package and generates Prisma Client into node_modules.

The generator for Prisma's JavaScript Client accepts multiple additional properties:

• previewFeatures: Preview features to include
• binaryTargets: Engine binary targets for prisma-client-js (for example, debian-openssl-1.1.x if you are deploying to Ubuntu 18+, or native if you are working locally)

generator client {

  provider        = "prisma-client-js"

  previewFeatures = ["sample-preview-feature"]

  binaryTargets   = ["debian-openssl-1.1.x"] // defaults to `"native"`

}

The prisma-client-js generator uses several engines. Engines are implemented in Rust and are used by Prisma Client in the form of executable, platform-dependent engine files. Depending on which platform you are executing your code on, you need the correct file. "Binary targets" are used to define which files should be present for the target platform(s).

The correct file is particularly important when deploying your application to production, which often differs from your local development environment.

The native binary target is special. It doesn't map to a concrete operating system. Instead, when native is specified in binaryTargets, Prisma Client detects the current operating system and automatically specifies the correct binary target for it.

As an example, assume you're running macOS and you specify the following generator:

generator client {

  provider      = "prisma-client-js"

  binaryTargets = ["native"]

}

In that case, Prisma Client detects your operating system and finds the right binary file for it based on the list of supported operating systems . If you use macOS Intel x86 (darwin), then the binary file that was compiled for darwin will be selected. If you use macOS ARM64 (darwin-arm64), then the binary file that was compiled for darwin-arm64 will be selected.

Note: The native binary target is the default. You can set it explicitly if you wish to include additional binary targets for deployment to different environments.

The following is a list of community created generators.

• prisma-dbml-generator: Transforms the Prisma schema into Database Markup Language (DBML) which allows for an easy visual representation
• prisma-docs-generator: Generates an individual API reference for Prisma Client
• prisma-json-schema-generator: Transforms the Prisma schema in JSON schema
• prisma-json-types-generator: Enhances prisma-client-js (or prisma-client) to provide strongly typed JSON fields for all databases, based on your schema. It improves code generation, Intellisense, and more, without affecting runtime code.
• typegraphql-prisma: Generates TypeGraphQL CRUD resolvers for Prisma models
• typegraphql-prisma-nestjs: Fork of typegraphql-prisma, which also generates CRUD resolvers for Prisma models but for NestJS
• prisma-typegraphql-types-gen: Generates TypeGraphQL class types and enums from your prisma type definitions, the generated output can be edited without being overwritten by the next gen and has the ability to correct you when you mess up the types with your edits.
• nexus-prisma: Allows to project Prisma models to GraphQL via GraphQL Nexus
• prisma-nestjs-graphql: Generates object types, inputs, args, etc. from the Prisma Schema for usage with @nestjs/graphql module
• prisma-appsync: Generates a full-blown GraphQL API for AWS AppSync
• prisma-kysely: Generates type definitions for Kysely, a TypeScript SQL query builder. This can be useful to perform queries against your database from an edge runtime, or to write more complex SQL queries not possible in Prisma without dropping type safety.
• prisma-generator-nestjs-dto: Generates DTO and Entity classes with relation connect and create options for use with NestJS Resources and @nestjs/swagger
• prisma-erd-generator: Generates an entity relationship diagram
• prisma-generator-plantuml-erd: Generator to generate ER diagrams for PlantUML. Markdown and Asciidoc documents can also be generated by activating the option.
• prisma-class-generator: Generates classes from your Prisma Schema that can be used as DTO, Swagger Response, TypeGraphQL and so on.
• zod-prisma: Creates Zod schemas from your Prisma models.
• prisma-pothos-types: Makes it easier to define Prisma-based object types, and helps solve n+1 queries for relations. It also has integrations for the Relay plugin to make defining nodes and connections easy and efficient.
• prisma-generator-pothos-codegen: Auto generate input types (for use as args) and auto generate decoupled type-safe base files makes it easy to create customizable objects, queries and mutations for Pothos from Prisma schema. Optionally generate all crud at once from the base files.
• prisma-joi-generator: Generate full Joi schemas from your Prisma schema.
• prisma-yup-generator: Generate full Yup schemas from your Prisma schema.
• prisma-class-validator-generator: Emit TypeScript models from your Prisma schema with class validator validations ready.
• prisma-zod-generator: Emit Zod schemas from your Prisma schema.
• prisma-trpc-generator: Emit fully implemented tRPC routers.
• prisma-json-server-generator: Emit a JSON file that can be run with json-server.
• prisma-trpc-shield-generator: Emit a tRPC shield from your Prisma schema.
• prisma-custom-models-generator: Emit custom models from your Prisma schema, based on Prisma recommendations.
• nestjs-prisma-graphql-crud-gen: Generate CRUD resolvers from GraphQL schema with NestJS and Prisma.
• prisma-generator-dart: Generates Dart/Flutter class files with to- and fromJson methods.
• prisma-generator-graphql-typedef: Generates graphql schema.
• prisma-markdown: Generates markdown document composed with ERD diagrams and their descriptions. Supports pagination of ERD diagrams through @namespace comment tag.
• prisma-models-graph: Generates a bi-directional models graph for schema without strict relationship defined in the schema, works via a custom schema annotation.
• prisma-generator-fake-data: Generates realistic-looking fake data for your Prisma models that can be used in unit/integration tests, demos, and more.
• prisma-generator-drizzle: A Prisma generator for generating Drizzle schema with ease.
• prisma-generator-express: Generates Express CRUD and Router generator function.
• prismabox: Generates versatile typebox schema from your Prisma models.
• prisma-generator-typescript-interfaces: Generates zero-dependency TypeScript interfaces from your Prisma schema.
• prisma-openapi: Generates OpenAPI schema from Prisma models.
• @lexmata/prisma-ent-generator: Generates Go Ent schema files from your Prisma schema.