Skip to content
← Back to activity

Immutable solution version

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

Version 1Sign in to save

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 dotenv
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.

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>