This example shows to use [Grafbase](https://grafbase.com) with Next.js. This example features fetching from a local GraphQL backend powered by the Grafbase CLI, and GraphQL Code Generator for making type-safe queries.
## Demo
You can see a demo of this online at [https://grafbase-with-nextjs-rsc.grafbase-vercel.dev](https://grafbase-with-nextjs-rsc.grafbase-vercel.dev).
## Deploy
First deploy this to Grafbase to get your backend API URL and Key:
[](https://grafbase.com/new/configure?template=NextExample&source=https%3A%2F%2Fgithub.com%2Fvercel%2Fnext.js%2Ftree%2Fcanary%2Fexamples%2Fwith-grafbase)
Then deploy this example using [Vercel](https://vercel.com):
[](https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2Fvercel%2Fnext.js%2Ftree%2Fcanary%2Fexamples%2Fwith-grafbase&env=GRAFBASE_API_URL,GRAFBASE_API_KEY)
## How to use
Execute [`create-next-app`](https://github.com/vercel/next.js/tree/canary/packages/create-next-app) with [npm](https://docs.npmjs.com/cli/init), [Yarn](https://yarnpkg.com/lang/en/docs/cli/create/), or [pnpm](https://pnpm.io) to bootstrap the example:
1. Copy the `.env.local.example` to `.env.local` and provide your API URL and API Key: `cp .env.local.example .env.local`— the defaults will be fine for development mode.
2. Run the [Grafbase CLI](https://grafbase.com/cli) using `npx grafbase@latest dev`
3. Populate the backend with some `Post` entries using a GraphQL mutation:
```graphql
mutation{
postCreate(
input:{
title:"I love Next.js!"
slug:"i-love-nextjs"
comments:[{create:{message:"me too!"}}]
}
){
post{
id
slug
}
}
}
```
4. Run the app locally and go to [http://localhost:3000](http://localhost:3000) to navigate to each post page! This data is fetched from the local backend.
5. Optionally run `npm run codegen` to watch for any changes to queries inside of the app and automatically generate types.
## Learn more
-[Grafbase Quickstart](https://grafbase.com/docs/quickstart/get-started)— get started with Grafbase, quickly!
-[Create an account](https://grafbase.com/sign-up)— deploy to the edge with Grafbase!
-[Next.js Documentation](https://nextjs.org/docs)— learn more about Next.js