Skip to content

A comprehensive budgeting and financial management tool for individuals and businesses.

License

Notifications You must be signed in to change notification settings

310Team8/FinTrack

Repository files navigation

GitHub forks GitHub issues GitHub contributors Contributor Guidelines Code of Conduct MIT License Wiki


💰FinTrack📊

v1.5.3

Budgeting and Financial Management Tool


Report Bug · Request Feature · Request Documention


Table of Contents
  1. Project Insight
  2. About The Project
  3. Getting Started
  4. Versions
  5. Contributing
  6. License
  7. Contacts
  8. Acknowledgments

Project Insight

Alt

About The Project 🚀

FinTrack is designed to be a comprehensive financial management tool aimed at helping users gain better control over their finances. Whether for personal use or business purposes, FinTrack provides a robust platform for tracking income, expenses, and budgets. The tool is built with a focus on user-friendly data visualisation and forecasting features, ensuring users can easily interpret their financial data and make informed decisions. You can read more at Project Description about the next steps!

This project has been deployed to Render, a free hosting service that provides automated builds and deployments. The application is configured to automatically rebuild and redeploy whenever there is a merge to the main branch. This ensures that the latest changes are always reflected in the live environment without any manual intervention.

Make sure to contact us at Contacts for the database variables to store in your environment variables.

What does this project do? 🤔

FinTrack empowers users to efficiently manage their financial activities. It enables users to create and maintain personal or business financial profiles, categorize and monitor expenses, set and adhere to budgets, and forecast both income and asset values. Additionally, FinTrack offers goal-setting and tracking features, allowing users to achieve their financial objectives with ease.

Why is this project useful? 🌟

FinTrack is useful because it provides a centralized platform for managing and optimizing financial resources, making it easier for individuals and businesses to track their financial health. By offering features such as expense categorization, budget monitoring, and income forecasting, it helps users make informed financial decisions, avoid overspending, and achieve their financial goals. The data visualization tools further enhance the user experience by presenting complex financial data in an easy-to-understand format, making financial management more accessible and efficient.

Tech Stack Used 💻

  • Vaadin
  • Spring Boot
  • CSS
  • Java

Getting Started⚙️

Prerequisites📋

You will need the following software installed:

To set up Maven:

Installation⚡

  1. Fork the Repo: Click the "Fork" button at the top right of the repository page to fork the project to your GitHub account.

  2. Clone the Forked Repo using Terminal/Command Prompt: Replace your-username with your GitHub username.

    git clone https://github.com/your-username/FinTrack.git
  3. Navigate to the Project Directory:

    cd FinTrack
  4. Add .env file to Root Directory:

    Before running the application locally, make sure to set create a .env file in the root directory. The env file should contain the database URL, username, and password.

    Please contact us at Contacts and ask a second half author for the details required in the .env file.

  5. Install Maven Dependencies:

    mvn clean install
  6. Run the Project:

    mvn clean spring-boot:run

    Alternatively, you can open Application.java in your IDE (such as IntelliJ IDEA or VS Code) and press the "Run" button to start the application. Once the application is running, your web browser should open automatically. If not, open a new browser window and type http://localhost:8080 to access the application.

Versions📝

Contributing🤝

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please read more at Contributor Guidelines

License📜

Distributed under the MIT License. Read more at MIT License for more information.

Contacts📞

If you have any inquiries related to this project or face any issues contact us using the information below:

First half authours:

Second half authors:

Acknowledgments

About

A comprehensive budgeting and financial management tool for individuals and businesses.

Topics

Resources

License

Code of conduct

Stars

Watchers

Forks

Packages

No packages published

Languages