Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/farida-hamid/budgetapp-rails

A mobile application that lets users log in and add transactions associated with a category to see the money spent on each category. Built with: Ruby on Rails, RSPEC, and PostgreSQL.
https://github.com/farida-hamid/budgetapp-rails

postgresql rspec ruby-on-rails

Last synced: 29 days ago
JSON representation

A mobile application that lets users log in and add transactions associated with a category to see the money spent on each category. Built with: Ruby on Rails, RSPEC, and PostgreSQL.

Awesome Lists containing this project

README

        

# 📖 Budet App
> This is a mobile web application where you can manage personal budget: you have a list of transactions associated with a category, so that you know how much you spent and on what.

This is a Ruby on Rails application that allows the user to:

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.

## 🛠 Built With

### Tech Stack
- **BackEnd:**
- Rails
- **Test:**
- RSPEC
- **Database:**
- PostgreSQL

### Key Features

- **[Authentication]** - register and log in.
- **[Add Category]** - Add a spending category.
- **[Display Categories]** - Display users categories.
- **[Display Total for Categories]** - Display the total amount of spnding for each category.
- **[Add a Transaction]** - Add transaction.
- **[Display Transaction]** - Display users transaction for each category.

(back to top)

## 🚀 Live Version

- [Check 📝](https://budget-app-r0dc.onrender.com)

(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: Installed Rails.

### Setup

Clone this repository to your desired folder:

```bash command
git clone [email protected]:Farida-Hamid/BudgetApp-rails.git
```

### Install

Install this project with:

```bash command
cd BudgetApp-rails
bundle install
```

### Usage

To run the project, execute the following command:

```bash command
rails server
```

### Run tests

To run tests, run the following command:
```bash command
rspec spec
```

(back to top)

## 👥 Author

👤 **Farida Hamid**

- LinkedIn: [LinkedIn](https://linkedin.com/in/farida-hamid)
- GitHub: [@Farida-Hamid](https://github.com/Farida-Hamid)

## 🔭 Future Features

- [ ] **[Add a sign out button]**

(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 give as a star! ⭐️

(back to top)

## 🙏 Acknowledgments

- Original design idea by [Gregoire Vella on Behance](https://www.behance.net/gallery/19759151/Snapscan-iOs-design-and-branding?tracking_source=)

(back to top)

## 📝 License

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

_NOTE: we recommend using the [MIT license](https://choosealicense.com/licenses/mit/) - you can set it up quickly by [using templates available on GitHub](https://docs.github.com/en/communities/setting-up-your-project-for-healthy-contributions/adding-a-license-to-a-repository). You can also use [any other license](https://choosealicense.com/licenses/) if you wish._

(back to top)