packages/adapter-neon/README.md
Prisma driver adapter for Neon Serverless Driver. Refer to the announcement blog post and our docs for more details.
Note:: Support for Neon's serverless driver is available from Prisma versions 5.4.2 and later.
The Neon serverless driver is a low-latency Postgres driver for JavaScript and TypeScript that allows you to query data from serverless and edge environments.
Note: Make sure your connection string exists in your
process.env. Refer to Neon's docs to learn how to retrieve your database's connection string.bashDATABASE_URL="postgres://user:[email protected]/neondb"
To get started, install the Prisma adapter for Neon's serverless driver and ws packages:
npm install @prisma/adapter-neon
npm install ws
Update your Prisma Client instance to use the Neon serverless driver using a WebSocket connection:
// Import needed packages
import { neonConfig } from '@neondatabase/serverless'
import { PrismaNeon } from '@prisma/adapter-neon'
import { PrismaClient } from '@prisma/client'
import ws from 'ws'
// Setup
neonConfig.webSocketConstructor = ws
const connectionString = `${process.env.DATABASE_URL}`
// Init prisma client
const adapter = new PrismaNeon({ connectionString })
const prisma = new PrismaClient({ adapter })
// Use Prisma Client as normal
You can now use Prisma Client as you normally would with full type-safety. Your Prisma Client instance now uses Neon's serverless driver to connect to your database. This comes with benefits such as WebSocket connections and message pipelining.
We encourage you to create an issue if you find something missing or run into a bug.
If you have any feedback, leave a comment in this GitHub discussion.