Authentication

Installation

Install the Package

Add Authentication to your project using the Tailar CLI:

pnpm dlx tailar@latest add auth

Set Environment Variables

Create a `.env` file in the root of your project and add the following environment variables:

.env

1
# App Configuration
2
NEXT_PUBLIC_APP_URL="http://localhost:3000"
3
 
4
# Auth Configuration
5
BETTER_AUTH_URL="http://localhost:3000"
6
BETTER_AUTH_SECRET="your-secret-key-here-replace-with-secure-random-string"
7
# Generate a secure random string using: openssl rand -base64 32
8
 
9
# Google OAuth (Optional)
10
# Uncomment and fill these if you want to enable Google authentication
11
# GOOGLE_CLIENT_ID="your_google_client_id"
12
# GOOGLE_CLIENT_SECRET="your_google_client_secret"

Preview

Explore representative UI flows and snippets generated for this module (same previews as on the home page modules section).

Enter your email and password to access your account

Or continue with

Don't have an account? Sign Up

Usage

Once you've installed Authentication, you can start using the following actions:

signInWithEmail

1
import { signInWithEmail } from '@/lib/auth/actions'
2
 
3
await signInWithEmail(email, password)

signUpWithEmail

Create a new user account with email and password.

1
import { signUpWithEmail } from '@/lib/auth/actions'
2
 
3
await signUpWithEmail(email, password, name)

signInWithGoogle

1
import { signInWithGoogle } from '@/lib/auth/actions'
2
 
3
await signInWithGoogle()

signOutAction

Sign out the current user.

1
import { signOutAction } from '@/lib/auth/actions'
2
 
3
await signOutAction()

getSession

Get the current user session. Returns null if not authenticated.

1
import { getSession } from '@/lib/auth'
2
 
3
const session = await getSession()
4
if (session) {
5
  console.log('User:', session.user)
6
}

updateUser

Update the current user's profile information.

1
import { updateUser } from '@/lib/auth/actions'
2
 
3
await updateUser({ name: 'New Name', image: 'https://...' })

forgotPassword

Send a password reset email to the user.

1
import { forgotPassword } from '@/lib/auth/actions'
2
 
3
await forgotPassword(email)

resetPassword

Reset the user's password using a reset token.

1
import { resetPassword } from '@/lib/auth/actions'
2
 
3
await resetPassword(token, newPassword)

useAuthActions

React hook for authentication operations in client components. Provides signIn, signUp, signOut, and other auth methods.

1
import { useAuthActions } from '@/lib/auth/hooks'
2
 
3
function LoginForm() {
4
  const { signIn, isLoading, error } = useAuthActions()
5
  
6
  const handleSubmit = async () => {
7
    await signIn(email, password)
8
  }
9
}

useAuth

React hook to access the current user session in client components.

1
import { useAuth } from '@/lib/auth/context'
2
 
3
function Profile() {
4
  const { user, session } = useAuth()
5
  return <div>Welcome {user?.name}</div>
6
}