Better Auth Authentication

Goals

• •Enable email/password authentication and social providers.
• •Implement sign-up, sign-in, sign-out, and verification flows.
• •Handle redirects and errors consistently.

Quick start

1. •Enable emailAndPassword and configure socialProviders.
2. •Create a client with createAuthClient.
3. •Use signUp.email, signIn.email, signIn.social, and signOut on the client.

import { betterAuth } from "better-auth";

export const auth = betterAuth({
  emailAndPassword: { enabled: true },
  socialProviders: {
    github: {
      clientId: process.env.GITHUB_CLIENT_ID as string,
      clientSecret: process.env.GITHUB_CLIENT_SECRET as string,
    },
  },
});

import { createAuthClient } from "better-auth/client";

const authClient = createAuthClient();

await authClient.signUp.email({
  email,
  password,
  name,
});

await authClient.signIn.email({
  email,
  password,
  callbackURL: "/dashboard",
});

await authClient.signIn.social({
  provider: "github",
  callbackURL: "/dashboard",
});

await authClient.signOut();

Email verification

• •Provide emailVerification.sendVerificationEmail to send the verification link.
• •Use emailAndPassword.requireEmailVerification to enforce verification before sign-in.

Social providers

• •Configure providers in socialProviders with provider-specific credentials.
• •Use signIn.social to start OAuth flows.
• •Pass callbackURL, errorCallbackURL, and newUserCallbackURL for redirects.

Guardrails

• •Call client methods from the client only.
• •Keep secrets in server-only env variables.
• •Use rememberMe to control persistent sessions on email/password sign-in.

References

• •toolchains/platforms/auth/better-auth/better-auth-authentication/references/email-password.md
• •toolchains/platforms/auth/better-auth/better-auth-authentication/references/providers.md