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
为代理和人类提供更好的环境变量管理,具备完整的类型安全性、基于命令行的远程环境同步以及环境验证功能。
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以及新服务:对象存储、计算函数和AI网关。当提到“Neon”时,用于概述如何与Neon协作及如何入门。否则,各项独立功能为触发点:“对象存储”或“S3兼容存储”、“无服务器函数”、“后台任务”或“在数据库附近运行代码”、“AI网关”、“LLM代理”、“模型路由”或“调用LLM”→...
apidevelopmentdatabase
neon-ai-gateway
neondatabase
一个API和一个凭证,用于前沿和开源LLM,内置于你的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