# designdotdevanshu/aurthafi architecture

> Architecture diagram of the GitHub repository designdotdevanshu/aurthafi, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-15). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/designdotdevanshu/aurthafi
- Repository: https://github.com/designdotdevanshu/aurthafi

## Overview

##### Project type and purpose
- This is a full-stack Next.js application for personal finance management (accounts, budgets, transactions, dashboard).
- The README confirms it was bootstrapped with Create-Next-App and deployed on Vercel, using next/font and standard Next.js conventions.

##### File structure
- Top layers:
- app/ – Next.js App Router pages and layouts (protected routes under app/(protected), public/auth flows under app/auth)
- app/api/ – Next.js API routes (cron jobs, auth callbacks)
- components/ – React UI components (shared layout bits, auth, drawer, header, reusable forms)
- components/ui/ – design-system primitives (buttons, cards, table, chart, etc.)
- actions/ – server-side action functions handling auth, account, budget, transaction logic
- lib/ – Prisma setup (schema, client), shared constants, utils
- prisma/ – database migrations and schema.prisma
- utils/supabase/ – Supabase client, middleware, server helpers
- hooks/use-fetch – custom data-fetching hook
- data/ – static seed or landing data

- Key patterns:
- App Router with nested layouts for public vs protected.
- Server Actions (in actions/) invoked from server components.
- API routes used for scheduled tasks (cron/recurring-transactions) and OAuth callbacks.
- Prisma ORM talking to a relational database (likely PostgreSQL).
- Supabase as an external auth and realtime service.
- UI toolkit under components/ui for consistency.

##### README for additional insights
- Technology stack: Next.js, Vercel, Prisma, Supabase, Tailwind CSS (tailwind.config.ts), PostCSS.

##### Detailed breakdown
1. Client Layer (Browser)
- Pages: /, /auth/signin, /(protected)/dashboard, /(protected)/account/[id], /(protected)/transaction/create
- Components: header, footer, UI primitives

2. Next.js Server Layer
- App Router: layouts and pages under app/
- Server Actions: actions/*.ts (auth.ts, account.ts, transaction.ts, budget.ts, dashboard.ts)
- API Routes:
- /api/auth/* (callback, confirm)
- /api/cron/recurring-transactions
- Middleware: middleware.ts (route protection, supabase middleware)

3. Data & Integration Layer
- Prisma Client (lib/prisma.ts) → PostgreSQL (prisma/schema.prisma)
- Supabase Client (utils/supabase/client.ts) → Supabase Auth + DB (optional if using Supabase DB)

4. Infrastructure
- Vercel: Hosts Next.js, runs serverless functions, schedules cron jobs
- Prisma Migrations: prisma/migrations

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Client Layer
    subgraph "Client Layer"
        Browser["Browser Client"]:::frontend
        UIPrimitives["UI Component Library"]:::frontend
        SharedUI["Shared React Components"]:::frontend
        DataFetchHook["Custom Data-Fetching Hook"]:::frontend
    end

    click UIPrimitives "https://github.com/designdotdevanshu/aurthafi/tree/main/components/ui/"
    click SharedUI "https://github.com/designdotdevanshu/aurthafi/tree/main/components/"
    click DataFetchHook "https://github.com/designdotdevanshu/aurthafi/blob/main/hooks/use-fetch.ts"

    Browser -->|uses| UIPrimitives
    Browser -->|uses| SharedUI
    Browser -->|fetches data via| DataFetchHook

    %% Server Layer
    subgraph "Next.js Server Layer"
        AppRouter["Next.js App Router"]:::backend
        PublicRoutes["Public Auth Routes"]:::backend
        ProtectedRoutes["Protected Routes"]:::backend
        subgraph "Server Actions"
            AuthAction["auth.ts"]:::backend
            AccountAction["account.ts"]:::backend
            BudgetAction["budget.ts"]:::backend
            TransactionAction["transaction.ts"]:::backend
            DashboardAction["dashboard.ts"]:::backend
        end
        subgraph "API Routes"
            AuthAPI["/api/auth/*"]:::backend
            CronAPI["Cron Job Route"]:::scheduler
        end
        Middleware["Global Middleware"]:::backend
    end

    click AppRouter "https://github.com/designdotdevanshu/aurthafi/tree/main/app/"
    click PublicRoutes "https://github.com/designdotdevanshu/aurthafi/tree/main/app/auth/"
    click ProtectedRoutes "https://github.com/designdotdevanshu/aurthafi/tree/main/app/(protected)/"
    click AuthAction "https://github.com/designdotdevanshu/aurthafi/blob/main/actions/auth.ts"
    click AccountAction "https://github.com/designdotdevanshu/aurthafi/blob/main/actions/account.ts"
    click BudgetAction "https://github.com/designdotdevanshu/aurthafi/blob/main/actions/budget.ts"
    click TransactionAction "https://github.com/designdotdevanshu/aurthafi/blob/main/actions/transaction.ts"
    click DashboardAction "https://github.com/designdotdevanshu/aurthafi/blob/main/actions/dashboard.ts"
    click CronAPI "https://github.com/designdotdevanshu/aurthafi/blob/main/app/api/cron/recurring-transactions/route.ts"
    click Middleware "https://github.com/designdotdevanshu/aurthafi/blob/main/middleware.ts"

    Browser -->|navigates to| AppRouter
    AppRouter -->|routes| PublicRoutes
    AppRouter -->|routes| ProtectedRoutes
    AppRouter -->|invokes| AuthAction
    AppRouter -->|invokes| AccountAction
    AppRouter -->|invokes| BudgetAction
    AppRouter -->|invokes| TransactionAction
    AppRouter -->|invokes| DashboardAction
    AppRouter -->|handles| AuthAPI
    AppRouter -->|handles| CronAPI
    AppRouter -->|protects via| Middleware

    %% Data & Integration Layer
    subgraph "Data & Integration Layer"
        PrismaClient["Prisma Client"]:::db
        PrismaSchema["Prisma Schema"]:::db
        SupabaseClient["Supabase Client"]:::external
        SupabaseMiddleware["Supabase Middleware"]:::external
        SupabaseServer["Supabase Server Helpers"]:::external
    end

    click PrismaClient "https://github.com/designdotdevanshu/aurthafi/blob/main/lib/prisma.ts"
    click PrismaSchema "https://github.com/designdotdevanshu/aurthafi/blob/main/prisma/schema.prisma"
    click SupabaseClient "https://github.com/designdotdevanshu/aurthafi/blob/main/utils/supabase/client.ts"
    click SupabaseMiddleware "https://github.com/designdotdevanshu/aurthafi/blob/main/utils/supabase/middleware.ts"
    click SupabaseServer "https://github.com/designdotdevanshu/aurthafi/blob/main/utils/supabase/server.ts"

    AuthAction -->|CRUD| PrismaClient
    AccountAction -->|CRUD| PrismaClient
    BudgetAction -->|CRUD| PrismaClient
    TransactionAction -->|CRUD| PrismaClient
    DashboardAction -->|reads| PrismaClient

    AuthAction -->|auth| SupabaseClient
    Middleware -->|session| SupabaseMiddleware
    AuthAPI -->|callbacks| SupabaseServer

    %% Infra & External Services
    subgraph "Infra & External Services"
        Vercel["Vercel Hosting & Cron"]:::infra
        CronScheduler["Cron Scheduler"]:::scheduler
        StaticData["Static Data"]:::external
    end

    click Vercel "https://github.com/designdotdevanshu/aurthafi/blob/main/vercel.json"
    click StaticData "https://github.com/designdotdevanshu/aurthafi/tree/main/data/"

    Vercel -->|deploys| AppRouter
    Vercel -->|hosts| AuthAPI
    Vercel -->|hosts| CronAPI
    CronScheduler -->|triggers| CronAPI
    Vercel -->|runs migrations| PrismaSchema
    Vercel -->|serves| StaticData

    %% Styles
    classDef frontend fill:#e0f2ff,stroke:#0094ff,stroke-width:2px
    classDef backend fill:#e6ffed,stroke:#00aa00,stroke-width:2px
    classDef db fill:#f3f3f3,stroke:#999999,stroke-width:2px
    classDef external fill:#fff4e5,stroke:#ff9900,stroke-width:2px
    classDef scheduler fill:#f5e6ff,stroke:#9933ff,stroke-width:2px
    classDef infra fill:#f0e0cc,stroke:#cc6600,stroke-width:2px
```
