npx skills add ...
npx skills add neondatabase/ai-rules --skill neon-serverless
npx skills add neondatabase/ai-rules --skill neon-serverless
Configures Neon Serverless Driver for Next.js, Vercel Edge Functions, AWS Lambda, and other serverless environments. Installs @neondatabase/serverless, sets up environment variables, and creates working API route examples with TypeScript types. Use when users need to connect their application to Neon, fetch or query data from a Neon database, integrate Neon with Next.js or serverless frameworks, or set up database access in edge/serverless environments where traditional PostgreSQL clients don't work.
Configures the Neon Serverless Driver for optimal performance in serverless and edge computing environments.
Not recommended for: Complex multi-statement transactions (use WebSocket Pool), persistent servers (use native PostgreSQL drivers), or offline-first applications.
When generating TypeScript/JavaScript code:
Primary Resource: See [neon-serverless.mdc](https://raw.githubusercontent.com/neondatabase-labs/ai-rules/main/neon-serverless.mdc) in project root for comprehensive guidelines including:
HTTP Client (recommended for edge/serverless):
WebSocket Pool (for Node.js long-lived connections):
See templates/ for complete examples:
templates/http-connection.ts - HTTP client setuptemplates/websocket-pool.ts - WebSocket pool configurationUse scripts/validate-connection.ts to test your database connection before deployment.
Want best practices in your project? Run neon-plugin:add-neon-docs with parameter SKILL_NAME="neon-serverless" to add reference links.
import { Pool } from '@neondatabase/serverless';
const pool = new Pool({ connectionString: process.env.DATABASE_URL! });
const result = await pool.query('SELECT * FROM users WHERE id = $1', [userId]);