better-auth
在 Web 应用程序中使用 better-auth 库实现身份验证。当用户需要添加注册、登录、注销、会话管理或用户配置文件功能时,请使用此技能。触发身份验证、登录系统、用户注册、OAuth 集成或使用身份验证保护路由的请求。
📖 中文导读:在 Web 应用程序中使用 better-auth 库实现身份验证。当用户需要添加注册、登录、注销、会话管理或用户配置文件功能时,请使用此技能。触发身份验证、登录系统、用户注册、OAuth 集成或使用身份验证保护路由的请求。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
name: better-auth description: Implement authentication using better-auth library in web applications. Use this skill when users need to add signup, signin, signout, session management, or user profile features. Triggers on requests for authentication, login systems, user registration, OAuth integration, or protecting routes with auth.
Better Auth
Overview
Better-auth is a modern TypeScript authentication library that provides email/password auth, OAuth providers, and session management. This skill guides implementation in React/Docusaurus projects with PostgreSQL (Neon) backends.
Quick Start Workflow
1. Install Dependencies
npm install better-auth
2. Environment Setup
Create/update .env:
BETTER_AUTH_SECRET=<generate with: openssl rand -base64 32>
BETTER_AUTH_URL=http://localhost:3000
DATABASE_URL=postgresql://user:pass@host/db
3. Server Configuration
Create lib/auth.ts:
import { betterAuth } from "better-auth";
import { Pool } from "pg";
export const auth = betterAuth({
database: new Pool({
connectionString: process.env.DATABASE_URL,
}),
emailAndPassword: {
enabled: true,
},
// Add custom user fields for personalization
user: {
additionalFields: {
programmingLevel: { type: "string" },
hardwareBackground: { type: "string" },
learningGoals: { type: "string" },
},
},
});
4. API Route Handler
For Express/FastAPI backend, mount at /api/auth/*:
import { toNodeHandler } from "better-auth/node";
import { auth } from "./lib/auth";
app.all("/api/auth/*", toNodeHandler(auth));
5. Client Setup
Create lib/auth-client.ts:
import { createAuthClient } from "better-auth/react";
export const authClient = createAuthClient({
baseURL: process.env.NEXT_PUBLIC_API_URL || "http://localhost:8000",
});
export const { useSession, signIn, signOut, signUp } = authClient;
6. Database Migration
Generate and run migrations:
npx @better-auth/cli generate
npx @better-auth/cli migrate
Common Tasks
Signup with Custom Fields
const handleSignup = async (formData: SignupData) => {
const { data, error } = await authClient.signUp.email({
email: formData.email,
password: formData.password,
name: formData.name,
// Custom fields for personalization
programmingLevel: formData.programmingLevel,
hardwareBackground: formData.hardwareBackground,
learningGoals: formData.learningGoals,
});
if (error) throw new Error(error.message);
return data;
};
Session Hook Usage
import { useSession } from "@/lib/auth-client";
function UserProfile() {
const { data: session, isPending } = useSession();
if (isPending) return <Loading />;
if (!session) return <LoginPrompt />;
return <div>Welcome, {session.user.name}</div>;
}
Protected Component Pattern
function ProtectedFeature({ children }) {
const { data: session, isPending } = useSession();
if (isPending) return <Skeleton />;
if (!session) return <SignInButton />;
return children;
}
Sign Out
const handleSignOut = async () => {
await authClient.signOut();
window.location.href = "/";
};
User Background Questions
For personalization, collect these during signup:
Programming Experience
- Beginner (< 1 year)
- Intermediate (1-3 years)
- Advanced (3+ years)
Hardware/Robotics Background
- None
- Hobbyist (Arduino, Raspberry Pi)
- Professional (industrial robotics)
Learning Goals
- Career transition
- Academic study
- Personal interest
- Professional upskilling
Resources
references/
setup-guide.md- Detailed setup instructions for different frameworksdatabase-schema.md- User table schema with custom fields
scripts/
setup-auth.py- Automated setup script for better-auth
assets/
components/- React components for Login, Signup, Profile forms