https://github.com/patryk-penczek/financeflow

An intuitive expense tracking application built with Avalonia UI and C#. Designed to help users manage and analyze their personal finances effectively.
https://github.com/patryk-penczek/financeflow

avaloniaui csharp finance management

Last synced: 3 months ago
JSON representation

An intuitive expense tracking application built with Avalonia UI and C#. Designed to help users manage and analyze their personal finances effectively.

• Host: GitHub
• URL: https://github.com/patryk-penczek/financeflow
• Owner: patryk-penczek
• License: gpl-3.0
• Created: 2024-05-20T09:02:56.000Z (about 1 year ago)
• Default Branch: master
• Last Pushed: 2024-07-04T12:15:30.000Z (about 1 year ago)
• Last Synced: 2025-02-14T21:47:43.318Z (5 months ago)
• Topics: avaloniaui, csharp, finance, management
• Language: C#
• Homepage:
• Size: 337 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Awesome Lists containing this project

README

        
# FinanceFlow

FinanceFlow is a user-friendly application designed to help you manage your expenses efficiently. With a clean and intuitive interface, you can easily add, update, and delete expenses, as well as categorize them for better tracking.

## Features

- **Expense Management**: Add, update, and remove expenses.

- **Category Management**: Organize your expenses into categories.

- **Total Expense Calculation**: Automatically calculate and display the total expenses.

- **Intuitive UI**: Easy-to-use interface with visual indicators for monetary amounts.

## Screenshots

### Expense View

![Expense View](https://github.com/patryk-penczek/FinanceFlow/assets/111662540/96f2cfe9-537c-4732-98d3-8bea09dea2df)

### Category View

![Category View](https://github.com/patryk-penczek/FinanceFlow/assets/111662540/f16c83b3-7ee5-44e4-9c9f-21d902ad8f49)

### Add Expense View

![Add Expense View](https://github.com/patryk-penczek/FinanceFlow/assets/111662540/bf7b85a8-bf75-491d-8e14-98888ac66232)

### Update Expense View

![Update Expense View](https://github.com/patryk-penczek/FinanceFlow/assets/111662540/e269afdf-4401-4997-b393-a4c5ae7ee99d)

## Getting Started

### Prerequisites

- [Visual Studio](https://visualstudio.microsoft.com/) installed on your machine.

### Installation

1. Clone the repository:

    ```sh

    git clone https://github.com/patryk-penczek/FinanceFlow.git

    ```

2. Open the project in Visual Studio by double-clicking `FinanceFlow.sln` file.

3. Build and run the project using Visual Studio.

## Usage

### Managing Expenses

1. **Add Expense**: Click the "Add Expense" button and fill in the details such as title, date, category, and amount.

2. **Update Expense**: Select an expense from the list and click the "Update Expense" button. Modify the details as needed.

3. **Remove Expense**: Select an expense from the list and click the "Remove Expense" button to delete it.

### Managing Categories

1. Navigate to the "Categories" view using the sidebar menu.

2. Add, update, or delete categories as needed.

## Development

### Project Structure

- **ViewModels**: Contains the view models for the MVVM pattern.

- **Views**: Contains the XAML views.

- **Services**: Contains the business logic and data handling services.

- **Models**: Contains the data models.

## License

This project is licensed under the [GNU GENERAL PUBLIC LICENSE](LICENSE.txt).

## Acknowledgments

- Inspired by the need for a simple and efficient expense management tool.

- Built using [Avalonia UI](https://avaloniaui.net/) for cross-platform desktop applications.