neon-auth

작성자: neondatabase

애플리케이션에 Neon Auth를 설정합니다. 인증을 구성하고, 인증 라우트를 생성하며, UI 컴포넌트를 생성합니다. Next.js에 인증을 추가할 때 사용합니다.

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

Neon Auth Integration

Add authentication to your application.

When to Use This Skill

  • Adding authentication to a new or existing project
  • Implementing sign-in, sign-up, and session management
  • Configuring social authentication (Google, GitHub)

Package: @neondatabase/auth (auth only, smaller bundle)

Need database queries too? Use the neon-js skill instead for @neondatabase/neon-js with unified auth + data API.

Code Generation Rules

When generating TypeScript/JavaScript code, follow these rules:

Complete reference: See Code Generation Rules for:

  • Import path handling (path aliases vs relative imports)
  • Neon package imports (subpath exports, adapter patterns)
  • CSS import strategy (Tailwind detection, single import method)
  • File structure patterns

Key points:

  • Check tsconfig.json for path aliases before generating imports
  • Use relative imports if unsure or no aliases exist
  • BetterAuthReactAdapter MUST be imported from auth/react/adapters subpath
  • Adapters are factory functions - call them with ()
  • Choose ONE CSS import method (Tailwind or CSS, not both)

Available Guides

Each guide is a complete, self-contained walkthrough with numbered phases:

  • guides/nextjs-setup.md - Complete Next.js App Router setup guide
  • guides/react-spa-setup.md - Detailed React SPA guide with react-router-dom integration

I'll automatically detect your context (package manager, framework, existing setup) and select the appropriate guide based on your request.

For troubleshooting, see the Troubleshooting Guide in references.

Quick Examples

Tell me what you're building - I'll handle the rest:

  • "Add authentication to my Next.js app" -> Loads setup guide, sets up auth routes
  • "Set up sign-in with Google" -> Configures social auth provider
  • "Debug my auth session not persisting" -> Loads troubleshooting guide

Reference Documentation

Primary Resource: See neon-auth.mdc for comprehensive guidelines including:

  • All authentication methods (email/password, social, magic link)
  • Session data structure
  • UI components reference
  • Error handling

Framework-Specific Setup (choose your framework):

Framework-Specific UI (choose your framework):

Shared References:

Templates

  • templates/nextjs-api-route.ts - API route handler for Next.js
  • templates/auth-client.ts - Client-side auth configuration

Related Skills

  • neon-js - Full SDK with auth + database queries (use if you need PostgREST-style data access)
  • neon-drizzle - Drizzle ORM setup (for database queries)
  • neon-serverless - Direct database connections
  • add-neon-docs - Add Neon best practices to your project (run after setup)

Workflow

I will:

  1. Detect your project context automatically (Next.js, React SPA, Node.js)
  2. Select and load the appropriate guide
  3. Follow the guide's phases sequentially
  4. Track progress using the guide's workflow checklist
  5. Load reference files only when needed
  6. Offer to add Neon best practices to your project docs

Ready to get started? Just describe what you're building!

neondatabase의 다른 스킬

add-neon-docs
neondatabase
사용자가 Neon에 대한 문서 추가, 문서 추가, 참조 추가, 또는 문서 설치를 요청할 때 이 스킬을 사용하세요. Neon 모범 사례 참조 링크를 추가합니다…
better-env
neondatabase
에이전트와 인간을 위한 더 나은 환경 변수 관리로, 완전한 타입 안전성, CLI 기반 원격 환경 동기화, 환경 검증을 제공합니다.…
claimable-postgres
neondatabase
로컬 개발, 데모, 프로토타이핑 및 테스트 환경을 위한 즉시 사용 가능한 Postgres 데이터베이스입니다. 계정이 필요하지 않습니다. 데이터베이스는 Neon 계정에 클레임되지 않으면 72시간 후에 만료됩니다.
claimable-postgres
neondatabase
Neon의 Claimable Postgres(pg.new)로 즉시 Postgres 데이터베이스를 생성하여 빠른 로컬 개발, 데모, 프로토타이핑 및 테스트 환경에 사용하세요.
logging-best-practices
neondatabase
강력한 디버깅과 분석을 위한 광범위한 이벤트(표준 로그 라인)에 초점을 맞춘 로깅 모범 사례
neon
neondatabase
Neon 플랫폼 개요: Postgres, Auth, Data API, 그리고 새로운 서비스인 Object Storage, Compute Functions, AI Gateway를 포함한 앱 및 에이전트 지원. "Neon"이 언급될 때마다 Neon 사용 방법과 시작 가이드 개요로 활용. 개별 기능은 다음 트리거로 연결: "object storage" 또는 "S3-compatible storage", "serverless functions", "background jobs", 또는 "run code near my database", "AI gateway", "LLM proxy", "model routing", 또는 "call an LLM" →...
apidevelopmentdatabase
neon-ai-gateway
neondatabase
프론티어 및 오픈소스 LLM을 위한 하나의 API와 하나의 자격 증명으로, Neon 브랜치에 내장되어 Databricks에서 구동됩니다. 사용자가 LLM을 호출하거나 추가하려는 경우 사용하세요.
neon-auth
neondatabase
Add authentication to a new app. Use for "add auth", "add login", Neon Auth (Managed Better Auth), identity routing, sign-up, sign-in, password reset, email OTP, magic links, organizations, phone OTP, OAuth, OAuth server for MCP or third-party OAuth clients, passkeys, MFA, trusted domains, invalid domain, and @neon/auth. No existing identity: default to Managed Better Auth. Keep working Better Auth, Clerk, Supabase Auth, or another IdP. User asked to migrate from Supabase Auth: Managed...
apidevelopmentsecurity