Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/kaizipaul/budget-app

The Budget app is a mobile web application where you can manage your budget: There is a list of transactions associated with a category, so that you can see how much money you spent and on what.
https://github.com/kaizipaul/budget-app

postgresql rails rspec rspec-rails ruby rubyonrails

Last synced: 11 days ago
JSON representation

The Budget app is a mobile web application where you can manage your budget: There is a list of transactions associated with a category, so that you can see how much money you spent and on what.

Awesome Lists containing this project

README

        


Tracker Budget


# 📗 Table of Contents

- [📖 About the Project](#about-project)
- [🛠 Built With](#built-with)
- [Tech Stack](#tech-stack)
- [Diagram](#diagram)
- [💻 Getting Started](#getting-started)
- [Setup](#setup)
- [Prerequisites](#prerequisites)
- [Install](#install)
- [Usage](#usage)
- [👥 Authors](#authors)
- [🔭 Future Features](#future-features)
- [🤝 Contributing](#contributing)
- [⭐️ Show your support](#support)
- [🙏 Acknowledgements](#acknowledgements)
- [❓ FAQ](#faq)
- [📝 License](#license)

# Blog App

**Tracker Budget** is a mobile web application where you can manage your budget: There is 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

Server

back to top

### ERD Diagram
![Preview](./app/assets/images/erd_diagram.png)

### Live Demo
This is a [live](https://thebudgettracker.onrender.com/) demo of the mobile app

### Video Demo
This is a [video](https://www.loom.com/share/146e532d27804ddb9c7ad5c7a313da4b) demonstration of the app

### Key Features

- **User Sign_up and Sing_in**
- **User can add Categories**
- **User can add expenditures to Categories**

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

- Ruby
- Rails
- Postgresql

### Setup

Clone this repository to your desired folder:

```sh
cd blog-app
git clone https://github.com/kaizipaul/tracker-budget.git
```

### Install

Install this project with:

- After cloning type 'cd tracker-budget'.
- Run 'bundle install' to install all the required dependencies.

### Usage

To run the project, execute the following command:
- Run 'rails db:create' to create a new database
- Run 'rails db:migrate' to migrate the db and build the schema
- Run 'rails s' to start the dev server

back to top

## 👥 Authors

👤 **Paul Kaizirege**

- GitHub: [GitHub](https://github.com/kaizipaul)
- LinkedIn: [LinkedIn](https://www.linkedin.com/in/kaizipaul/)

back to top

## 🔭 Future Features

> Features to add to the project.
- [ ] **[ Add Transitions and Animations ]**

## 🤝 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...

back to top

## Acknowledgments

I would like to thank Microverse and all our colleagures there.
- Original design by [Gregoire Vella on Behance](https://www.behance.net/gregoirevella)

## ❓ FAQ

- **Do I have to have any previous knowledge about ruby to use this project?**

- No!

- **How to use this project?**

- check the [Getting Started](#getting-started) section to have a complete guid on how to setup and run teh project.

back to top

## 📝 License

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

back to top