Authentication

src/lib/auth/
├── server.ts       # Server-side auth instance + layout guards
├── client.ts       # Client-side auth hooks (useAuth)
├── definition.ts   # Type definitions
└── permissions.ts  # Permission utilities

src/features/auth/
├── schema.ts       # User schemas and types
├── functions.ts    # User database operations
├── hooks.ts        # Auth-related form hooks
└── components/     # Auth UI components

import { getAuth } from "@/lib/auth/server";

// Get current session
const auth = await getAuth();

if (auth?.user) {
  console.log("Logged in as:", auth.user.email);
}

"use client";

import { useAuth } from "@/lib/auth/client";

export function UserProfile() {
  const { user, isAuthenticated, signOut } = useAuth();

  if (!isAuthenticated) return <LoginPrompt />;

  return (
    <div>
      Welcome, {user.name}
      <button onClick={() => signOut()}>Logout</button>
    </div>
  );
}

import { FormLogin } from "@/features/auth/components";

<FormLogin
  onSuccess={() => router.push(PageDashboard())}
  showSocialProviders={true}
/>

import { FormRegister } from "@/features/auth/components";

<FormRegister onSuccess={() => router.push(PageLogin())} />

import { UserDropdown } from "@/features/auth/components";

<UserDropdown /> // Shows user menu or login button

// src/routes/routing.ts
PagesRequiringAuth: () => [
  PageSettingsProfile,
  PageDashboard,
  PageAdmin,
],