/Budget-app

It is about a mobile web application where you can manage your budget: you have a list of transactions associated with a category, so that you can see how much money you spent and on what.

Primary LanguageRubyMIT LicenseMIT

Libra: Personal Finance Management App

📗 Table of Contents

📖 About the Project

Welcome to Libra, your personal finance management application built with Ruby on Rails. This app helps you manage your expenses efficiently by organizing transactions into categories and providing insightful financial data. Keep track of your spending, create new categories, and add transactions with ease.

This project is inspired by the original design idea by Gregoire Vella on Behance, and it is used under the Creative Commons license.

🛠 Built With

Tech Stack

Client

  • HTML5
  • CSS3

Server

  • Ruby on Rails

Database

  • PostgreSQL

Key Features

  • Intuitive Expense Tracking: Easily track and categorize your expenses, providing a clear overview of your financial health.
  • Custom Categories: Create custom spending categories tailored to your unique financial habits.
  • Insightful Data: Get a clear picture of your spending habits with insightful data and visualizations.

💻 Live Demo

📸 Screenshots

Alt text Alt text Alt text Alt text

💻 Getting Started

🛠 Setup

  1. Clone the Project Repository:

    git clone https://github.com/Zven94/Budget-app.git

  2. Navigate to the Project Folder:

    cd Budget-app

Prerequisites

Before you can run Libra, ensure you have the following prerequisites and configurations in place:

  • Ruby: Verify that Ruby is installed on your machine by running ruby -v in your terminal. If not, download and install Ruby from the official Ruby website.

  • Ruby on Rails: Install the Ruby on Rails framework using the following command if you haven't already:

    gem install rails

  • Code Editor: Use a code editor like Visual Studio Code (VSCode). If you don't have it, download it from the official website.

  • Git: Make sure Git is installed and configured for version control. Download Git from the official Git website.

  • PostgreSQL: Install and properly configure PostgreSQL on your development server. Libra assumes the use of PostgreSQL as the default database. Download PostgreSQL from the official PostgreSQL website.

  • Ruby on Rails Configuration: Configure your Ruby on Rails project to use PostgreSQL as the default database.

With these prerequisites and configurations in place, you're ready to set up and run Libra.

📖 Usage

Follow these steps to use Libra:

  1. Open your Terminal:

    Navigate to the directory where the project files are located:

    cd /path/to/your/project/files

  2. Start the Rails Server:

    rails server

  3. Access Libra:

    Open your web browser and go to http://localhost:3000 to access Libra and manage your personal finances efficiently.

👥 Authors

👤 Nicolas Bolañez

🔭 Future Features

We are committed to continuous improvement and plan to implement the following features in future updates:

  • Budgeting Tool: Introduce a comprehensive budgeting tool that allows users to set monthly budgets for different expense categories. The app will provide notifications and insights to help users stay within their budget limits.

  • Expense Insights: Enhance the analytics section with more detailed insights. Users will be able to visualize their spending trends over time, compare expenses across different categories, and receive personalized suggestions for optimizing their budget.

  • Multi-Platform Support: Extend Libra's accessibility by developing mobile applications for both Android and iOS platforms. This will enable users to manage their finances seamlessly on their smartphones and tablets, providing a consistent experience across devices.

🤝 Contributing

Contributions, issues, and feature requests are welcome!

⭐️ Show your support

Give a ⭐️ if you like this project!

🙏 Acknowledgment

We would like to express our deepest gratitude to Gregoire Vella on Behance for her Original design idea.

📜 License

This project is licensed under the MIT License as required by the original design idea by Gregoire Vella on Behance under the Creative Commons license.