How atharvaagarwal-01/budget-planner works
FinTrack is a personal-finance web app: users authenticate, record income and expenses, then review balances, budgets, and analytics; settings provide base-currency and category management. TanStack route pages call API endpoints, which handle user-scoped data through the Netlify Blobs access layer. The README documents the major product capabilities, while sampled source confirms several page/API interactions and the storage implementation. Dashboard and analytics internals, and most API handler bodies, were not sampled, so some connections are shown as unverified rather than asserted.
Main entry points: db.ts Finance Data Access · transactions.tsx Transaction Logging · budget.tsx Budget Planner · auth.ts Server Auth
Components 25
Identity and Navigation
- Login and Signup
src/routes/login.tsx - Identity Context
src/lib/identity-context.tsx - Server Auth
src/lib/auth.ts - Identity Middleware
src/middleware/identity.ts - Auth Callback
src/components/CallbackHandler.tsx - Signup Role Hook
netlify/functions/identity-signup.ts - Navigation Sidebar
src/components/Sidebar.tsx - Entry Redirect
src/routes/index.tsx
Finance Workflows
- Dashboard
src/routes/dashboard.tsx - Transaction Logging
src/routes/transactions.tsx - Budget Planner
src/routes/budget.tsx - Financial Analytics
src/routes/analytics.tsx - Settings and Categories
src/routes/settings.tsx
Application API
- Transaction API
src/routes/api/transactions.ts - Transaction Item API
src/routes/api/transactions.$id.ts - Budget API
src/routes/api/budgets.ts - Budget Item API
src/routes/api/budgets.$id.ts - Category API
src/routes/api/categories.ts - User Settings API
src/routes/api/user-settings.ts - Exchange Rate API
src/routes/api/exchange-rates.ts
Persistence and Integrations
- Finance Data Access
src/lib/db.ts - Netlify Blobs
- Netlify Identity
- Exchange Rate Service
Other components
- User
Connections 36
- User → Login and Signup: signs in
README.md - Login and Signup → Identity Context: authenticates
src/routes/login.tsx - Auth Callback → Netlify Identity: handles callback
src/components/CallbackHandler.tsx - Identity Context → Netlify Identity: reads auth state
src/lib/identity-context.tsx - Navigation Sidebar → Identity Context: reads user state
src/components/Sidebar.tsx - Navigation Sidebar → User: signs out
src/components/Sidebar.tsx - Entry Redirect → Server Auth: checks user
src/routes/index.tsx - Server Auth → Netlify Identity: gets user
src/lib/auth.ts - User → Dashboard: views overview
README.md - User → Transaction Logging: logs transactions
README.md - User → Budget Planner: plans spending
README.md - User → Financial Analytics: reviews trends
README.md - User → Settings and Categories: manages preferences
README.md - Transaction Logging → Server Auth: checks user
src/routes/transactions.tsx - Budget Planner → Server Auth: checks user
src/routes/budget.tsx - Settings and Categories → Server Auth: checks user
src/routes/settings.tsx - Transaction Logging → Transaction API: fetches data
src/routes/transactions.tsx - Transaction Logging → Category API: fetches categories
- Transaction Logging → User Settings API: fetches preferences
src/routes/transactions.tsx - Transaction Logging → Exchange Rate API: loads rates
src/routes/transactions.tsx - Budget Planner → Budget API: saves budgets
src/routes/budget.tsx - Budget Planner → Transaction API: loads spending
- Budget Planner → Category API: loads categories
- Budget Planner → User Settings API: loads preferences
src/routes/budget.tsx - Settings and Categories → Category API: manages categories
src/routes/settings.tsx - Settings and Categories → User Settings API: loads preferences
src/routes/settings.tsx - Transaction API → Finance Data Access: accesses records
src/routes/api/transactions.ts - Transaction Item API → Finance Data Access: accesses records
src/routes/api/transactions.$id.ts - Budget API → Finance Data Access: accesses budgets
src/routes/api/budgets.ts - Budget Item API → Finance Data Access: accesses budgets
src/routes/api/budgets.$id.ts - Category API → Finance Data Access: reads and saves
src/routes/api/categories.ts - User Settings API → Finance Data Access: accesses settings
src/routes/api/user-settings.ts - Exchange Rate API → Finance Data Access: uses rate cache
src/routes/api/exchange-rates.ts - Exchange Rate API → Exchange Rate Service: fetches rates
- Finance Data Access → Netlify Blobs: reads and writes
src/lib/db.ts - Signup Role Hook → Netlify Identity: assigns role