# atulvermagithub/better-auth-complete-auth architecture

> Architecture diagram of the GitHub repository atulvermagithub/better-auth-complete-auth, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-10-28). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/atulvermagithub/better-auth-complete-auth
- Repository: https://github.com/atulvermagithub/better-auth-complete-auth

## Overview

##### Project type and purpose
- This is a full-stack web application built on Next.js (React + server-side/edge functions).
- Its main domain is user authentication (sign-in, 2FA, password reset), organization/invite management, user profiles, and related workflows (email delivery, Stripe subscriptions).

##### File structure
- Top-level files: next.config.ts, docker-compose.yml, drizzle.config.ts, package.json, README.md, etc.
- src/app: Next.js “app router” pages and API routes under src/app/api/auth.
- src/app/auth, src/app/login, src/app/2fa, src/app/reset-password → authentication UIs.
- src/app/admin → admin UI.
- src/app/organizations, invites → org management UI.
- src/app/profile → user profile UI.
- src/components: shared React UI components (buttons, dialogs, tables).
- src/lib: library code for auth clients, OAuth providers, Stripe integration, email templates and delivery, utility functions.
- src/drizzle: Drizzle ORM setup and schema definitions for the database.
- Configuration: .env.example, docker-compose.yml (likely brings up the database), drizzle.config.ts.

##### README for additional insights
- Bootstrapped with create-next-app.

##### Detail
- Routes (e.g., /api/auth/[...all]) and their responsibilities.
- Drizzle schema folder feeding into the ORM layer.
- Call out the email templates and Stripe module in the business logic layer.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Client Layer
    Browser["Browser (User)"]:::frontend

    %% Next.js Server Layer
    subgraph "Next.js Server / Edge Functions"
        direction TB
        subgraph "UI Rendering" 
            direction TB
            NextApp["Next.js App Router"]:::frontend
            AuthLogin["Sign-in/Sign-up UI"]:::frontend
            Auth2FA["Two-Factor Auth UI"]:::frontend
            AuthReset["Password Reset UI"]:::frontend
            AdminUI["Admin UI"]:::frontend
            OrgUI["Organizations UI"]:::frontend
            InvitesUI["Invites Workflow UI"]:::frontend
            ProfileUI["User Profile UI"]:::frontend
        end
        subgraph "API Functions"
            direction TB
            AuthAPI["Auth API Routes"]:::backend
        end
        subgraph "Business Logic (src/lib)"
            direction TB
            AuthClient["Auth Client Library"]:::backend
            AuthCore["Core Auth Routines"]:::backend
            OAuthProviders["OAuth Provider Config"]:::backend
            StripeModule["Stripe Integration Module"]:::backend
            EmailTemplates["Email Templates"]:::backend
            SendEmail["Email Sending Logic"]:::backend
            Utils["Utility Functions"]:::backend
        end
    end

    %% Data Layer
    subgraph "Data Access"
        direction TB
        DrizzleConfig["Schema Entry (schema.ts)"]:::db
        DrizzleDB["ORM Config & Client (db.ts)"]:::db
        AuthSchema["Auth Schema Definitions"]:::db
        PostgreSQL[(PostgreSQL DB)]:::db
    end

    %% External Services
    subgraph "External Services"
        direction TB
        OAuthExt["OAuth Providers"]:::external
        EmailExt["Email Delivery Service"]:::external
        StripeExt["Stripe (Billing)"]:::external
    end

    %% Infrastructure
    subgraph "Infrastructure & Config"
        direction TB
        NextConfig["Next.js Config"]:::infra
        DockerCompose["Docker Compose"]:::infra
        DrizzleCfg["Drizzle Config"]:::infra
    end

    %% Connections
    Browser -->|"HTTP/HTTPS"| NextApp
    NextApp -->|"renders UI"| Browser
    NextApp -->|"routes to"| AuthLogin
    NextApp -->|"routes to"| Auth2FA
    NextApp -->|"routes to"| AuthReset
    NextApp -->|"routes to"| AdminUI
    NextApp -->|"routes to"| OrgUI
    NextApp -->|"routes to"| InvitesUI
    NextApp -->|"routes to"| ProfileUI

    AuthLogin -->|"calls API"| AuthAPI
    Auth2FA -->|"calls API"| AuthAPI
    AuthReset -->|"calls API"| AuthAPI
    AdminUI -->|"calls API"| AuthAPI
    OrgUI -->|"calls API"| AuthAPI
    InvitesUI -->|"calls API"| AuthAPI
    ProfileUI -->|"calls API"| AuthAPI

    AuthAPI -->|"uses"| AuthClient
    AuthAPI -->|"uses"| AuthCore
    AuthAPI -->|"uses"| OAuthProviders
    AuthAPI -->|"uses"| StripeModule
    AuthAPI -->|"uses"| SendEmail
    AuthAPI -->|"uses"| Utils

    AuthClient -->|"queries"| DrizzleDB
    AuthCore -->|"queries"| DrizzleDB
    StripeModule -->|"writes"| DrizzleDB
    SendEmail -->|"logs"| DrizzleDB

    DrizzleConfig --> DrizzleDB
    DrizzleDB --> DrizzleConfig

    DrizzleDB -->|"reads/writes"| PostgreSQL
    DrizzleConfig -->|"defines"| AuthSchema
    AuthSchema --> DrizzleDB

    AuthAPI -->|"redirects to/callback from"| OAuthExt
    SendEmail -->|"sends via"| EmailExt
    StripeModule -->|"webhooks/calls"| StripeExt

    DockerCompose --> PostgreSQL
    NextConfig --> NextApp
    DrizzleCfg --> DrizzleDB

    %% Click Events
    click NextApp "https://github.com/atulvermagithub/better-auth-complete-auth/tree/main/src/app"
    click AuthLogin "https://github.com/atulvermagithub/better-auth-complete-auth/tree/main/src/app/auth/login"
    click Auth2FA "https://github.com/atulvermagithub/better-auth-complete-auth/tree/main/src/app/auth/2fa"
    click AuthReset "https://github.com/atulvermagithub/better-auth-complete-auth/tree/main/src/app/auth/reset-password"
    click AdminUI "https://github.com/atulvermagithub/better-auth-complete-auth/tree/main/src/app/admin"
    click OrgUI "https://github.com/atulvermagithub/better-auth-complete-auth/tree/main/src/app/organizations"
    click InvitesUI "https://github.com/atulvermagithub/better-auth-complete-auth/tree/main/src/app/organizations/invites"
    click ProfileUI "https://github.com/atulvermagithub/better-auth-complete-auth/tree/main/src/app/profile"
    click AuthAPI "https://github.com/atulvermagithub/better-auth-complete-auth/blob/main/src/app/api/auth/[...all]/route.ts"
    click AuthClient "https://github.com/atulvermagithub/better-auth-complete-auth/blob/main/src/lib/auth/auth-client.ts"
    click AuthCore "https://github.com/atulvermagithub/better-auth-complete-auth/blob/main/src/lib/auth/auth.ts"
    click OAuthProviders "https://github.com/atulvermagithub/better-auth-complete-auth/blob/main/src/lib/auth/o-auth-providers.ts"
    click StripeModule "https://github.com/atulvermagithub/better-auth-complete-auth/blob/main/src/lib/auth/stripe.ts"
    click EmailTemplates "https://github.com/atulvermagithub/better-auth-complete-auth/blob/main/src/lib/emails/email-verification.ts"
    click SendEmail "https://github.com/atulvermagithub/better-auth-complete-auth/blob/main/src/lib/emails/send-email.ts"
    click Utils "https://github.com/atulvermagithub/better-auth-complete-auth/blob/main/src/lib/utils.ts"
    click DrizzleDB "https://github.com/atulvermagithub/better-auth-complete-auth/blob/main/src/drizzle/db.ts"
    click DrizzleConfig "https://github.com/atulvermagithub/better-auth-complete-auth/blob/main/src/drizzle/schema.ts"
    click AuthSchema "https://github.com/atulvermagithub/better-auth-complete-auth/blob/main/src/drizzle/schemas/auth-schema.ts"
    click NextConfig "https://github.com/atulvermagithub/better-auth-complete-auth/blob/main/next.config.ts"
    click DockerCompose "https://github.com/atulvermagithub/better-auth-complete-auth/blob/main/docker-compose.yml"
    click DrizzleCfg "https://github.com/atulvermagithub/better-auth-complete-auth/blob/main/drizzle.config.ts"

    %% Styles
    classDef frontend fill:#D0E8FF,stroke:#0366d6,color:#0366d6
    classDef backend fill:#E8F4D0,stroke:#22863a,color:#22863a
    classDef db fill:#FFF5B1,stroke:#D29922,color:#D29922
    classDef external fill:#FFE4D0,stroke:#D15704,color:#D15704
    classDef infra fill:#F0F0F0,stroke:#6A737D,color:#6A737D
```
