https://github.com/praisespjmt/fruugal

Fruugal 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. Built with Ruby-on-Rails.
https://github.com/praisespjmt/fruugal

css3 ruby ruby-on-rails

Last synced: about 1 year ago
JSON representation

Fruugal 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. Built with Ruby-on-Rails.

• Host: GitHub
• URL: https://github.com/praisespjmt/fruugal
• Owner: PraisesPJMT
• License: mit
• Created: 2023-01-02T19:40:30.000Z (over 3 years ago)
• Default Branch: development
• Last Pushed: 2023-01-06T16:33:21.000Z (over 3 years ago)
• Last Synced: 2025-03-30T07:51:16.127Z (about 1 year ago)
• Topics: css3, ruby, ruby-on-rails
• Language: Ruby
• Homepage:
• Size: 6.49 MB
• Stars: 8
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# 📗 Table of Contents

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

- [📖 Fruugal ](#about-project)

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

        - [Tech Stack ](#tech-stack)

        - [Key Features ](#key-features)

    - [🚀 App Preview](#preview)

    - [🚀 Live Demo](#live-demo)

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

    - [Prerequisites](#prerequisites)

    - [Setup](#setup)

    - [Install](#install)

    - [Usage](#usage)

- [👥 Authors ](#authors)

- [🤝 Contributing ](#contributing)

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

- [🙏 Acknowledgements](#acknowledgements)

- [📝 License ](#license)

# 📖 Fruugal 

> `Frugugal` 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.

## 🛠 Built With 

### Tech Stack 

> Here are the tech stacks applied in this project.

  Language

  


    
Ruby

    
JavaScript

  


  Framework

  


    
Ruby on Rails

  


Database

  


    
PostgreSQL

  


  Linters

  


    
Rubocop

    
Stylelint

  


  Markup Languages

  


    
HTML5

    
CSS3

  


  Test Library

  


    
RSpec

  


(back to top)


### Key Features 

> This app has the following key features:

- Create new user.

- Create a budget category

- Create a transaction from a budget category

- See all transactions made on a budget category

- See all budget categories and the amount spent on them

(back to top)


## 🚀 App Preview 

> Here are screenshots of the application

### Budget Categories and Transaction Pages Preview

![Fruugal Preview 1](./fruugal_preview1.png)

### User Pages Preview

![Fruugal Preview 2](./fruugal_preview2.png)

(back to top)


## 🚀 Live Demo 

> This app has been deployed using [Railway.app](https://railway.app/). Use th link below to view live app.

- [Fruugal](fruugal-production.up.railway.app)

(back to top)


## 💻 Getting Started 

### Prerequisites

> The following applications are required to be installed for the project to run!

- Install Ruby on your computer (machine)

- Install a modern browser e.g [Google Chrome](https://www.google.com/chrome/), [Edge](https://www.microsoft.com/en-us/edge?r=1), [Firefox](https://www.mozilla.org/en-US/exp/firefox/new/) etc.

- Install [Node.js](https://nodejs.org/en/download/) LTS version

- Install [Git](https://git-scm.com/downloads)

### Setup

Clone this repository to your desired folder:

```sh

  git clone git@github.com:PraisesPJMT/Fruugal.git

  cd Fruugal

```

### Install

Install this project with:

```sh

  gem install bundler

  bundle install

```

### Usage

To run the project, execute the following command:

```sh

  rails server

```

- After running `rails server`, use the app on [http://localhost:3000/](http://localhost:3000/) in the browser!

- For more information please visit [Ruby-on-Rails](https://rubyonrails.org/).

(back to top)


## 👥 Authors 

👤 **Praises Tula**

[![GitHub](https://img.shields.io/badge/github-%23121011.svg?style=for-the-badge&logo=github&logoColor=white)](https://github.com/Paul-js-hub)

[![LinkedIn](https://img.shields.io/badge/linkedin-%230077B5.svg?style=for-the-badge&logo=linkedin&logoColor=white)](https://www.linkedin.com/in/praises-tula/)

[![Twitter](https://img.shields.io/badge/Twitter-%231DA1F2.svg?style=for-the-badge&logo=Twitter&logoColor=white)](https://twitter.com/PraisesPJMT/)

[![Gmail](https://img.shields.io/badge/Gmail-D14836?style=for-the-badge&logo=gmail&logoColor=white)](mailto:praisesmusa@gmail.com)

[![AngelList](https://img.shields.io/badge/AngelList-%23D4D4D4.svg?style=for-the-badge&logo=AngelList&logoColor=black)](https://angel.co/u/praises-tula/)

(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 

Give a ⭐️ if you like this project!

(back to top)


## 🙏 Acknowledgments 

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

> - Tip hart to you for checking this project out

(back to top)


## 📝 License 

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