# taimetan/expenses-tracker architecture

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

- Interactive diagram: https://gitdiagram.com/taimetan/expenses-tracker
- Repository: https://github.com/taimetan/expenses-tracker

## Overview

##### Project type and purpose
- This is a full-stack web application built with Next.js (React framework) that provides budgeting, expense, income, and reminder management with authentication. It uses server-side and client-side rendering, serverless API routes, and Firebase (Auth + Firestore) as its backend.

##### File structure
- Top-level Next.js config files: next.config.ts, tsconfig.json, postcss.config.mjs, etc.
- src/app: the Next.js “app router” directory containing two route groups:
- (src/app/(auth)): pages for login, register, and password reset
- (src/app/(main)): protected app pages (dashboard, budgets, expenses, incomes, reminders, settings)
- app/api/expenses/route.ts: one example of a serverless API route
- src/components: presentational and container components, organized by feature (dashboard, expenses, etc.)
- src/contexts + src/providers + src/hooks: React Context and custom hooks for Auth state and actions
- src/services: abstractions over fetch calls to serverless API endpoints (budgetService, expenseService, etc.)
- src/config + src/lib: Firebase initialization and configuration (initFirebase.ts, firebase.ts)
- src/models: TypeScript interfaces for domain entities (budget, expense, income, reminder)

##### README
- Confirms it’s a Next.js app bootstrapped via create-next-app

##### Final advice
- Be exhaustive: break the system into the above components, even if they’re “internal” (context, hooks, services).
- Essential layers: UI, state management, API, database, external services.

## Diagram (Mermaid)

```mermaid
flowchart TD
  %% User & UI Layer
  Browser["User Browser"]:::external
  subgraph "Next.js Application"
    direction TB
    PageApp["src/app"]:::frontend
    click PageApp "https://github.com/taimetan/expenses-tracker/tree/main/src/app"
    Layout["layout.tsx & globals.css & page.tsx"]:::frontend
    click Layout "https://github.com/taimetan/expenses-tracker/blob/main/src/app/layout.tsx"
    click Layout "https://github.com/taimetan/expenses-tracker/blob/main/src/app/globals.css"
    click Layout "https://github.com/taimetan/expenses-tracker/blob/main/src/app/page.tsx"
    subgraph "Authentication Pages"
      direction TB
      LoginPage["Login Page"]:::frontend
      click LoginPage "https://github.com/taimetan/expenses-tracker/blob/main/src/app/(auth)/login/page.tsx"
      RegisterPage["Register Page"]:::frontend
      click RegisterPage "https://github.com/taimetan/expenses-tracker/blob/main/src/app/(auth)/register/page.tsx"
      ForgotPage["Forgot Password Page"]:::frontend
      click ForgotPage "https://github.com/taimetan/expenses-tracker/blob/main/src/app/(auth)/forgot-password/page.tsx"
    end
    subgraph "Protected Main Pages"
      direction TB
      DashboardPage["Dashboard"]:::frontend
      click DashboardPage "https://github.com/taimetan/expenses-tracker/blob/main/src/app/(main)/dashboard/page.tsx"
      BudgetsPage["Budgets"]:::frontend
      click BudgetsPage "https://github.com/taimetan/expenses-tracker/blob/main/src/app/(main)/budgets/page.tsx"
      ExpensesPage["Expenses"]:::frontend
      click ExpensesPage "https://github.com/taimetan/expenses-tracker/blob/main/src/app/(main)/expenses/page.tsx"
      IncomesPage["Incomes"]:::frontend
      click IncomesPage "https://github.com/taimetan/expenses-tracker/blob/main/src/app/(main)/incomes/page.tsx"
      RemindersPage["Reminders"]:::frontend
      click RemindersPage "https://github.com/taimetan/expenses-tracker/blob/main/src/app/(main)/reminders/page.tsx"
      SettingsPage["Settings"]:::frontend
      click SettingsPage "https://github.com/taimetan/expenses-tracker/blob/main/src/app/(main)/settings/page.tsx"
    end
  end

  Browser -->|"Loads Next.js Pages (SSR & Hydration)"| PageApp
  PageApp -->|"Renders Layout & Pages"| Layout
  Layout -->|"Routes to Auth or Main Pages"| LoginPage
  Layout --> RegisterPage
  Layout --> ForgotPage
  Layout --> DashboardPage
  Layout --> BudgetsPage
  Layout --> ExpensesPage
  Layout --> IncomesPage
  Layout --> RemindersPage
  Layout --> SettingsPage

  %% State Management
  subgraph "Auth Context & Hooks"
    direction TB
    AuthCtx["AuthContext"]:::state
    click AuthCtx "https://github.com/taimetan/expenses-tracker/blob/main/src/contexts/AuthContext.tsx"
    AuthProvider["AuthProvider"]:::state
    click AuthProvider "https://github.com/taimetan/expenses-tracker/blob/main/src/providers/AuthProvider.tsx"
    AuthHooks["useAuthActions"]:::state
    click AuthHooks "https://github.com/taimetan/expenses-tracker/blob/main/src/hooks/useAuthActions.ts"
  end
  DashboardPage -->|"Uses AuthContext"| AuthCtx
  BudgetsPage --> AuthCtx
  ExpensesPage --> AuthCtx
  IncomesPage --> AuthCtx
  RemindersPage --> AuthCtx
  SettingsPage --> AuthCtx

  %% Service Layer
  subgraph "Service Layer"
    direction TB
    BudgetService["budgetService"]:::backend
    click BudgetService "https://github.com/taimetan/expenses-tracker/blob/main/src/services/budgetService.ts"
    ExpenseService["expenseService"]:::backend
    click ExpenseService "https://github.com/taimetan/expenses-tracker/blob/main/src/services/expenseService.ts"
    IncomeService["incomeService"]:::backend
    click IncomeService "https://github.com/taimetan/expenses-tracker/blob/main/src/services/incomeService.ts"
    ReminderService["reminderService"]:::backend
    click ReminderService "https://github.com/taimetan/expenses-tracker/blob/main/src/services/reminderService.ts"
    ExportService["exportService"]:::backend
    click ExportService "https://github.com/taimetan/expenses-tracker/blob/main/src/services/exportService.ts"
  end
  DashboardPage -->|"Calls Services"| BudgetService
  ExpensesPage --> ExpenseService
  IncomesPage --> IncomeService
  RemindersPage --> ReminderService

  %% API Routes
  subgraph "Next.js API Routes"
    direction TB
    ExpensesAPI["/api/expenses"]:::api
    click ExpensesAPI "https://github.com/taimetan/expenses-tracker/blob/main/src/app/api/expenses/route.ts"
  end
  ExpenseService -->|"fetch() to /api/expenses"| ExpensesAPI

  %% Firebase SDK & Database
  subgraph "Firebase & Database"
    direction TB
    FirebaseAuthSDK["Firebase Auth SDK"]:::external
    FirestoreSDK["Firestore SDK"]:::backend
    FirestoreDB[("Firestore Database")]:::database
    click FirebaseAuthSDK "https://github.com/taimetan/expenses-tracker/blob/main/src/lib/initFirebase.ts"
    click FirestoreSDK "https://github.com/taimetan/expenses-tracker/blob/main/src/config/firebase.ts"
  end
  AuthCtx -->|"Auth SDK Calls"| FirebaseAuthSDK
  ExpensesAPI -->|"Uses Firestore SDK"| FirestoreSDK
  FirestoreSDK -->|"Read/Write Data"| FirestoreDB
  ExpenseService -->|"Direct Auth Calls"| FirebaseAuthSDK

  %% Styling
  classDef frontend fill:#D0E6FF,stroke:#1E70BF;
  classDef backend fill:#D0FFD6,stroke:#1E7F3E;
  classDef external fill:#FFE8A1,stroke:#BF7700;
  classDef api fill:#E0E0E0,stroke:#666666,stroke-dasharray: 5 5;
  classDef database fill:#FFF0D6,stroke:#CCAA66,stroke-width:2px;
  classDef state fill:#E8D0FF,stroke:#7F3EBF;
  class Browser,LoginPage,RegisterPage,ForgotPage,DashboardPage,BudgetsPage,ExpensesPage,IncomesPage,RemindersPage,SettingsPage frontend;
  class AuthCtx,AuthProvider,AuthHooks state;
  class BudgetService,ExpenseService,IncomeService,ReminderService,ExportService backend;
  class ExpensesAPI api;
  class FirebaseAuthSDK external;
  class FirestoreSDK backend;
  class FirestoreDB database;
```
