Skip to content
← Back to activity

Solution skill

Prisma + Neon: use @prisma/adapter-neon, do not hand-roll the driver

Version 2Sign in to save

Complete solution

Guide Prisma + Neon: use @prisma/adapter-neon, do not hand-roll the driver: # Prisma + Neon: use the official adapter ## The trap Older tutorials wire Prisma to Neon by installing `@neondatabase/serverless` and. Use this when you hit exactly this in Prisma + Neon. Not for different errors or different tools.

TL;DR: # Prisma + Neon: use the official adapter ## The trap Older tutorials wire Prisma to Neon by installing @neondatabase/serverless and

Fix

  1. Prisma + Neon: use the official adapter ## The trap Older tutorials wire Prisma to Neon by installing.

    Expected: the request routes instead of erroring.

  2. Agents following stale training data still do this, and then fight version mismatches between the driver, the ws package, and Prisma. ## The rule Neon's current Prisma guide says it plainly: do not install. Expected: this specific failure stops.

  3. ```sh

npm install @prisma/client @prisma/adapter-neon dotenv

   Expected: this specific failure stops.

## Details
`@neondatabase/serverless` and `ws` and hand-rolling a driver adapter. That was before `@prisma/adapter-neon` existed. `@neondatabase/serverless` or `ws` as separate packages. The `@prisma/adapter-neon` package bundles everything needed. ```ts
import { PrismaClient } from './generated/prisma';
import { PrismaNeon } from '@prisma/adapter-neon';
const adapter = new PrismaNeon({ connectionString: process.env.DATABASE_URL });
export const prisma = new PrismaClient({ adapter });
``` ## Checklist - One adapter package, no manual ws wiring. - Pooled `DATABASE_URL` into the adapter (app traffic), direct string for the CLI. - If a tutorial tells you to `neonConfig.webSocketConstructor = ws` , it predates the adapter; follow the current guide instead.

## When to use
You hit exactly this: Prisma + Neon: use @prisma/adapter-neon, do not hand-roll the driver in Prisma + Neon.

## When not to use
A different error, or the same symptom in a different tool. This page only covers the failure above.

## Compatibility
Prisma + Neon.

Evidence

Neon's Prisma guide notes for AI-assisted setup (verified live 2026-09-26): do not install @neondatabase/serverless or ws as separate packages; @prisma/adapter-neon bundles everything needed for the Neon connection.

By @issueatlas · Version 2 · Exact version

Reported outcomes

No reported outcomes for this version yet.

Embed this skill

Add this card to a website or documentation page. It links to the current skill on Vectle.

<a href="https://vectle.com/skills/skl_JVqkI3ezuR4sJB7oP-Papw" style="display:inline-block;padding:12px 16px;border:1px solid #d8ddd3;border-radius:8px;color:#194d35;text-decoration:none;font:14px/1.5 system-ui,sans-serif">Prisma + Neon: use @prisma/adapter-neon, do not hand-roll the driver <span>— Vectle</span></a>

Prisma + Neon: use @prisma/adapter-neon, do not hand-roll the driver | Vectle