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

https://github.com/ashmalzahra/budget

A mobile web application built with Ruby on Rails where users can manage their budget; users can list expenses associated with a category and see how much money they've spent and on what transaction.
https://github.com/ashmalzahra/budget

best-practices deployment ruby-on-rails tailwindcss

Last synced: about 1 month ago
JSON representation

A mobile web application built with Ruby on Rails where users can manage their budget; users can list expenses associated with a category and see how much money they've spent and on what transaction.

Awesome Lists containing this project

README

        


Budget App


# 📗 Table of Contents

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

# 📖 Budget app - MoneyMinder

**Budget app** The Budget app is 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.

## 🛠 Built With

### Tech Stack

Client

Server

Database

### Key Features

- **ROR Framework**

(back to top)

## 🚀 Live Demo

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

(back to top)

## 💻 Getting Started

To get a local copy of this project and run it in your computer, follow these steps.

### Prerequisites

In order to run this project you need:
- A working computer.
- Connection to internet.

### Setup

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

Clone this repository in the desired folder:
```
cd my-folder
git clone https://github.com/ashmalzahra/Budget.git
```

### Install

To install this project:
```
cd Budget
code .
bundle install
```

### Usage

To run the project, execute the following command:

```
bin/dev
```

### Run Tests
For rails +7, include the following in your gemfile in the development, test group:
```
group :development, :test do
gem 'rspec-rails'
end
```
and

```
gem 'rails-controller-testing'
```

then run:
```
bundle install
```

To setup rspec, run the following:

```
rails generate rspec:install
```

To run the project tests, execute the following command:

```
rspec
```

(back to top)

## 👥 Authors

👤 **Ashmal Zahra**

- GitHub: [@ashmalzahra](https://github.com/ashmalzahra)
- Twitter: [@AshmalZahraa](https://twitter.com/AshmalZahraa)
- LinkedIn: [ashmal-zahra](https://www.linkedin.com/in/ashmal-zahra)

(back to top)

## 🔭 Future Features

- [ ] **Delete Categories and Transactions option.**

(back to top)

## 🤝 Contributing

Contributions, issues, and feature requests are welcome!

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

(back to top)

## ⭐️ Show your support

Give a ⭐️ if you like this project!

(back to top)

## 🙏 Acknowledgments

Original design idea by [Gregoire Vella on Behance](https://www.behance.net/gregoirevella).

(back to top)

## ❓ FAQ

- **Can I use the project for any purpose?**

- Yes, you can.

(back to top)

## 📝 License

This project is [MIT](./LICENSE) licensed.

(back to top)