neon-serverless

Konfiguriert den Neon Serverless Driver für Next.js, Vercel Edge Functions, AWS Lambda und andere serverlose Umgebungen. Installiert @neondatabase/serverless, richtet…

npx skills add https://github.com/neondatabase/ai-rules --skill neon-serverless

Neon Serverless Skill

Configures the Neon Serverless Driver for optimal performance in serverless and edge computing environments.

When to Use

  • Setting up connections for edge functions (Vercel Edge, Cloudflare Workers)
  • Configuring serverless APIs (AWS Lambda, Google Cloud Functions)
  • Optimizing for low-latency database access
  • Implementing connection pooling for high-throughput apps

Not recommended for: Complex multi-statement transactions (use WebSocket Pool), persistent servers (use native PostgreSQL drivers), or offline-first applications.

Code Generation Rules

When generating TypeScript/JavaScript code:

  • BEFORE generating import statements, check tsconfig.json for path aliases (compilerOptions.paths)
  • If path aliases exist (e.g., "@/": ["./src/"]), use them (e.g., import { x } from '@/lib/utils')
  • If NO path aliases exist or unsure, ALWAYS use relative imports (e.g., import { x } from '../../../lib/utils')
  • Verify imports match the project's configuration
  • Default to relative imports - they always work regardless of configuration

Reference Documentation

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:

  • Installation and compatibility requirements
  • HTTP vs WebSocket adapter selection
  • Connection pooling strategies
  • Query optimization patterns
  • Error handling and troubleshooting

Quick Setup

Installation

npm install @neondatabase/serverless

Connection Patterns

HTTP Client (recommended for edge/serverless):

import { neon } from '@neondatabase/serverless';
const sql = neon(process.env.DATABASE_URL!);
const rows = await sql`SELECT * FROM users WHERE id = ${userId}`;

WebSocket Pool (for Node.js long-lived connections):

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]);

See templates/ for complete examples:

  • templates/http-connection.ts - HTTP client setup
  • templates/websocket-pool.ts - WebSocket pool configuration

Validation

Use scripts/validate-connection.ts to test your database connection before deployment.

Related Skills

  • neon-auth - Add authentication
  • neon-js - Full SDK with auth + data API
  • neon-drizzle - For ORM with serverless connections
  • neon-toolkit - For ephemeral database testing

Want best practices in your project? Run neon-plugin:add-neon-docs with parameter SKILL_NAME="neon-serverless" to add reference links.

Mehr Skills von neondatabase

add-neon-docs
neondatabase
Verwenden Sie diese Fähigkeit, wenn der Benutzer darum bittet, Dokumentation hinzuzufügen, Docs hinzuzufügen, Referenzen hinzuzufügen oder Dokumentation über Neon zu installieren. Fügt Referenzlinks zu Neon-Best-Practices hinzu…
better-env
neondatabase
Bessere Verwaltung von Umgebungsvariablen für Agenten und Menschen mit vollständiger Typsicherheit, CLI-basierter Synchronisation entfernter Umgebungen und Umgebungsvalidierung.
claimable-postgres
neondatabase
Sofort einsatzbereite Postgres-Datenbanken für lokale Entwicklung, Demos, Prototyping und Testumgebungen. Kein Konto erforderlich. Datenbanken laufen nach 72 Stunden ab, sofern sie nicht an ein Neon-Konto gebunden werden.
claimable-postgres
neondatabase
Erstellen Sie eine sofortige Postgres-Datenbank mit Claimable Postgres von Neon (pg.new) für schnelle lokale Entwicklung, Demos, Prototyping und Testumgebungen.
logging-best-practices
neondatabase
Bewährte Verfahren für das Logging mit Fokus auf breite Ereignisse (kanonische Logzeilen) für leistungsstarkes Debugging und Analysen
neon
neondatabase
Überblick über die Neon-Plattform für Apps und Agents, einschließlich Postgres, Auth, Data API und der neuen Dienste: Object Storage, Compute Functions und AI Gateway. Verwenden, wenn "Neon" erwähnt wird, für einen Überblick über die Arbeit mit Neon und die ersten Schritte. Andernfalls sind die einzelnen Funktionen die Auslöser: "Object Storage" oder "S3-kompatibler Speicher", "Serverless Functions", "Background Jobs" oder "Code in der Nähe meiner Datenbank ausführen", "AI Gateway", "LLM Proxy", "Model Routing" oder "ein LLM aufrufen" →...
apidevelopmentdatabase
neon-ai-gateway
neondatabase
Eine API und ein Zugangsdaten-Satz für führende und Open-Source-LLMs, integriert in Ihren Neon-Branch und unterstützt von Databricks. Verwenden Sie, wenn ein Benutzer ein LLM aufrufen möchte, hinzufügen…
neon-auth
neondatabase
Richtet Neon Auth für Ihre Anwendung ein. Konfiguriert die Authentifizierung, erstellt Auth-Routen und generiert UI-Komponenten. Verwenden Sie dies, wenn Sie Authentifizierung zu Next.js hinzufügen, …