Authentication

Launchframe uses Better Auth for authentication — a modern, type-safe auth library for Next.js.

Modules

auth-core

Included in every project. Provides:

• Email/password authentication
• Session management with database sessions
• Middleware-based route protection
• Sign in / sign up pages
• Auth utilities (auth-client.ts, auth-session.ts)

auth-github

Optional. Added when --auth email-password+github is selected.

• GitHub OAuth provider configuration
• Social login button on sign-in page

Requires GITHUB_CLIENT_ID and GITHUB_CLIENT_SECRET env vars.

Key files

Route protection

Routes under /dashboard, /settings, /billing are protected by middleware. Unauthenticated users are redirected to /sign-in.

// src/middleware.ts
const protectedRoutes = ['/dashboard', '/settings', '/billing'];

Session access

Server components:

import { getSession } from '@/lib/auth-session';

const session = await getSession();
if (!session) redirect('/sign-in');

Client components:

import { useSession } from '@/lib/auth-client';

const { data: session } = useSession();