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

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

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.
https://github.com/salimer/budget-app

rspec-rails ruby-on-rails tailwindcss

Last synced: about 1 month ago
JSON representation

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.

Awesome Lists containing this project

README

          


logo

Welcome to my project 😃





Budget Monitor

![BudgetThumbnail (1)](https://github.com/Salimer/Budget-app/assets/52242629/a45ff6b6-db3c-4626-8d26-06af201530d9)

# 📗 Table of Contents

- [📗 Table of Contents](#-table-of-contents)
- [📖 Budget app ](#-budget-app-)
- [🛠 Built With ](#-built-with-)
- [Tech Stack ](#tech-stack-)
- [Key Features ](#key-features-)
- [🚀 Live Demo ](#-live-demo-)
- [💻 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 ](#️-show-your-support-)
- [🙏 Acknowledgments ](#-acknowledgments-)
- [📝 License ](#-license-)

# 📖 Budget app

**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.

erd_diagram

## 🛠 Built With

### Tech Stack

Server

Database

### Key Features

- **register and log in, so that the data is private to them.**
- **introduce new transactions associated with a category.**
- **see the money spent on each category.**

(back to top)

## 🚀 Live Demo

- [Live Demo Link](https://budget-app-t49c.onrender.com/)
- [Video presentation](https://www.loom.com/share/Budget-Monitor-App-Overview-d69c4dbe85bc4fd8a4e89216c0f08851?sid=60fdaf45-8452-4bde-836f-d1125bc6ca24)

(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:

- `Linux Operating system`
- `Text Editor (VSCode, RubyMine)`
- `Ruby`

### Setup

Clone this repository to your desired folder:

```sh
cd my-folder
git clone https://github.com/salimer/Budget-app.git
```

### Install

Install this project with:

```sh
cd my-project
bundle install
```

### Usage

To run the project, execute the following command:

```sh
rails server
```

### Run tests

To run tests, run the following command:

```sh
rspec spec
```

### Deployment

You can deploy this project using your own deployment service like `Render`.

(back to top)

## 👥 Authors

👤 **Salim Bamahfoodh**

- GitHub: [@salimer](https://github.com/salimer)
- LinkedIn: [LinkedIn](https://linkedin.com/in/sbamahfoodh)

(back to top)

## 🔭 Future Features

- [ ] **Upload icons as files**
- [ ] **Add location attribute to be saved for each purchase**

(back to top)

## 🤝 Contributing

Contributions, issues, and feature requests are welcome!

Feel free to check the [issues page](../../issues/).

(back to top)

## ⭐️ Show your support

If you like this project consider adding a ⭐️

(back to top)

## 🙏 Acknowledgments

- I would like to thank Microverse.
- Original design idea by: Gregoire Vella on Behance.

(back to top)

## 📝 License

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

(back to top)