How zi-tasin/personalized-finance-tracker works
Personalized Finance Tracker is a React/Express personal-finance app: users register or sign in, then manage user-scoped income, expenses, and monthly budgets and review dashboard summaries. The client pages call the REST API through a shared Axios client; Express routes dispatch to controllers, which use Mongoose models. Major documented capabilities also include Excel exports and optional profile-image uploads. Several UI branches are documented or indexed but not excerpted, so their internal wiring is shown only where evidence supports it.
Main entry points: server.js Express app · App.jsx Route shell · Expense.jsx Expense page · authMiddleware.js JWT guard
Components 33
React client
- Route shell
client/src/App.jsx - Sign up
client/src/pages/Auth/SignUp.jsx - Income page
client/src/pages/Dashboard/income.jsx - Expense page
client/src/pages/Dashboard/Expense.jsx - Budget page
client/src/pages/Dashboard/Budget.jsx - Dashboard
client/src/pages/Dashboard/Home.jsx - Dashboard layout
client/src/components/layouts/DashboardLayout.jsx - Auth layout
client/src/components/layouts/AuthLayout.jsx - Form inputs
client/src/components/Inputs/input.jsx - Modal UI
client/src/components/Modals.jsx - User state
client/src/context/userContext.jsx - Session check
client/src/hooks/useUserAuth.jsx - API paths
client/src/utils/apiPaths.js - HTTP client
client/src/utils/axiosInstance.js
REST API
- Express app
server/server.js - Auth routes
server/routes/authRoutes.js - Income routes
server/routes/incomeRoutes.js - Expense routes
server/routes/expenseRoutes.js - Dashboard routes
server/routes/dashboardRoutes.js - Budget routes
server/routes/budgetRoutes.js
Finance records
- Income controller
server/controllers/incomeController.js - Income records
server/models/Income.js - Expense controller
server/controllers/expenseController.js - Expense records
server/models/Expense.js - Dashboard totals
server/controllers/dashboardController.js - Budget controller
server/controllers/budgetController.js - Budget records
server/models/Budget.js
Identity and profile
- Account controller
server/controllers/authController.js - JWT guard
server/middleware/authMiddleware.js - User records
server/models/User.js - Image upload
server/middleware/uploadMiddleware.js
Other components
- Finance user
- MongoDB
Connections 48
- Finance user → Route shell: uses
- Route shell → Sign up: routes to
client/src/App.jsx - Route shell → Dashboard: routes to
client/src/App.jsx - Route shell → Income page: routes to
client/src/App.jsx - Route shell → Expense page: routes to
client/src/App.jsx - Route shell → Budget page: routes to
client/src/App.jsx - Sign up → Auth layout: renders
client/src/pages/Auth/SignUp.jsx - Sign up → Form inputs: uses
client/src/pages/Auth/SignUp.jsx - Expense page → Dashboard layout: renders
client/src/pages/Dashboard/Expense.jsx - Expense page → Session check: checks session
client/src/pages/Dashboard/Expense.jsx - Expense page → Modal UI: renders
client/src/pages/Dashboard/Expense.jsx - Income page → Dashboard layout: renders
- Budget page → Dashboard layout: renders
client/src/pages/Dashboard/Budget.jsx - Dashboard → Dashboard layout: renders
client/src/pages/Dashboard/Home.jsx - Session check → User state: updates state
client/src/hooks/useUserAuth.jsx - Session check → HTTP client: fetches user
client/src/hooks/useUserAuth.jsx - Sign up → HTTP client: submits account
client/src/pages/Auth/SignUp.jsx - Expense page → HTTP client: manages expenses
client/src/pages/Dashboard/Expense.jsx - Expense page → Budget page: checks threshold
client/src/pages/Dashboard/Expense.jsx - HTTP client → API paths: uses base URL
client/src/utils/axiosInstance.js - HTTP client → Express app: sends API requests
- Express app → Auth routes: mounts
server/server.js - Express app → Income routes: mounts
server/server.js - Express app → Expense routes: mounts
server/server.js - Express app → Dashboard routes: mounts
server/server.js - Express app → Budget routes: mounts
server/server.js - Auth routes → Account controller: dispatches
server/routes/authRoutes.js - Income routes → Income controller: dispatches
server/routes/incomeRoutes.js - Expense routes → Expense controller: dispatches
server/routes/expenseRoutes.js - Dashboard routes → Dashboard totals: dispatches
server/routes/dashboardRoutes.js - Budget routes → Budget controller: dispatches
server/routes/budgetRoutes.js - Auth routes → JWT guard: protects routes
server/routes/authRoutes.js - Income routes → JWT guard: protects routes
server/routes/incomeRoutes.js - Expense routes → JWT guard: protects routes
server/routes/expenseRoutes.js - Dashboard routes → JWT guard: protects routes
server/routes/dashboardRoutes.js - Budget routes → JWT guard: protects routes
server/routes/budgetRoutes.js - Account controller → User records: reads/writes
server/controllers/authController.js - JWT guard → User records: loads user
server/middleware/authMiddleware.js - Income controller → Income records: reads/writes
server/controllers/incomeController.js - Expense controller → Expense records: reads/writes
server/controllers/expenseController.js - Dashboard totals → Income records: aggregates
server/controllers/dashboardController.js - Dashboard totals → Expense records: aggregates
server/controllers/dashboardController.js - Budget controller → Budget records: reads/writes
server/controllers/budgetController.js - Budget controller → Expense records: totals spending
server/controllers/budgetController.js - Express app → MongoDB: connects
- Auth routes → Image upload: accepts images
server/routes/authRoutes.js - Finance user → Income page: records income
- Finance user → Budget page: sets budgets