prisma-generator-fake-data

^{_{Generated with Nano Banana Pro.}}

The easiest way to generate mock data based on your Prisma models!

What is prisma-generator-fake-data?

It's a Prisma Generator that uses faker.js to create realistic-looking fake data for your Prisma models. With this generator, you can quickly and easily create fake data for your Prisma models, without having to write barely any code.

Get started

• Setup your Prisma project as usual (Get Started With Prisma)

• Install this package

  • npm install -D prisma-generator-fake-data
  • yarn add -D prisma-generator-fake-data
  • pnpm install -D prisma-generator-fake-data
  • bun add -D prisma-generator-fake-data

• Modify your Prisma model file

  generator custom_generator {
      provider = "prisma-generator-fake-data"
      output   = "../types/fake-data.ts"
  }
  

• Run npx prisma generate

You're all done!

If you prefer, you can easily get started with this CodeSandbox.

Usage

Once the file is generated, you can import it in your project.

generator client {
  provider = "prisma-client-js"
}

generator custom_generator {
  provider = "prisma-generator-fake-data"
  /// by default, the file will be generated at `./prisma/fake-data.ts`
}

datasource db {
  provider = "postgresql"
  url      = env("DATABASE_URL")
}

model User {
  id       String        @id @default(cuid())
  email    String        @unique
  name     String
  /// Use comments to specify the faker method. For example:
  ///FAKE:faker.location.streetAddress({ useFullAddress: true })
  address  String
  ///FAKE:{notificationsEnabled: faker.datatype.boolean(), preferredColor: faker.color.rgb()}
  settings Json
  status   UserStatus
  profile  Profile?
}

model Profile {
  id                Int              @id @default(autoincrement())
  someConfiguration Boolean
  userId            String           @unique
  user              User             @relation(fields: [userId], references: [id])
}

enum UserStatus {
  active
  inactive
}

import { fakeUser, fakeProfileComplete } from './prisma/fake-data'; //or your custom output path

console.log(fakeUser());
console.log(fakeProfileComplete());
/*
{
  email: 'Ella.Mayer@gmail.com',
  name: 'Lana Gulgowski',
  age: 81,
  settings: { notificationsEnabled: true, preferredColor: '#ee5344' },
  maybeString: undefined,
  status: 'active'
}
{
  id: 96601,
  someConfiguration: true,
  userId: '821cf67a-dd86-49d7-b0e4-9ad451ad173d'
}
*/

Generator options

Fields with special treatment:

• name, fullName, firstName, lastName, and age will use specific faker-js methods to appear more realistic.
• If you have an optional Prisma field (e.g., message String?), the fake data generator will always return undefined for that property (customizable through the emptyValueAs option).
• If you have a JSON Prisma field, you can add your own data shape by adding a special comment above your field.
  • Example: ///FAKE:{test: faker.lorem.word()}
  • Keep in mind that the generator will simply relay whatever is after the FAKE: string to your generated code, so it needs to be valid TypeScript.
  • By using the extraImport generator option, you can create your own helper methods to generate fake data for your JSON fields

^{_{Inspired by https://github.com/toyamarinyon/prisma-factory-generator}}

^{_{This generator was bootstrapped using create-prisma-generator}}