Ruheni Alex for Prisma

Posted on Feb 18, 2021 • Updated on Jan 11, 2023

Adding an API and database to your Nuxt App with Prisma

#javascript #nuxt #vue #express

Note: The application is built using Nuxt version 2 at the time it was written. Prisma runs on the server-side and you can use Nuxt version 3's server routes to add database access to your application without using Express.

If you would like to try out Prisma with Nuxt 3, check out sidebase. You can quickly set up a project by running npm create sidebase@latest and select Prisma in the modules prompt.

Building fullstack applications has never been easier using Nuxt. It provides a Vue framework for building blazing fast server-side rendered and static applications. Prisma is an ORM that offers developers a type-safe database client (currently supports PostgreSQL, MySQL, SQLite, SQL Server, CockroachDB and MongoDB). This is useful when building APIs and is intuitive for both beginners and experienced developers.

Nuxt presents two options for building fullstack applications:

Using Nuxt programmatically - setting up your own server with your middleware and API.
serverMiddleware - this is an extension of your Nuxt app that allows you to create additional routes without setting up an external server. The middleware is registered on application start.

In this article, you’ll learn how to add an API in your Nuxt application using Prisma for your database access and Nuxt’s serverMiddleware property.

Prerequisites

Before you start, ensure you have Node.js installed. If you are using Visual Studio Code, you can supercharge your development experience by installing the Prisma extension for auto-completion, formatting, and syntax highlighting.

The completed project is available on GitHub.

Step 0: Initialize your Nuxt application

The first step is initializing your Nuxt application.

npx create-nuxt-app awesome-nuxt-app

You’ll be asked a couple of questions such as the name of the projects, linter, testing framework, etc. Keep the app simple and go with the default options provided. To learn more about the options, head over to Create Nuxt App.

cd awesome-nuxt-app
npm run dev

Congratulations! Your application is now running on http://localhost:3000 🥳.

Step 1: Add Prisma to your app

Now that your Nuxt application is running, the next step is to set up Prisma. You’ll first install the Prisma CLI as a dev dependency by running the following command:

npm install --save-dev prisma

Initialize Prisma

Once the installation is complete, run the following command:

npx prisma init

The command above creates a folder called prisma at the root of your project which contains a file called schema.prisma and a .env file at the root of the project. The schema.prisma defines your database connection and Prisma Client generator. For this example, you’ll use SQLite for ease of setting up. If you’d like to use another database provider, switching is as simple as renaming the provider from sqlite to your provider of choice without any additional setup and updating the connection URL.

For our example, you’ll define two tables: Post and User with a one-to-many relationship between User and Post. Update your schema.prisma file to resemble this one:

// schema.prisma
datasource db {
  provider = "sqlite"
  url      = "file:./dev.db"
}

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

model Post {
  id        Int      @id @default(autoincrement())
  title     String
  content   String?
  createdAt DateTime @default(now())
  updatedAt DateTime @updatedAt
  published Boolean  @default(false)
  author    User?    @relation(fields: [authorId], references: [id])
  authorId  Int?
}

model User {
  id    Int     @id @default(autoincrement())
  email String  @unique
  name  String?
  posts Post[]
}

Create your first database migration

To sync your data model to your database schema, you’ll need to use prisma migrate CLI.

npx prisma migrate dev --name init

The above command will create a migration called init located in the /prisma/migrations directory. The migrations folder is used to keep track of schema changes for our database. Think of it as version control, but for your database schema. The Prisma CLI also creates your dev.db database.

After prisma migrate is done creating a migration, the Prisma CLI installs @prisma/client package and generates Prisma Client.

Prisma Client is an auto-generated and type-safe query builder tailored to your database schema. prisma migrate will update your Prisma Client every time you run a migration.

Note: The above features are now in General Availability and your feedback will be highly appreciated and will help us keep improving them. 🙂

Step 2: Add your `serverMiddleware` endpoints

For your API, you will use Express inside Nuxt to create our API. Sounds crazy, right?

Well, Express is used to allow your API endpoints to access the request and response objects.

Go ahead and install Express:

npm install express

Create an api folder and an index.js file that will contain your API handlers:

mkdir api
touch api/index.js

After creating your /api/index.js file, paste in the following code in index.js:

// index.js
import express from 'express'
import { PrismaClient } from '@prisma/client'

const prisma = new PrismaClient()
const app = express()

app.use(express.json())

/** 
* logic for our api will go here
*/
export default {
  path: '/api',
  handler: app
}

The above code initializes Express and Prisma and exports two properties, path and handler, which will be registered in nuxt.config.js in Step 3. The path property specifies the route the middleware will be accessible, and handler specifies the function executed when invoked. For the rest of this step, you’ll be working in index.js setting up the endpoints and their respective handlers.

Create a `User`

The first feature you’ll be implementing is creating a user/ author. The database will be expecting an email and an optional name. It’s implementation is as follows:

// index.js
app.post(`/user`, async (req, res) => {
  const result = await prisma.user.create({
    data: {
      email: req.body.email,
      name: req.body.name,
    },
  })
  res.json(result)
})

Creating a `Post`

Next, you’ll add the create post endpoint. The request body will expect a title, content and authorEmail. If an author doesn’t exist in the database, their user record will be created.

// index.js
app.post('/post', async (req, res) => {
  const { title, content, authorEmail } = req.body
  const post = await prisma.post.create({
    data: {
      title,
      content,
      author: {
        connectOrCreate: {
          email: authorEmail
        }
      }
    }
  })
  res.status(200).json(post)
})

Get drafts

Once that is done, you’ll need to be able to view all unpublished posts. Prisma lets you specify all relations you’d like to be returned in the response with the include property. This is where you’ll add the author relation query to view the respective posts as well as their authors.

// index.js
app.get('/drafts', async (req, res) => {
  const posts = await prisma.post.findMany({
    where: { published: false },
    include: { author: true }
  })
  res.json(posts)
})

Get `Post` by `Id`

You can get a post by it’s id using findUnique as follows:

// index.js
app.get('/post/:id', async (req, res) => {
  const { id } = req.params
  const post = await prisma.post.findUnique({
    where: {
      id: Number(id),
    },
    include: { author: true }
  })
  res.json(post)
})

Publish a `Post`

When a Post is ready to go live update the published field:

// index.js
app.put('/publish/:id', async (req, res) => {
  const { id } = req.params
  const post = await prisma.post.update({
    where: {
      id: Number(id),
    },
    data: { published: true },
  })
  res.json(post)
})

Get Feed

All your published posts can be made available on the /feed endpoint, filtering them by checking that the published property is set to true.

// index.js
app.get('/feed', async (req, res) => {
  const posts = await prisma.post.findMany({
    where: { published: true },
    include: { author: true },
  })
  res.json(posts)
})

Deleting a `Post`

The last CRUD feature is deleting a Post record in your database:

// index.js
app.delete(`/post/:id`, async (req, res) => {
  const { id } = req.params
  const post = await prisma.post.delete({
    where: {
      id: parseInt(id),
    },
  })
  res.json(post)
})

The final feature in your application is filtering posts, checking if the searchString is found in either the title or content of your Posts.

Search for a `Post`

// index.js
app.get('/filterPosts', async (req, res) => {
  const { searchString } = req.query
  const draftPosts = await prisma.post.findMany({
    where: {
      OR: [
        {
          title: {
            contains: searchString,
          },
        },
        {
          content: {
            contains: searchString,
          },
        },
      ],
    },
  })
  res.send(draftPosts)
})

Step 3: Modify `nuxt.config.js`

The last step is registering your serverMiddleware in nuxt.config.js which is as simple as this.

// nuxt.config.js
  serverMiddleware: [
    '~/api/index.js'
  ]

Step 4: Take your API for a spin

Once you’ve modified nuxt.config.js, make sure to restart your Nuxt app. You can use Prisma Studio to create your database records. Alternatively, you can use your favorite API testing tool - for example Postman,Insomnia or REST Client - to test your API by making HTTP requests against your API.

In a new terminal window, use the Prisma CLI to startup Prisma Studio.

npx prisma studio

The command opens Prisma studio on localhost:5555.

Create a couple of User and Post records on Prisma Studio and save your changes.

Since the post isn’t published yet, fetch a list of the drafted posts using the GET api/drafts endpoint.

Congratulations! Your app is up and running! 🎉

Conclusion

Nuxt is a great tool for building fullstack applications using Vue. Pair it up with Prisma and working with databases while building a fullstack app becomes less of a hassle. This enables a developer to focus on what matters, shipping features!

Using Nuxt to build fullstack applications is great for prototyping. However, if you’d like to build bigger applications, it’s recommended to separate your frontend from the backend.

I hope you liked this tutorial and learned something useful. The completed project is available on GitHub.

Do you have any suggestions of any libraries/frameworks you’d like to see paired with Prisma? Feel free to let us know in the discussion or create an issue on GitHub.

Happy hacking!

Latest comments (30)

Hendi Santika • Jan 28

Could You upgrade into nuxt 3?

Ruheni Alex • Jul 19 '23

I appreciate the feedback.

At the time of writing, the article used Nuxt v2. However, it should be possible with Nuxt 3 without Express. I would recommend checking out sidebase.io which is more up to date. 🙂

Sebastian hilton • Jun 13 '22

I know its been several months since this post, but how does someone create API routes if you have hundreds of models? Is there an easier way or a generator?

Ruheni Alex • Jun 14 '22

Hi Sebastian 👋🏽
The API routes defined would be depended on the business logic of your application. However, if you're looking to build a generator, take a look at create-prisma-generator. However, the API for building generators is unofficial and undocumented.

AxelBriche • Apr 17 '22 • Edited

Is it possible to use prisma with Nuxt 3 and /server/api folder for useAsyncData/useFetch methods (for send form data) without Express?

I don't find find how to sent (PUT/POST) my form data with useAsyncData/useFetch.
And Nuxt 3 come with the /server/api dir, why use Express?

Gareth • Mar 16 '23

This was almost a year ago so I'm pretty sure you worked it out between then and now.

And then you'd just call const { data } = await useFetch('/api/user/1'); in app.vue or which ever Vue component you'd like.

Ruheni Alex • Apr 18 '22

Hi Axel 👋🏽

At the time the guide was written, the sample application was using Nuxt 2 (I'll add a note about this). You can exclude Express in your project. You can still use Prisma with in server routes.

Aldwin Filoteo • Oct 22 '22

how can we fetch data from database without using Express ? can we have samples using nuxt 2 . thank you

liamb13 • Mar 13 '22 • Edited

If I had an array of posts pulled from another api. How could I add them in bulk to prismas?

E.g:

result = [
  {
    title: 'Post Title 1',
    content: 'An example post',
    author: 'liam@example.com',
  },
    {
    title: 'Post Title 2',
    content: 'An example post by a different author',
    author: 'liamb@example.com',
  },
]

liamb13 • Mar 14 '22

The age old adage... 'read the docs'

const createMany = await prisma.user.createMany({
  data: result,
  skipDuplicates: true, // Skip 'Bobo'
})

or replace result with:

data = [
  {
    title: 'Post Title 1',
    content: 'An example post',
    author: 'liam@example.com',
  },
    {
    title: 'Post Title 2',
    content: 'An example post by a different author',
    author: 'liamb@example.com',
  },
]

Reference: Create multiple records

Prashant Raval • Dec 30 '21

How to use or call this API in vue file to display result data? Can you please share example?

Ruheni Alex • Dec 30 '21

Hi Prashant 👋🏽

You can use the fetch, axios or http nuxt modules to fetch call the API in either your component or page as follows:

export default {
  data: () => ({
    posts: [],
  }),
  async fetch() {
    this.posts = await this.$http.$get("/posts");
  },
};

You can choose how you would like to display your data in the view.

Prashant Raval • Dec 31 '21

Hi Alex,

Thanks for your response, well the thing is i am starting with Nuxt 3 so later i don't have to rewrite my project, and nuxt 3 have no support for axios.

Nuxt 3 having fetch option and h3, but i am not sure how to use them as Post method to submit my form data.

So do you have any idea about that?

Regards,

Ruheni Alex • Dec 31 '21

For a form submission, you can still use fetch to submit data to the API route.

We created a rest-nuxtjs example but it uses Nuxt v2 and a custom server. In that example, the create.vue page makes a form submission to an API route. You can use this example for inspiration when handling form submission in your application.

Here's what the function resembles:

export default {
  data() {
    return { title: '', authorEmail: '', content: '' }
  },
  methods: {
    createDraft: async function (e) {
      e.preventDefault()
      const body = {
        title: this.title,
        authorEmail: this.authorEmail,
        content: this.content,
      }
      try {
        const res = await fetch(`/api/post`, {
          method: 'POST',
          headers: { 'Content-Type': 'application/json' },
          body: JSON.stringify(body),
        })
        const data = await res.json()
        await this.$router.push({ name: 'drafts' })
      } catch (error) {
        console.error(error)
      }
    },
  },
}

Let me know if you run into any other issues. I'd be happy to help! 🙂

Prashant Raval • Jan 2 '22

Hello Alex,

Before i test your example code for form submission, i am stuck with the API call, i have created a file server/api/index.js and here its code part


import express from 'express'
import pkg from '@prisma/client';
const { PrismaClient } = pkg;

const prisma = new PrismaClient({
    log: ['query']
})

const app = express()

// Body parser, to access `req.body`
app.use(express.json())

app.get('/apitest', async (req, res) => {
    res.end('Test API!')
})

app.post('/sendMessage', async (req, res) => {
    const { name, email, company_name, phone, message } = req.body
    const post = await prisma.contact.create({
        data: {
            name,
            email,
            company_name,
            phone,
            message
        }
    })
    res.status(200).json(post)
})

Now, when i run the server localhost:3000 it says handle is not a function
with error code 500

i think as per nuxt 3 document for API ( v3.nuxtjs.org/docs/directory-struc... ) might be it has its own way to handle the request,

So, did you have ever tried this kind of call and have any suggestion for me to fix it?

Thanks a lot

Nathalie Magdalena Schönwetter • Nov 17 '21

Hoi, how can i build this correctly? Everytime i try npm run build, generate and start the frontend works fine but the backend (api) is not reachable.

liamb13 • Oct 20 '21

Would it be possible to expand on this article for user authentication?

Ruheni Alex • Oct 21 '21

Hi @liamb 👋

That sounds like a terrific idea, similar to How to Build a Fullstack App with Next.js, Prisma, and PostgreSQL. Before we get to it, you can have a look at nuxt-auth.

MANOJ AP • Oct 7 '21

right solution

Mojtaba Barari • Sep 16 '21

Great job!! Tanx! also a question! I wanna import an DB from server on local to work offline. should I write the schema of main server BD before import for prisma to work??

Ruheni Alex • Sep 20 '21

Hey Mojtaba 👋

If you're referring to the database schema, you can use the db pull command that the Prisma CLI provides to introspect your database. You can then change the DATABASE_URL in the .env file from the main server to your local database instance, run db push or prisma migrate dev to apply the schema to your local database as well as generate a new Prisma Client.

Mojtaba Barari • Sep 21 '21 • Edited

Tanx. BTW a final question that you may know the answer to.
I'm trying to build an electron app with nuxt-prisma-sqlite . on dev everything is ok, but on built exe file my api wont be handled by express and it gives 404.
Did you have ever came across this??

MANOJ AP • Jul 25 '21

can I use prisma in Vue component as I do in React and Next

Ruheni Alex • Jul 26 '21

Hey Manoj, 👋🏽

Prisma runs on the server-side. If you're using Nuxt, you can run Prisma in the asyncData and fetch hooks at either a page or component level.

I created a small demo you can check out experimenting how this would work. Your feedback on this would be appreciated too 🙂

MANOJ AP • Jul 26 '21

I managed to create a middleware API in Nuxt
I also tried PrismaClient as Vue plugin(Vue.use) and it fails.
Same result in Vuex store.

gist.github.com/manojap/fb0d973551...

MANOJ AP • Jul 27 '21

Here is my sandbox
codesandbox.io/s/nuxt-api-prisma-a...

Ruheni Alex • Aug 9 '21

The sample on Codesandbox should work just fine. I've managed to query data – both the REST and GraphQL API.

Could you share the error you get when you use a Vue plugin?

Sébastien Chopin • May 13 '21

Great article 🙌

MANOJ AP • Jul 25 '21

do you configure database properly ? double check schema..... try to run the migrate command

also try npx prisma studio ( for make sure the connection is set properly)

Nathalie Magdalena Schönwetter • Nov 18 '21

Hi, did you mean me? Yes the DB is running in dev mode. prisma studio is also running. When i try to build, generate and start the nuxt app the api is not available.

View full discussion (31 comments)

DEV Community

Adding an API and database to your Nuxt App with Prisma

Prerequisites

Step 0: Initialize your Nuxt application

Step 1: Add Prisma to your app

Initialize Prisma

Create your first database migration

Step 2: Add your `serverMiddleware` endpoints

Create a `User`

Creating a `Post`

Get drafts

Get `Post` by `Id`

Publish a `Post`

Get Feed

Deleting a `Post`

Search for a `Post`

Step 3: Modify `nuxt.config.js`

Step 4: Take your API for a spin

Conclusion

Latest comments (30)

Read next

Fix code . command not working | Visual Studio Code

Running VLC in the Browser

Setup path aliases in React + Vite + TS Project 🤓

Build a Discord Bot with Discord.js V14: A Step-by-Step Guide

Prerequisites

Step 0: Initialize your Nuxt application

Step 1: Add Prisma to your app

Initialize Prisma

Create your first database migration

Step 2: Add your serverMiddleware endpoints

Create a User

Creating a Post

Get drafts

Get Post by Id

Publish a Post

Get Feed

Deleting a Post

Search for a Post

Step 3: Modify nuxt.config.js

Step 4: Take your API for a spin

Conclusion

Read next

Fix code . command not working | Visual Studio Code

Running VLC in the Browser

Setup path aliases in React + Vite + TS Project 🤓

Build a Discord Bot with Discord.js V14: A Step-by-Step Guide

Step 2: Add your `serverMiddleware` endpoints

Create a `User`

Creating a `Post`

Get `Post` by `Id`

Publish a `Post`

Deleting a `Post`

Search for a `Post`

Step 3: Modify `nuxt.config.js`