> ## Documentation Index
> Fetch the complete documentation index at: https://committ.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Authentication Flow

> Sign-in, welcome, and OAuth callback screens.

# Authentication Flow

The authentication flow consists of three screens that gate access to the protected (main) route group.

***

## Screen Sequence

```mermaid theme={null}
flowchart LR
    A["index.tsx (Onboarding)"] --> B["signin.tsx"]
    B --> C["welcome.tsx"]
    C --> D["(main)/commits.tsx"]
    D -.->|"Sign Out"| B
```

***

## index.tsx -- The Cold Start Screen

This is the atmospheric landing page shown on first launch. It performs a session check via authClient.useSession():

* **If session exists and user is at root (/):** Immediately redirects to /(main)/commits via router.replace().
* **If no session:** Renders the branded onboarding view with Reanimated entrance animations (FadeInDown, ZoomIn, FadeInUp) and a primary "Initialize Session" button.
* **Pathname guard:** Redirect only fires when pathname === "/", preventing accidental stack resets when the app re-mounts from background while deep in sub-screens.

***

## signin.tsx -- The Sign-In Screen

A minimal screen that renders the AuthForm component over a programmatic SVG gradient background. The AuthForm handles both email/password and Google OAuth via Better Auth.

***

## welcome.tsx -- Post-Authentication Landing

Shown after successful authentication. Displays the user's name from the active session and provides two actions:

| Action          | Behavior                                                                                           |
| :-------------- | :------------------------------------------------------------------------------------------------- |
| **Get Started** | Routes to /(main)/commits                                                                          |
| **Sign Out**    | Calls authClient.signOut() and GoogleSignin.signOut(), then replaces the route with /(auth)/signin |