neon-auth

Neon Auth 集成

为应用添加身份验证。

何时使用此技能

• 为新项目或现有项目添加身份验证
• 实现登录、注册和会话管理
• 配置社交身份验证（Google、GitHub）

包：@neondatabase/auth（仅身份验证，打包体积更小）

还需要数据库查询？ 改用 neon-js 技能，以使用带有统一身份验证和数据 API 的 @neondatabase/neon-js。

代码生成规则

生成 TypeScript/JavaScript 代码时，请遵循以下规则：

完整参考： 请参阅 代码生成规则，了解：

• 导入路径处理（路径别名与相对导入）
• Neon 包导入（子路径导出、适配器模式）
• CSS 导入策略（Tailwind 检测、单一导入方式）
• 文件结构模式

要点：

• 生成导入语句前，检查 tsconfig.json 中的路径别名
• 如果不确定或不存在别名，请使用相对导入
• BetterAuthReactAdapter 必须从 auth/react/adapters 子路径导入
• 适配器是工厂函数，请使用 () 调用
• 选择一种 CSS 导入方式（Tailwind 或 CSS，不能同时使用）

可用指南

每份指南都是一套完整、独立的分阶段教程：

• guides/nextjs-setup.md - 完整的 Next.js App Router 设置指南
• guides/react-spa-setup.md - 详细的 React SPA 指南，包含 react-router-dom 集成

我会自动检测你的环境（包管理器、框架、现有设置），并根据你的请求选择合适的指南。

如需排查问题，请参阅 references 中的故障排除指南。

快速示例

告诉我你正在构建什么，其余的交给我处理：

• “为我的 Next.js 应用添加身份验证” -> 加载设置指南并配置身份验证路由
• “设置 Google 登录” -> 配置社交身份验证提供方
• “调试我的身份验证会话无法持久化的问题” -> 加载故障排除指南

参考文档

主要资源： 请参阅 neon-auth.mdc，了解完整指南，包括：

• 所有身份验证方式（电子邮件/密码、社交身份验证、魔法链接）
• 会话数据结构
• UI 组件参考
• 错误处理

特定框架的设置（选择你的框架）：

• 设置 - Next.js
• 设置 - React SPA
• 设置 - Node.js

特定框架的 UI（选择你的框架）：

• UI - Next.js
• UI - React SPA

通用参考：

• 常见错误 - 导入路径、适配器模式、CSS
• 故障排除指南 - 错误解决方案
• 代码生成规则 - 导入和 CSS 策略
• 身份验证适配器指南 - 适配器对比
• 导入参考 - 完整导入路径

模板

• templates/nextjs-api-route.ts - Next.js 的 API 路由处理程序
• templates/auth-client.ts - 客户端身份验证配置

相关技能

• neon-js - 包含身份验证和数据库查询的完整 SDK（如果你需要 PostgREST 风格的数据访问，请使用）
• neon-drizzle - Drizzle ORM 设置（用于数据库查询）
• neon-serverless - 直接连接数据库
• add-neon-docs - 将 Neon 最佳实践添加到你的项目中（设置完成后运行）

---

工作流

我将：

1. 自动检测你的项目上下文（Next.js、React SPA、Node.js）
2. 选择并加载相应指南
3. 按顺序遵循指南的各个阶段
4. 使用指南中的工作流清单跟踪进度
5. 仅在需要时加载参考文件
6. 提议将 Neon 最佳实践添加到你的项目文档中

准备好开始了吗？只需描述你正在构建什么！