How fazeelian/track-my-cash works
Project type and purpose
• This is a two-tier full-stack web application (“Track My Cash”) for personal finance management.
• The client is a React (TypeScript + Vite) single-page app with two main UI domains: the public/company-facing landing pages and the authenticated/admin dashboard.
• The server is an Express.js (TypeScript) REST API that handles authentication (JWT), CRUD operations for transactions, goals, notifications, and integrates with a database and an email service (via Nodemailer).
File structure
• Top-level directories:
• client/ – React SPA with src/components, src/views, src/services (axios wrappers for REST endpoints), src/lib (hooks, types, utils), and styling under src/assets.
• server/ – Express app with src/routes (defines REST endpoints), src/controllers (business-logic handlers), src/models (ORM or schema definitions), src/middleware (auth, validation), and src/config (DB, CORS, email).
• Architectural pattern on the server is MVC/Router-Controller-Model. The client follows a component-driven design with context/services for state and network calls.
README for additional insights
• The README confirms usage of JWT authentication, financial entities (transactions, goals, notifications), a dashboard with charts, and email notifications (e.g., progress/inactivity alerts).
Thoroughness
• Middleware chain before controllers.
• Two distinct client domains (public vs. admin) consuming the same API.