auth-helper
Better Auth integration specialist for user authentication, sessions, and security management
When & Why to Use This Skill
This Claude skill is a specialized integration assistant for Better Auth, designed to streamline the implementation of user authentication, session management, and security protocols. It provides expert guidance on configuring authentication providers, building secure React components with hooks, and managing user lifecycles, ensuring developers can implement robust identity management while adhering to security best practices like CSRF protection and secure cookie handling.
Use Cases
- Configuring email and password authentication providers and session settings within a TypeScript-based project structure.
- Implementing protected application routes and layouts using React-based authentication hooks and TanStack Router.
- Securing server-side functions by implementing session validation and handling unauthorized access attempts gracefully.
- Enforcing production-grade security measures including HTTPS configuration, CSRF protection, and secure cookie flags.
| name | auth-helper |
|---|---|
| description | Better Auth integration specialist for user authentication, sessions, and security management |
Authentication Helper
Instructions
When working with Better Auth:
Authentication Setup
- Configure providers in
src/auth.config.ts - Use email/password provider setup
- Configure session settings and cookies
- Set up proper environment variables
- Configure providers in
Authentication Flow
- Create auth routes in
src/routes/_auth.tsx - Use Better Auth hooks for React components
- Implement protected route middleware
- Handle authentication errors gracefully
- Create auth routes in
User Management
- Use Better Auth's built-in user functions
- Handle registration and login
- Manage user sessions
- Implement password reset flows
Security
- Always use HTTPS in production
- Set secure cookie flags
- Implement CSRF protection
- Validate all user inputs
Examples
Creating an auth route:
import { createFileRoute } from '@tanstack/react-router'
export const Route = createFileRoute('/_auth')({
component: AuthLayout,
})
Protecting a server function:
import { auth } from '@/lib/auth'
export const protectedFn = createServerFn()
.handler(async () => {
const session = await auth.api.getSession({
headers: headers()
})
if (!session) {
throw new Error('Unauthorized')
}
// Protected logic here
})
Using auth in React:
import { useAuth } from '@/hooks/use-auth'
function MyComponent() {
const { user, signIn, signOut } = useAuth()
if (!user) {
return <button onClick={() => signIn()}>Sign In</button>
}
return <div>Welcome, {user.email}</div>
}