# anikkapat/ai-finance-tracker architecture

> Architecture diagram of the GitHub repository anikkapat/ai-finance-tracker, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/anikkapat/ai-finance-tracker
- Repository: https://github.com/anikkapat/ai-finance-tracker

## Overview

PennyPal is a personal-finance web app for managing accounts, recording income and expenses, and reviewing budgets and financial activity. The main flow is account setup and transaction entry, with optional receipt extraction, followed by dashboard/account views backed by server actions and PostgreSQL. The README also describes Gemini insights, scheduled email workflows, Clerk authentication, and Arcjet rate limiting. Some of those capabilities are documented but not fully shown in the sampled source, so those links are marked as unverified where appropriate.

Main entry points: [`actions/transaction.js`](https://github.com/anikkapat/ai-finance-tracker/blob/main/actions/transaction.js) (Transaction actions), [`app/(main)/dashboard/page.jsx`](https://github.com/anikkapat/ai-finance-tracker/blob/main/app/(main)/dashboard/page.jsx) (Dashboard), [`lib/prisma.js`](https://github.com/anikkapat/ai-finance-tracker/blob/main/lib/prisma.js) (PostgreSQL via Prisma), [`app/(main)/transaction/_components/transaction-form.jsx`](https://github.com/anikkapat/ai-finance-tracker/blob/main/app/(main)/transaction/_components/transaction-form.jsx) (Transaction entry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["User experience"]
  node_dashboard["Dashboard<br/>[page.jsx]"]
  node_account_view["Account detail<br/>[page.jsx]"]
  node_account_form["Account creation"]
  node_transaction_entry["Transaction entry"]
  node_receipt_scanner["Receipt scanner<br/>[recipt-scanner.jsx]"]
  node_transaction_table["Transaction table"]
  node_account_chart["Account chart<br/>[account-chart.jsx]"]
  node_dashboard_widgets["Dashboard widgets<br/>[account-card.jsx]"]
  node_budget_widget["Budget progress"]
  node_transaction_overview["Transaction overview"]
end

subgraph group_finance["Finance workflows"]
  node_account_actions["Account actions<br/>[account.js]"]
  node_dashboard_actions["Dashboard actions<br/>[dashboard.js]"]
  node_budget_actions["Budget actions<br/>[budget.js]"]
  node_transaction_actions["Transaction actions<br/>[transaction.js]"]
  node_validation["Input validation<br/>[schema.js]"]
  node_categories["Finance categories<br/>[categories.js]"]
end

subgraph group_services["Platform services"]
  node_database[("PostgreSQL via Prisma<br/>[prisma.js]")]
  node_clerk["Clerk authentication"]
  node_arcjet["Arcjet rate limiting<br/>[arcjet.js]"]
  node_gemini["Gemini AI"]
end

subgraph group_jobs["Background jobs"]
  node_inngest_route["Inngest endpoint<br/>[route.js]"]
  node_inngest_functions["Scheduled workflows<br/>[function.js]"]
  node_email["Email delivery<br/>[send-email.js]"]
  node_email_template["Email template<br/>[template.jsx]"]
end

node_person(("Finance user"))

node_person -->|"creates account"| node_account_form
node_account_form -->|"calls createAccount"| node_dashboard_actions
node_person -.->|"records activity"| node_transaction_entry
node_transaction_entry -->|"submits transaction"| node_transaction_actions
node_transaction_entry -->|"validates input"| node_validation
node_transaction_entry -->|"offers scanning"| node_receipt_scanner
node_receipt_scanner -.->|"requests extraction"| node_transaction_actions
node_transaction_actions -->|"extracts receipt data"| node_gemini
node_transaction_actions -->|"checks limits"| node_arcjet
node_transaction_actions -->|"reads and writes"| node_database
node_transaction_actions -->|"authenticates user"| node_clerk
node_account_actions -->|"reads and writes"| node_database
node_account_actions -->|"authenticates user"| node_clerk
node_dashboard_actions -->|"reads and writes"| node_database
node_dashboard_actions -->|"checks limits"| node_arcjet
node_budget_actions -->|"reads and writes"| node_database
node_dashboard -->|"loads dashboard data"| node_dashboard_actions
node_dashboard -->|"loads budget"| node_budget_actions
node_dashboard -->|"renders accounts"| node_dashboard_widgets
node_dashboard -->|"renders budget"| node_budget_widget
node_dashboard -->|"renders activity"| node_transaction_overview
node_account_view -->|"loads account"| node_account_actions
node_account_view -->|"renders transactions"| node_transaction_table
node_account_view -->|"renders trends"| node_account_chart
node_transaction_actions -.->|"uses categories"| node_categories
node_inngest_route -->|"registers handlers"| node_inngest_functions
node_inngest_functions -->|"renders email"| node_email_template
node_inngest_functions -->|"sends email"| node_email
node_inngest_functions -->|"reads finance data"| node_database
node_dashboard -.->|"offers AI insights"| node_gemini

click node_dashboard "https://github.com/anikkapat/ai-finance-tracker/blob/main/app/(main)/dashboard/page.jsx"
click node_account_view "https://github.com/anikkapat/ai-finance-tracker/blob/main/app/(main)/account/%5Bid%5D/page.jsx"
click node_account_form "https://github.com/anikkapat/ai-finance-tracker/blob/main/components/create-account-drawer.jsx"
click node_transaction_entry "https://github.com/anikkapat/ai-finance-tracker/blob/main/app/(main)/transaction/_components/transaction-form.jsx"
click node_receipt_scanner "https://github.com/anikkapat/ai-finance-tracker/blob/main/app/(main)/transaction/_components/recipt-scanner.jsx"
click node_transaction_table "https://github.com/anikkapat/ai-finance-tracker/blob/main/app/(main)/account/_components/transaction-table.jsx"
click node_account_chart "https://github.com/anikkapat/ai-finance-tracker/blob/main/app/(main)/account/_components/account-chart.jsx"
click node_dashboard_widgets "https://github.com/anikkapat/ai-finance-tracker/blob/main/app/(main)/dashboard/_components/account-card.jsx"
click node_budget_widget "https://github.com/anikkapat/ai-finance-tracker/blob/main/app/(main)/dashboard/_components/budget-progress.jsx"
click node_transaction_overview "https://github.com/anikkapat/ai-finance-tracker/blob/main/app/(main)/dashboard/_components/transaction-overview.jsx"
click node_account_actions "https://github.com/anikkapat/ai-finance-tracker/blob/main/actions/account.js"
click node_dashboard_actions "https://github.com/anikkapat/ai-finance-tracker/blob/main/actions/dashboard.js"
click node_budget_actions "https://github.com/anikkapat/ai-finance-tracker/blob/main/actions/budget.js"
click node_transaction_actions "https://github.com/anikkapat/ai-finance-tracker/blob/main/actions/transaction.js"
click node_validation "https://github.com/anikkapat/ai-finance-tracker/blob/main/app/lib/schema.js"
click node_categories "https://github.com/anikkapat/ai-finance-tracker/blob/main/data/categories.js"
click node_database "https://github.com/anikkapat/ai-finance-tracker/blob/main/lib/prisma.js"
click node_arcjet "https://github.com/anikkapat/ai-finance-tracker/blob/main/lib/arcjet.js"
click node_inngest_route "https://github.com/anikkapat/ai-finance-tracker/blob/main/app/api/inngest/route.js"
click node_inngest_functions "https://github.com/anikkapat/ai-finance-tracker/blob/main/lib/inngest/function.js"
click node_email "https://github.com/anikkapat/ai-finance-tracker/blob/main/lib/send-email.js"
click node_email_template "https://github.com/anikkapat/ai-finance-tracker/blob/main/emails/template.jsx"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_dashboard,node_account_view,node_account_form,node_transaction_entry,node_receipt_scanner,node_transaction_table,node_account_chart,node_dashboard_widgets,node_budget_widget,node_transaction_overview,node_person toneBlue
class node_account_actions,node_dashboard_actions,node_budget_actions,node_transaction_actions,node_validation,node_categories toneAmber
class node_database,node_clerk,node_arcjet,node_gemini toneMint
class node_inngest_route,node_inngest_functions,node_email,node_email_template toneRose
```

## Components

### User experience

- [Dashboard](https://github.com/anikkapat/ai-finance-tracker/blob/main/app/(main)/dashboard/page.jsx): `app/(main)/dashboard/page.jsx`
- [Account detail](https://github.com/anikkapat/ai-finance-tracker/blob/main/app/(main)/account/%5Bid%5D/page.jsx): `app/(main)/account/[id]/page.jsx`
- [Account creation](https://github.com/anikkapat/ai-finance-tracker/blob/main/components/create-account-drawer.jsx): `components/create-account-drawer.jsx`
- [Transaction entry](https://github.com/anikkapat/ai-finance-tracker/blob/main/app/(main)/transaction/_components/transaction-form.jsx): `app/(main)/transaction/_components/transaction-form.jsx`
- [Receipt scanner](https://github.com/anikkapat/ai-finance-tracker/blob/main/app/(main)/transaction/_components/recipt-scanner.jsx): `app/(main)/transaction/_components/recipt-scanner.jsx`
- [Transaction table](https://github.com/anikkapat/ai-finance-tracker/blob/main/app/(main)/account/_components/transaction-table.jsx): `app/(main)/account/_components/transaction-table.jsx`
- [Account chart](https://github.com/anikkapat/ai-finance-tracker/blob/main/app/(main)/account/_components/account-chart.jsx): `app/(main)/account/_components/account-chart.jsx`
- [Dashboard widgets](https://github.com/anikkapat/ai-finance-tracker/blob/main/app/(main)/dashboard/_components/account-card.jsx): `app/(main)/dashboard/_components/account-card.jsx`
- [Budget progress](https://github.com/anikkapat/ai-finance-tracker/blob/main/app/(main)/dashboard/_components/budget-progress.jsx): `app/(main)/dashboard/_components/budget-progress.jsx`
- [Transaction overview](https://github.com/anikkapat/ai-finance-tracker/blob/main/app/(main)/dashboard/_components/transaction-overview.jsx): `app/(main)/dashboard/_components/transaction-overview.jsx`

### Finance workflows

- [Account actions](https://github.com/anikkapat/ai-finance-tracker/blob/main/actions/account.js): `actions/account.js`
- [Dashboard actions](https://github.com/anikkapat/ai-finance-tracker/blob/main/actions/dashboard.js): `actions/dashboard.js`
- [Budget actions](https://github.com/anikkapat/ai-finance-tracker/blob/main/actions/budget.js): `actions/budget.js`
- [Transaction actions](https://github.com/anikkapat/ai-finance-tracker/blob/main/actions/transaction.js): `actions/transaction.js`
- [Input validation](https://github.com/anikkapat/ai-finance-tracker/blob/main/app/lib/schema.js): `app/lib/schema.js`
- [Finance categories](https://github.com/anikkapat/ai-finance-tracker/blob/main/data/categories.js): `data/categories.js`

### Platform services

- [PostgreSQL via Prisma](https://github.com/anikkapat/ai-finance-tracker/blob/main/lib/prisma.js): `lib/prisma.js`
- **Clerk authentication**
- [Arcjet rate limiting](https://github.com/anikkapat/ai-finance-tracker/blob/main/lib/arcjet.js): `lib/arcjet.js`
- **Gemini AI**

### Background jobs

- [Inngest endpoint](https://github.com/anikkapat/ai-finance-tracker/blob/main/app/api/inngest/route.js): `app/api/inngest/route.js`
- [Scheduled workflows](https://github.com/anikkapat/ai-finance-tracker/blob/main/lib/inngest/function.js): `lib/inngest/function.js`
- [Email delivery](https://github.com/anikkapat/ai-finance-tracker/blob/main/lib/send-email.js): `lib/send-email.js`
- [Email template](https://github.com/anikkapat/ai-finance-tracker/blob/main/emails/template.jsx): `emails/template.jsx`

### Other components

- **Finance user**

## Connections

- Finance user → Account creation: creates account (evidence: `components/create-account-drawer.jsx`)
- Account creation → Dashboard actions: calls createAccount (evidence: `components/create-account-drawer.jsx`)
- Finance user → Transaction entry: records activity
- Transaction entry → Transaction actions: submits transaction (evidence: `app/(main)/transaction/_components/transaction-form.jsx`)
- Transaction entry → Input validation: validates input (evidence: `app/(main)/transaction/_components/transaction-form.jsx`)
- Transaction entry → Receipt scanner: offers scanning (evidence: `app/(main)/transaction/_components/transaction-form.jsx`)
- Receipt scanner → Transaction actions: requests extraction
- Transaction actions → Gemini AI: extracts receipt data (evidence: `actions/transaction.js`)
- Transaction actions → Arcjet rate limiting: checks limits (evidence: `actions/transaction.js`)
- Transaction actions → PostgreSQL via Prisma: reads and writes (evidence: `actions/transaction.js`)
- Transaction actions → Clerk authentication: authenticates user (evidence: `actions/transaction.js`)
- Account actions → PostgreSQL via Prisma: reads and writes (evidence: `actions/account.js`)
- Account actions → Clerk authentication: authenticates user (evidence: `actions/account.js`)
- Dashboard actions → PostgreSQL via Prisma: reads and writes (evidence: `actions/dashboard.js`)
- Dashboard actions → Arcjet rate limiting: checks limits (evidence: `actions/dashboard.js`)
- Budget actions → PostgreSQL via Prisma: reads and writes (evidence: `actions/budget.js`)
- Dashboard → Dashboard actions: loads dashboard data (evidence: `app/(main)/dashboard/page.jsx`)
- Dashboard → Budget actions: loads budget (evidence: `app/(main)/dashboard/page.jsx`)
- Dashboard → Dashboard widgets: renders accounts (evidence: `app/(main)/dashboard/page.jsx`)
- Dashboard → Budget progress: renders budget (evidence: `app/(main)/dashboard/page.jsx`)
- Dashboard → Transaction overview: renders activity (evidence: `app/(main)/dashboard/page.jsx`)
- Account detail → Account actions: loads account (evidence: `app/(main)/account/[id]/page.jsx`)
- Account detail → Transaction table: renders transactions (evidence: `app/(main)/account/[id]/page.jsx`)
- Account detail → Account chart: renders trends (evidence: `app/(main)/account/[id]/page.jsx`)
- Transaction actions → Finance categories: uses categories
- Inngest endpoint → Scheduled workflows: registers handlers (evidence: `app/api/inngest/route.js`)
- Scheduled workflows → Email template: renders email (evidence: `lib/inngest/function.js`)
- Scheduled workflows → Email delivery: sends email (evidence: `lib/inngest/function.js`)
- Scheduled workflows → PostgreSQL via Prisma: reads finance data (evidence: `lib/inngest/function.js`)
- Dashboard → Gemini AI: offers AI insights
