Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

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

The budget app is a mobile web app where you can manage your budget: users can add categories, show categories, add transactions, and show transactions for each category. Built with Ruby on Rails and PostgreSQL.
https://github.com/billymohajeri/budget-app

postgresql ruby-on-rails

Last synced: 4 months ago
JSON representation

The budget app is a mobile web app where you can manage your budget: users can add categories, show categories, add transactions, and show transactions for each category. Built with Ruby on Rails and PostgreSQL.

Awesome Lists containing this project

README

        

# 📗 Table of Contents

- [📖 About the Project](#about-project)
- [🛠 Built With](#built-with)
- [Tech Stack](#tech-stack)
- [Key Features](#key-features)
- [🚀 Live Demo](#live-demo)
- [🎥 Presentation](#video-link)
- [💻 Getting Started](#getting-started)
- [Setup](#setup)
- [Prerequisites](#prerequisites)
- [Install](#install)
- [Usage](#usage)
- [👥 Author](#author)
- [🔭 Future Features](#future-features)
- [🤝 Contributing](#contributing)
- [⭐️ Show your support](#support)
- [🙏 Acknowledgements](#acknowledgements)
- [📝 License](#license)

# 📖 Billy Budget app

**Billy Budget** is about building 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

### Key Features

- **Add category**
- **Show categories**
- **Add transaction**
- **Show transactions for each category**

(back to top)

## 🚀 Live Demo

[See the project live on Render.com](https://budgetapp-azzb.onrender.com/)

(back to top)

## 📺 Presentation

[See the project presentation here](https://drive.google.com/file/d/1-NxysqGZq_3k30RmvdPABsNiRtL6Jw3p/view?usp=sharing)

(back to top)

## 💻 Getting Started

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

### Prerequisites

To run this project you need:

- [Ruby on Rails](https://rubyonrails.org/) installed and running. To get more information, read the [installation guide](https://guides.rubyonrails.org/).

- [PostgreSQL](https://www.postgresql.org/) installed and running.

### Setup

Clone this repository to your desired folder:

```
git clone [email protected]:billymohajeri/Budget-App.git
```

### Install

Install this project with:

```cd Budget-App```

```bundle install``` to install all gems used.

```rails db:create``` to create the database.

```rails db:migrate``` to run the database migrations you created.

### Usage

To run the project, execute the following command:
```
rails s
```

(back to top)

## 👥 Author

👤 **Billy Mohajeri**

- GitHub: [@BillyMohajeri](https://github.com/billymohajeri)
- Twitter: [@BillyMohajeri](https://twitter.com/BillyMohajeri)
- LinkedIn: [@BillyMohajeri](https://www.linkedin.com/in/billymohajeri)

(back to top)

## 🔭 Future Features

- [ ] **Delete categories**
- [ ] **Delete transactions**
- [ ] **Desktop design**
- [ ] **Improve styling**

(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, please consider giving it a star.

(back to top)

## 🙏 Acknowledgments

- I would like to thank all code reviewers for making this project better.

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

(back to top)

## 📝 License

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

(back to top)