Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/besufekad-haz/budget-app

Budget-app is a rails web application to track your expenses and manage your budget.
https://github.com/besufekad-haz/budget-app

Last synced: 16 days ago
JSON representation

Budget-app is a rails web application to track your expenses and manage your budget.

Host: GitHub
URL: https://github.com/besufekad-haz/budget-app
Owner: Besufekad-HAZ
License: mit
Created: 2023-07-10T10:34:43.000Z (over 1 year ago)
Default Branch: dev
Last Pushed: 2024-09-26T11:44:58.000Z (4 months ago)
Last Synced: 2024-12-15T01:28:56.930Z (30 days ago)
Language: Ruby
Size: 8.02 MB
Stars: 0
Watchers: 1
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

        

 Cash-Buddy


![Ruby on rails](image.png)

# 📗 Table of Contents

- [📗 Table of Contents](#-table-of-contents)

- [ Cash Buddy ](#-cash-buddy)

  - [🛠 Built With ](#-built-with-)

    - [Tech Stack ](#tech-stack-)

    - [Key Features ](#key-features-)

    - [Screenshot](#screenshot)

  - [Loom Presentation Video](#loom-video)

  - [Live Demo](#live-demo)

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

    - [Prerequisites](#prerequisites)

    - [Setup](#setup)

    - [Install](#install)

    - [Database](#database)

    - [Deployment](#deployment)

  - [👥 Authors ](#-authors-)

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

  - [🤝 Contributing ](#-contributing-)

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

  - [🙏 Acknowledgments ](#-acknowledgments-)

  - [📝 License ](#-license-)

# Cash-Buddy 

> The Cash-Buddy project is a mobile web application that allows users to manage their budgets by keeping track of their transactions and associated categories. The app requires users to register and log in to ensure that their data is private. Users can add new transactions associated with categories and view the money spent on each category. The app has several pages, including the Splash Screen, Signup and Login Pages, Home Page (Categories Page), Transactions Page, Add a New Category Page, and Add a New Transaction Page.

## 🛠 Built With Ruby on rails and Posgresql

### Tech Stack 

  Ruby On Rails

  


    Postgresql

  


### Key Features 

- Users can register and log in to the app to access their private data.

- Introduce new transactions associated with a category.

- See the money spent on each category.

- Security: The app validates user input to prevent security vulnerabilities and uses Devise for authentication.

(back to top)


## 🚀 Screenshot 



  

  


  



## 💻 Loom Presentation Video 

- [Loom Link](https://www.loom.com/share/94fecffcd31e42e0b81826360b23b6a2)

## 🚀 Live Demo 

- [Live Demo Link](https://cash-buddy.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:

- Mac or PC

- Understanding OOP principles

- Have the following installed on your machine

    - [Ruby](https://www.ruby-lang.org/en/)

    - [Rails](https://rubyonrails.org/)

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

### Setup

Clone this repository to your desired folder:

```sh

  cd your-folder

  git clone [email protected]:Besufekad-HAZ/Budget-app.git (SSH)

```

### Install

Install this project with:

Install the required gems with:

```sh

bundle install

```

### Database

Create the databases and run migrations with:

```sh

rails db:create

rails db:migrate

```

### Deployment

To deploy the app you can use

- [Render](https://www.render.com/)

- [Heroku](https://www.heroku.com/)

(back to top)


## 👥 Authors 

##  👤 Besufekad Alemu 

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

- Twitter: [@BesufekadAlemu7](https://twitter.com/BesufekadAlemu7)

- LinkedIn: [@besura](www.linkedin.com/in/besura)

(back to top)


## 🔭 Future Features 

- [ ] **Create API endpoints**

- [ ] **Integration with banking apps**

- [ ] **Bill reminders**

(back to top)


## 🤝 Contributing 

Contributions, issues, and feature requests are welcome!

Feel free to check the [issues page](https://github.com/Besufekad-HAZ/Budget-app/issues).

(back to top)


## ⭐️ Show your support 

If you like this project, please leave a ⭐️

(back to top)


## 🙏 Acknowledgments 

- I'd like to thank the [Microverse](https://www.microverse.org/) team for providing us with the opportunity to work on this amazing budget-app rails app.

- The design for this project was inspired by the work of [Gregoire Vella on Behance](https://www.behance.net/gregoirevella), whose [Original Design](https://www.behance.net/gallery/19759151/Snapscan-iOs-design-and-branding?tracking_source=) can be found on Behance. I would like to thank Gregoire for sharing his work under a Creative Commons license, which allowed us to use it in our project.

(back to top)


## 📝 License 

This project is [MIT](https://github.com/Besufekad-HAZ/Budget-app/blob/dev/LICENSE) licensed.

(back to top)