Skip to content

NotGiggs/tp

 
 

Repository files navigation

FinBro - Personal Finance Manager

FinBro Logo

Overview

FinBro is a streamlined command-line application designed to help you efficiently manage your personal finances. With its intuitive CLI interface, FinBro enables you to track your income and expenses, categorize transactions, generate financial summaries, and export your financial data—all from the comfort of your terminal.

Key Features

  • Transaction Management: Record income and expenses with detailed descriptions and custom tags
  • Categorization System: Organize expenses into predefined categories for better financial insights
  • Smart Search: Find transactions using keywords or date ranges
  • Real-time Balance: View your current financial position at any time
  • Financial Analysis: Generate comprehensive summaries to understand your spending patterns
  • Data Export: Export your financial records in CSV or TXT formats for external analysis

Quick Start Guide

  1. Ensure you have Java 17 installed on your computer
  2. Download the latest version of FinBro from the releases page
  3. Run the application using the command:
    java -jar FinBro.jar
    

Command Examples

Adding Income

income 3000 d/Monthly salary t/work

Recording an Expense

expense 25.50 d/Lunch c/Food t/work

Checking Your Balance

balance

Viewing a Monthly Summary

summary m/2 y/2025

Documentation

Project Structure

finbro/
├── src/
│   ├── main/java/seedu/finbro/
│   │   ├── FinBro.java           # Main application class
│   │   ├── logic/                # Command processing logic
│   │   ├── model/                # Data models
│   │   ├── storage/              # Data persistence
│   │   └── ui/                   # User interface
│   └── test/java/seedu/finbro/   # Test classes
├── data/                         # Data storage directory
├── docs/                         # Documentation
├── build.gradle                  # Build configuration
└── README.md                     # This file

System Requirements

  • Java 17 or higher
  • Support for text-based interface (any terminal or command prompt)

Contributing

Contributions to FinBro are welcome! Please refer to the Developer Guide for details on the project architecture and contribution guidelines.

License

FinBro is released under the MIT License

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Java 99.5%
  • Other 0.5%