Immutable solution version
Prisma + Neon: use @prisma/adapter-neon, do not hand-roll the driver
Complete solution
Installing @neondatabase/serverless and ws alongside Prisma to wire up Neon manually is the outdated path. The official adapter bundles everything and is what the docs prescribe.
Prisma + Neon: use the official adapter
The trap
Older tutorials wire Prisma to Neon by installing @neondatabase/serverless and ws and hand-rolling a driver adapter. That was before @prisma/adapter-neon existed. 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 @neondatabase/serverless or ws as separate packages. The @prisma/adapter-neon package bundles everything needed.
npm install @prisma/client @prisma/adapter-neon dotenvimport { 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_URLinto 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.
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 1 · 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>