📗 Table of Contents

• 📗 Table of Contents
• 📖 Fruugal
  • 🛠 Built With
    • Tech Stack
    • Key Features
  • 🚀 App Preview
  • 🚀 Live Demo
• 💻 Getting Started
  • Prerequisites
  • Setup
  • Install
  • Usage
• 👥 Authors
• 🤝 Contributing
• ⭐️ Show your support
• 🙏 Acknowledgements
• 📝 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

User Pages Preview

(back to top)

🚀 Live Demo

This app has been deployed using Railway.app. Use th link below to view live app.

• Fruugal

(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, Edge, Firefox etc.
• Install Node.js LTS version
• Install Git

Setup

Clone this repository to your desired folder:

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

Install

Install this project with:

  gem install bundler
  bundle install

Usage

To run the project, execute the following command:

  rails server

• After running rails server, use the app on http://localhost:3000/ in the browser!
• For more information please visit Ruby-on-Rails.

(back to top)

👥 Authors

👤 Praises Tula

(back to top)

🤝 Contributing

Contributions, issues, and feature requests are welcome!

Feel free to check the issues page.

(back to top)

⭐️ Show your support

Give a ⭐️ if you like this project!

(back to top)

🙏 Acknowledgments

• Original UI design by Gregorire Vella on Behance.
• Tip hart to you for checking this project out

(back to top)

📝 License

This project is MIT licensed.