# vainamigo/fn-tracker architecture

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

- Interactive diagram: https://gitdiagram.com/vainamigo/fn-tracker
- Repository: https://github.com/vainamigo/fn-tracker

## Overview

fn_tracker is a Flutter personal-finance tracker. Its tree indicates a user workflow spanning transaction entry and categorization, account and budget management, analytics, and supporting AI, authentication, and export features. The graph represents those distinct product areas and shared app infrastructure; its relationships are dashed because the supplied source excerpts do not include the Dart feature implementations. The README is only a generic Flutter-project starter and does not document product behavior.

Main entry points: [`lib/features/main`](https://github.com/vainamigo/fn-tracker/tree/main/lib/features/main) (App shell), [`lib/core/firestore`](https://github.com/vainamigo/fn-tracker/tree/main/lib/core/firestore) (Firestore access), [`lib/features/finance/presentation/accounts`](https://github.com/vainamigo/fn-tracker/tree/main/lib/features/finance/presentation/accounts) (Wallets and goals), [`lib/features/analytics`](https://github.com/vainamigo/fn-tracker/tree/main/lib/features/analytics) (Analytics)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App infrastructure"]
  node_shell["App shell"]
  node_router["App routing<br/>[app_router.dart]"]
  node_shared["Shared UI"]
  node_firestore["Firestore access"]
end

subgraph group_finance["Finance management"]
  node_transactions["Transactions"]
  node_categories["Categories"]
  node_wallets["Wallets and goals"]
  node_budgets["Budgets"]
  node_scheduled["Scheduled payments"]
end

subgraph group_insights["Insights and assistance"]
  node_analytics["Analytics"]
  node_ai["AI assistance"]
end

subgraph group_access["Access and data tools"]
  node_auth["Authentication"]
  node_export["Data export"]
  node_settings["Settings"]
  node_firebase["Firebase services"]
end

node_user(("User"))

node_user -.->|"uses"| node_shell
node_shell -.->|"navigates"| node_router
node_shell -.->|"uses"| node_shared
node_shell -.->|"opens"| node_transactions
node_shell -.->|"opens"| node_categories
node_shell -.->|"opens"| node_wallets
node_shell -.->|"opens"| node_budgets
node_shell -.->|"opens"| node_scheduled
node_shell -.->|"opens"| node_analytics
node_shell -.->|"opens"| node_settings
node_auth -.->|"uses"| node_firebase
node_transactions -.->|"persists data"| node_firestore
node_wallets -.->|"persists data"| node_firestore
node_budgets -.->|"persists data"| node_firestore
node_scheduled -.->|"persists data"| node_firestore
node_analytics -.->|"reads data"| node_firestore
node_analytics -.->|"offers assistance"| node_ai
node_wallets -.->|"offers advice"| node_ai
node_export -.->|"exports data"| node_firestore

click node_shell "https://github.com/vainamigo/fn-tracker/tree/main/lib/features/main"
click node_router "https://github.com/vainamigo/fn-tracker/blob/main/lib/core/app_router/app_router.dart"
click node_shared "https://github.com/vainamigo/fn-tracker/tree/main/lib/components"
click node_firestore "https://github.com/vainamigo/fn-tracker/tree/main/lib/core/firestore"
click node_transactions "https://github.com/vainamigo/fn-tracker/tree/main/lib/features/transactions"
click node_categories "https://github.com/vainamigo/fn-tracker/tree/main/lib/features/finance/presentation/categories"
click node_wallets "https://github.com/vainamigo/fn-tracker/tree/main/lib/features/finance/presentation/accounts"
click node_budgets "https://github.com/vainamigo/fn-tracker/tree/main/lib/features/finance/presentation/budget"
click node_scheduled "https://github.com/vainamigo/fn-tracker/tree/main/lib/features/finance/presentation/scheduled_payments"
click node_analytics "https://github.com/vainamigo/fn-tracker/tree/main/lib/features/analytics"
click node_ai "https://github.com/vainamigo/fn-tracker/tree/main/lib/features/ai_logic"
click node_auth "https://github.com/vainamigo/fn-tracker/tree/main/lib/features/auth"
click node_export "https://github.com/vainamigo/fn-tracker/tree/main/lib/features/export"
click node_settings "https://github.com/vainamigo/fn-tracker/tree/main/lib/features/settings"
click node_firebase "https://github.com/vainamigo/fn-tracker/tree/main/lib/core/firebase"

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_shell,node_router,node_shared,node_firestore,node_user toneBlue
class node_transactions,node_categories,node_wallets,node_budgets,node_scheduled toneAmber
class node_analytics,node_ai toneMint
class node_auth,node_export,node_settings,node_firebase toneRose
```

## Components

### App infrastructure

- [App shell](https://github.com/vainamigo/fn-tracker/tree/main/lib/features/main): `lib/features/main`
- [App routing](https://github.com/vainamigo/fn-tracker/blob/main/lib/core/app_router/app_router.dart): `lib/core/app_router/app_router.dart`
- [Shared UI](https://github.com/vainamigo/fn-tracker/tree/main/lib/components): `lib/components`
- [Firestore access](https://github.com/vainamigo/fn-tracker/tree/main/lib/core/firestore): `lib/core/firestore`

### Finance management

- [Transactions](https://github.com/vainamigo/fn-tracker/tree/main/lib/features/transactions): `lib/features/transactions`
- [Categories](https://github.com/vainamigo/fn-tracker/tree/main/lib/features/finance/presentation/categories): `lib/features/finance/presentation/categories`
- [Wallets and goals](https://github.com/vainamigo/fn-tracker/tree/main/lib/features/finance/presentation/accounts): `lib/features/finance/presentation/accounts`
- [Budgets](https://github.com/vainamigo/fn-tracker/tree/main/lib/features/finance/presentation/budget): `lib/features/finance/presentation/budget`
- [Scheduled payments](https://github.com/vainamigo/fn-tracker/tree/main/lib/features/finance/presentation/scheduled_payments): `lib/features/finance/presentation/scheduled_payments`

### Insights and assistance

- [Analytics](https://github.com/vainamigo/fn-tracker/tree/main/lib/features/analytics): `lib/features/analytics`
- [AI assistance](https://github.com/vainamigo/fn-tracker/tree/main/lib/features/ai_logic): `lib/features/ai_logic`

### Access and data tools

- [Authentication](https://github.com/vainamigo/fn-tracker/tree/main/lib/features/auth): `lib/features/auth`
- [Data export](https://github.com/vainamigo/fn-tracker/tree/main/lib/features/export): `lib/features/export`
- [Settings](https://github.com/vainamigo/fn-tracker/tree/main/lib/features/settings): `lib/features/settings`
- [Firebase services](https://github.com/vainamigo/fn-tracker/tree/main/lib/core/firebase): `lib/core/firebase`

### Other components

- **User**

## Connections

- User → App shell: uses
- App shell → App routing: navigates
- App shell → Shared UI: uses
- App shell → Transactions: opens
- App shell → Categories: opens
- App shell → Wallets and goals: opens
- App shell → Budgets: opens
- App shell → Scheduled payments: opens
- App shell → Analytics: opens
- App shell → Settings: opens
- Authentication → Firebase services: uses
- Transactions → Firestore access: persists data
- Wallets and goals → Firestore access: persists data
- Budgets → Firestore access: persists data
- Scheduled payments → Firestore access: persists data
- Analytics → Firestore access: reads data
- Analytics → AI assistance: offers assistance
- Wallets and goals → AI assistance: offers advice
- Data export → Firestore access: exports data
