Next.js 15 Fullstack Web Apps · Lesson

CRUD Operations with Prisma Client

Perform Create, Read, Update, and Delete operations using the type-safe Prisma Client.

CRUD Operations with Prisma Client is a free Next.js 15 Fullstack Web Apps lesson on CoddyKit — lesson 3 of 4. You can read the complete lesson below for free — then practise it hands-on in the browser with a built-in code editor and a 24/7 AI tutor. It is part of the Next.js 15 Fullstack Web Apps learning path, one of 4 lessons in the course, and your progress syncs across the web and the CoddyKit app.

Intro to CRUD with Prisma

Welcome! In this lesson, we'll master CRUD operations using Prisma Client. CRUD stands for Create, Read, Update, and Delete – the four fundamental operations for interacting with any database.

Prisma Client provides a type-safe and intuitive way to perform these actions, making your database interactions efficient and less error-prone.

Instantiating Prisma Client

Before performing any database operations, you need to instantiate the Prisma Client. This client is automatically generated based on your schema.prisma file and connects your application to the database.

You'll typically do this once in your application's entry point or a dedicated database module.

import { PrismaClient } from '@prisma/client';

const prisma = new PrismaClient();

async function main() {
  console.log('Prisma Client initialized!');
  // Database operations go here
}

main()
  .catch(e => {
    console.error(e);
    process.exit(1);
  })
  .finally(async () => {
    await prisma.$disconnect();
  });

Create: Adding New Data

The Create operation adds new records to your database. With Prisma, you use the create method on a model to insert data.

Specify the model (e.g., prisma.user).
Provide the data for the new record in the data object.
Prisma handles the SQL insertion for you!

Remember, this assumes you have a User model defined in your schema.prisma.

Create: Adding a User Record

Let's create a new User record. Notice how Prisma Client provides autocompletion for fields like email and name, ensuring type safety.

Run this example to see a new user being added.

import { PrismaClient } from '@prisma/client';

const prisma = new PrismaClient();

async function main() {
  console.log('Creating a new user...');
  const newUser = await prisma.user.create({
    data: {
      email: 'alice@example.com',
      name: 'Alice Smith',
    },
  });
  console.log('Created user:', newUser.name, 'with ID:', newUser.id);
}

main()
  .catch(e => {
    console.error(e);
    process.exit(1);
  })
  .finally(async () => {
    await prisma.$disconnect();
  });

Read: Fetching Multiple Records

The Read operation retrieves data. To fetch multiple records, use the findMany method. You can filter results using the where clause, order them with orderBy, or limit them with take.

For example, prisma.user.findMany({ where: { name: 'Alice Smith' } }) would find all users named Alice Smith.

Read: Fetching Single Records

To fetch a single, unique record, use findUnique. This method requires a unique identifier (like an @id or @unique field in your schema) to ensure only one record is returned.

If you need to find the first record matching a non-unique condition, use findFirst. It returns null if no record is found.

Read: Users from the Database

Let's fetch all users and then find a specific user by their email using findUnique. This demonstrates how to retrieve both lists and individual items.

Run the code to see the results of these queries.

import { PrismaClient } from '@prisma/client';

const prisma = new PrismaClient();

async function main() {
  console.log('Fetching all users...');
  const allUsers = await prisma.user.findMany();
  console.log('All users:', allUsers.map(u => u.name).join(', '));

  console.log('Finding user by unique email...');
  const alice = await prisma.user.findUnique({
    where: {
      email: 'alice@example.com',
    },
  });
  if (alice) {
    console.log('Found Alice:', alice.name);
  } else {
    console.log('Alice not found.');
  }
}

main()
  .catch(e => {
    console.error(e);
    process.exit(1);
  })
  .finally(async () => {
    await prisma.$disconnect();
  });

Update: Modifying Existing Data

The Update operation changes existing records. The update method requires two main parts:

A where clause to identify the record(s) to update.
A data object containing the fields and new values to set.

Always ensure your where clause is specific enough to avoid unintended updates!

Update: Changing a User's Name

We'll update the user 'Alice Smith' to 'Alicia Wonderland'. Notice how we target the user with their unique email and then provide the new name.

After running, you can try fetching Alice again to see the updated name.

import { PrismaClient } from '@prisma/client';

const prisma = new PrismaClient();

async function main() {
  console.log('Updating user Alice Smith...');
  const updatedUser = await prisma.user.update({
    where: {
      email: 'alice@example.com',
    },
    data: {
      name: 'Alicia Wonderland',
    },
  });
  console.log('Updated user:', updatedUser.email, 'now named:', updatedUser.name);
}

main()
  .catch(e => {
    console.error(e);
    process.exit(1);
  })
  .finally(async () => {
    await prisma.$disconnect();
  });

Delete: Removing Data

Finally, the Delete operation removes records from your database. The delete method, like update, requires a where clause to specify which record(s) to remove.

Be cautious with delete operations, as they are permanent! Always double-check your where condition.

CRUD Operations Check

Which Prisma Client method would you use to remove a specific user record from the database?

Recap: CRUD with Prisma

Great job! You've learned the core of database interaction using Prisma Client.

Create (C): Use prisma.model.create() to add new records.
Read (R): Use prisma.model.findMany() for lists, findUnique() or findFirst() for single records.
Update (U): Use prisma.model.update() to modify existing records.
Delete (D): Use prisma.model.delete() to remove records.

Prisma's type safety and intuitive API make these essential operations straightforward and robust in your Next.js applications.

Frequently asked questions

Is the “CRUD Operations with Prisma Client” lesson free?

Yes — the full text of “CRUD Operations with Prisma Client” is free to read here on the web, and the Next.js 15 Fullstack Web Apps course includes 4 lessons in total. To practise it interactively (a built-in code editor and a 24/7 AI tutor) and unlock the rest of the Next.js 15 Fullstack Web Apps course, upgrade to CoddyKit PRO.

What will I learn in “CRUD Operations with Prisma Client”?

Perform Create, Read, Update, and Delete operations using the type-safe Prisma Client. You practise Next.js 15 Fullstack Web Apps with hands-on code you run directly in the browser, and a 24/7 AI tutor answers your questions as you work through the lesson.

Do I need any experience to start Next.js 15 Fullstack Web Apps?

No prior experience is required. Next.js 15 Fullstack Web Apps on CoddyKit is structured for beginners through advanced learners; this is — lesson 3 of 4, so you can start here or from the beginning and move at your own pace.

How long does the “CRUD Operations with Prisma Client” lesson take?

Most CoddyKit lessons take about 5–10 minutes. Each one is bite-sized and interactive, so you make steady progress and pick up exactly where you left off across the web and the app.

Can I write and run code in this Next.js 15 Fullstack Web Apps lesson?

Yes. Every Next.js 15 Fullstack Web Apps lesson includes a built-in code editor, so you write and run real code right in your browser and get instant AI feedback — no local setup required.

All lessons in this course

Introduction to Prisma ORM
Prisma Schema Design and Migrations
CRUD Operations with Prisma Client
Relations and Advanced Queries with Prisma

← Back to Next.js 15 Fullstack Web Apps