Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/munyabelden/budget-app

The App is a web application that helps users manage their expenses by categorizing transactions. It allows users to create categories and add entities (transactions) within each category. Users can track their spending, view the total amount spent in each category, and easily add new transactions.
https://github.com/munyabelden/budget-app

capybara-rspec postgresql rspec-rails ruby-on-rails

Last synced: 17 days ago
JSON representation

The App is a web application that helps users manage their expenses by categorizing transactions. It allows users to create categories and add entities (transactions) within each category. Users can track their spending, view the total amount spent in each category, and easily add new transactions.

Awesome Lists containing this project

README

        

logo

# 📗 Table of Contents

- [📖 About the Project](#about-project)
- [🛠 Built With](#built-with)
- [Tech Stack](#tech-stack)
- [Key Features](#key-features)
- [💻 Getting Started](#getting-started)
- [Prerequisites](#prerequisites)
- [Setup](#setup)
- [Install](#install)
- [Usage](#usage)
- [Run tests](#run-tests)
- [Deployment](#deployment)
- [👥 Authors](#authors)
- [🔭 Future Features](#future-features)
- [🤝 Contributing](#contributing)
- [⭐️ Show your support](#support)
- [🙏 Acknowledgements](#acknowledgements)
- [❓ FAQ (OPTIONAL)](#faq)
- [📝 License](#license)

# 📖 [BudgetPro]

**[BudgetPro]** The Budget App is a web application that helps users manage their expenses by categorizing transactions. It allows users to create categories and add entities (transactions) within each category. Users can track their spending, view the total amount spent in each category, and easily add new transactions.

## 🛠 Built With

### Tech Stack

- [ ] Ruby on Rails
- [ ] PostgreSql
- [ ] Gem

Client

Database

### Key Features

- **[Categories: Users can view aand create categories.]**
- **[Entities (Transactions): Entities are ordered by the creation date, with the most recent ones displayed first..]**
- **[Homepage: The app provides a homepage with a default index action.]**

(back to top)

## 🚀 Live Demo

- [Live Demo Link](https://budgetpro.onrender.com)

(back to top)

## 🎥 Video presesntation

- [Video presentation](https://drive.google.com/file/d/1THwN1YM60P8RUpRjJzaj5X759qQKAVmk/view?usp=sharing)

(back to top)

## 💻 Getting Started

To get a local copy up and running, follow these steps.

### Prerequisites

In order to run this project you need:

- [ ] Ruby: [Installation Guide](https://www.ruby-lang.org/en/documentation/installation/)
- [ ] Ruby on Rails: [Installation Guide](https://guides.rubyonrails.org/getting_started.html#installing-rails)
- [ ] PostgreSQL: [Installation Guide](https://www.postgresql.org/docs/)

### Setup

Clone this repository to your desired folder:

```sh
cd Rails_Capstone
git clone https://github.com/Munyabelden/Budget-App.git
```

### Install

Install this project with:

```sh
cd Rails_Capstone
bundle install
```
```sh
gem install rspec
```
```sh
gem install --no-document rubocop -v '>= 1.0, < 2.0'
```
```sh
npm install --save-dev [email protected] [email protected] [email protected] [email protected]
```

### Usage

To run the project, execute the following command:

```sh
rails db:create
```
```sh
rails db:migrate
```
```sh
rails server
```

### Run tests

To run tests, run the following command:

```sh
rubocop --color
```
```sh
npx stylelint "**/*.{css,scss}"
```
```sh
rspec
```
### Deployment

You can deploy this project using:

- [ ] Use render or any other hosting of your choosing

(back to top)

## 👥 Authors

👤 **Belden Mugauri**

- GitHub: [@githubhandle](https://github.com/Munyabelden/)
- Twitter: [@twitterhandle](https://twitter.com/munyaradzi045)
- LinkedIn: [LinkedIn](https://www.linkedin.com/in/munyaradzi-mugauri-828a7b24a/)

(back to top)

## 🔭 Future Features

- [ ] **[Allow users to manage their profile information, including updating their name, email, and password.]**
- [ ] **[Provide options for users to filter and sort entities based on criteria such as date, amount, or category.]**
- [ ] **[Generate visual representations, such as charts and graphs, to help users analyze their spending patterns and track expenses over time.]**

(back to top)

## 🤝 Contributing

Feel free to check the [issues page](https://github.com/Munyabelden/Budget-App/issues).

(back to top)

## ⭐️ Show your support

If you like this project feel free to give it a star
## 🙏 Acknowledgments

I would like to thank Gregoire Vella on Behance for the original design idea.

(back to top)

## 📝 License

This project is [MIT](https://github.com/Munyabelden/Budget-App/blob/feature/app/LICENSE) licensed.

(back to top)