Skip to content

SorcererChiragsingh/CashFlowLedger

Repository files navigation

CashFlowLedger

Java full-stack, fully responsive AI-powered Income/Money Manager tracker application using Spring Boot, React.js, Axios, React Charts, React Hot Toast, Tailwind CSS, Lucide React, Spring Security with JWT Authentication, Spring Data JPA, Google Gemini API, MySQL, and Spring Cloud Config Server.

➥ Live Demo



Table of Contents

About

CashFlowLedger is a robust, AI-powered Income/Money Manager tracker application built on a modern Java full-stack architecture. Drawing inspiration from real-world financial management needs, this project uses Spring Boot for the backend, React for the frontend, and incorporates advanced technologies such as Eureka Server for service discovery, RabbitMQ for messaging, and Keycloak for secure authentication. The app integrates the Google Gemini API to provide personalized AI-driven financial insights and recommendations, helping users manage and optimize their income streams effectively.

Engineered for scalability and responsiveness, CashFlowLedger adopts a microservices architecture, real-time notifications, and cloud-based configuration with Spring Cloud Config Server. The platform is designed for seamless deployment on AWS and features a user-friendly interface accessible on both desktop and mobile devices. Whether you're a developer interested in modern Java microservices or an individual seeking intelligent income tracking solutions, CashFlowLedger offers a solid foundation for building and extending full-stack applications in the personal finance domain.

Features

  • Feature 1: Fully Featured Income Tracker app on Microservices Arch.
  • Feature 2: Ai Integration in Microservices.
  • Feature 3: Step By Step Easy To Follow Guide.
  • Feature 4: Real-time Notifications and Progress Tracking.
  • Feature 5: Manage income and Expense with validation.
  • Feature 6: Secure Authentication and Role-based Access.
  • Feature 7: Integration with Google Gemini API for AI-powered insights.
  • Feature 8: Cloud-based Configuration and Scalable Microservices.
  • Feature 9: Responsive Design for Mobile and Desktop.
  • Feature 10: Easy Deployment with Netlify & Render.
  • Feature 11: Register and Login.
  • Feature 12: Upload profile picture to cloudinary
  • Feature 13: Customer Emoji picker
  • Feature 14: Analyze data with React charts
  • Feature 15: Download and Email Transactions
  • Feature 16: Send daily email remainders

Screenshots

Home Page

User Sign Up Pages

User Sign In Page

User Profile Page

Tech Stack

  • Frontend: React.js, Axios, Lucide React, Tailwind CSS, Emoji Picker, React Charts
  • Backend: Java SpringBoot, Spring Data JPA
  • Database: MySql / PostgreSQL
  • Ai Model: Gemini API client library (google-generativeai)
  • Payement: X
  • Authentication: Keycloak, Spring Security with JWT Authentication
  • Deployment: Render & Netlify

Roadmap

The following roadmap outlines planned features and improvements for CashFlowLedger, inspired by community feedback and trends in modern money management applications:

  • AI-Powered Financial Insights: Integrate advanced AI models to provide personalized budgeting tips, spending analysis, and savings recommendations.
  • Bank Account Integration: Enable secure syncing with popular banks and financial institutions for automatic transaction import.
  • Expense Categorization: Enhance automatic categorization of income and expenses for clearer financial tracking.
  • Recurring Transactions: Support for managing recurring bills, subscriptions, and income streams.
  • Multi-Currency Support: Allow users to track finances in multiple currencies with real-time exchange rates.
  • Shared Accounts & Family Budgeting: Enable collaborative budgeting and expense tracking for families or groups.
  • Advanced Analytics Dashboard: Visualize spending patterns, trends, and financial goals with interactive charts.
  • Mobile App Release: Launch dedicated iOS and Android apps for on-the-go money management.
  • Export & Reporting: Provide options to export data to CSV/PDF and generate detailed financial reports.
  • Gamification: Introduce achievements, badges, and challenges to encourage better financial habits.
  • Continuous AI Model Updates: Regularly update AI models for improved accuracy and personalized insights.

Stay tuned for updates and new features! For a detailed walkthrough and future plans.

Clone

To get the project on your local system, use the following commands:

git clone https://github.com/SorcererChiragsingh/CashFlowLedger.git

How to Run CashFlowLedger on Your System 🛠🛠

1️⃣ Install Dependencies:

cd CashFlowLedger
npm install

2️⃣ Setup Environment Variables:

Create a .env file in the CashFlowLedger directory and add the following:

PORT=8080

3️⃣ Start the Backend Server:

cd Project_CashFlowLedger

java run
http://localhost:8080/api/v1.0/health

4️⃣ Start the Frontend Server:

cd Project_CashFlowLedger
cd CashFlowLedgerWebApp
npm run

5️⃣ Open the Application:

Open http://localhost:8080 with your browser to see the result. 🚀

Report Issues

  • You can report issues on this project using Github issue.
  • You can read more about this from Github Docs

License

  • This project is licensed under the MIT License - see the LICENSE file for details.
  • The project CashFlowLedger is packaged and distributed using the MIT License which allows for commercial use, distribution, modification and private use provided that all copies of the software contain the same license and copyright.

Acknowledgements

Releases

No releases published

Packages

No packages published

Languages