Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/gisachris/budget_builder

This is a mobile first web application solution for tracking your expenses and their amounts all neatly packed together in one package. Intuitive design, functionality and User experience are the core fundamentals with this rails application. Enjoy!
https://github.com/gisachris/budget_builder

Last synced: 1 day ago
JSON representation

This is a mobile first web application solution for tracking your expenses and their amounts all neatly packed together in one package. Intuitive design, functionality and User experience are the core fundamentals with this rails application. Enjoy!

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](#Presentation)

- [💻 Getting Started](#getting-started)

  - [Setup](#setup)

  - [Prerequisites](#prerequisites)

  - [Install](#install)

  - [Usage](#usage)

  - [Run tests](#run-tests)

- [👥 Authors](#authors)

- [🔭 Future Features](#future-features)

- [🤝 Contributing](#contributing)

- [⭐️ Show your support](#support)

- [🙏 Acknowledgements](#acknowledgements)

- [📝 License](#license)



# 📖 budget_builder 



**budget_builder** This is a mobile first web application solution for tracking your expenses and their amounts all neatly packed together in one package. Intuitive design, functionality and User experience are the core fundamentals with this rails application. 



## 🛠 Built With 



### Tech Stack 



  Ruby

  



  Rails

  



PostgreSQL

  



### Key Features 



- **Display Categories**

- **Display Transactions**

- **Create or Remove Categories**

- **Create or Remove Transactions**

- **Validation and Unit Tests**

- **Capybara**

- **Devise authentication and Authorization**

- **Forms, Views, Controllers**



(back to top)



## 🚀 Live Demo 



[Checkout the live site here!](https://budgetbuilder.onrender.com/)



(back to top)



## 🚀 Project Presentation 



[Loom Video presentation](https://www.loom.com/share/7a2825bc026c41bc97606cb0aca1cf23?sid=70c3369b-08e8-4c34-adaf-1023cf391dfd)



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



```sh

 gem install rails

```



### Setup



Clone this repository to your desired folder:



```sh  

   git clone https://github.com/gisachris/budget_builder.git

   cd budget_builder

```



### Install



Install this project with:



```sh

  cd budget_builder

  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

```



(back to top)



## 👥 Authors 



👤 **Gisa Chris**



- GitHub: [@gisachris](https://github.com/gisachris)

- LinkedIn: [LinkedIn](https://linkedin.com/in/gisa-chris/)



(back to top)



## 🔭 Future Features 



- [ ] **Real time tracking and habit recognition**

- [ ] **Expense Alerts and notifications**



(back to top)



## 🤝 Contributing 



Contributions, issues, and feature requests are welcome!



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



(back to top)



## ⭐️ Show your support 



If you like this project consider leaving a star in the repo. 



(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](./MIT.md) licensed.



(back to top)