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

https://github.com/zewdu444/budget_app

A mobile web application that simplifies budget management by organizing transactions into categories, providing a clear overview of expenses and spending patterns. Users can easily track their spending. Built with Ruby on Rails, PostgreSQL and Rspec
https://github.com/zewdu444/budget_app

postgresql ror rspec-rails ruby

Last synced: about 1 year ago
JSON representation

A mobile web application that simplifies budget management by organizing transactions into categories, providing a clear overview of expenses and spending patterns. Users can easily track their spending. Built with Ruby on Rails, PostgreSQL and Rspec

Awesome Lists containing this project

README

          

# 📗 Table of Contents

- [📖 About the Project](#about-project)
- [📹 video presentation](#video-presentation)
- [:camera: screenshots](#screenshots)
- [🛠 Built With](#built-with)
- [Tech Stack](#tech-stack)
- [Key Features](#key-features)
- [🚀 Live Demo](#live-demo)
- [💻 Getting Started](#getting-started)
- [Setup](#setup)
- [Prerequisites](#prerequisites)
- [Usage](#usage)
- [👥 Authors](#authors)
- [🔭 Future Features](#future-features)
- [🤝 Contributing](#contributing)
- [⭐️ Show your support](#support)
- [🙏 Acknowledgements](#acknowledgements)

- [📝 License](#license)

# 💰 Budget App

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

## 📹 video presentation

- Video presentation link

## :camera: screenshots

## 🛠 Built With

### Tech Stack

- ROR
- Postgresql
- Rspec

### :rocket: Live Demo

- Live Link

### Key Features

- [x] User can create an account
- [x] User can login
- [x] User can create a transaction
- [x] user can create a category
- [x] user can view all transactions based on category
- [x] mobile first design
- [x] Rspec test for models, controllers and views

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

- Command line or terminal
- IDE such as VsCode.
- Rails needs to be installed on your system.

### Setup

Clone this repository to your desired folder:
Example command:

```sh
git clone https://github.com/zewdu444/budget_app.git
cd budget_app

```

### Install

Example command:

```sh
cd budget_app
bundle install (install all dependencies)

```

### Usage

To run the project redirecting to the root directory of the project and run the following command:

```sh
bin/rails server (to run web application)

```

### Test

To test the web app run the following command:

```sh
rspec spec ( to test the web application)

```

## 👥 Authors

👤 **Zewdu Erkyhun**

- GitHub: [@zewdu444](https://github.com/zewdu444)
- Twitter: [@zewdu444](https://twitter.com/zewdu444)
- LinkedIn: [zewdu-anley](https://www.linkedin.com/in/zewdu-anley/)

(back to top)

## 🔭 Future Features

- [UX Desktop design]
- [will add REST API]
- [side navigation bar for mobile view]

(back to top)

## 🤝 Contributing

Contributions, issues, and feature requests are welcome!

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

(back to top)

## ⭐️ Show your support

Give a ⭐️ if you like this project!

(back to top)

## 🙏 Acknowledgments

-

I would like to thank microverse community for the support and guidance


-

I would like to express gratitude to Gregoire Vella, as per the Creative Commons license.

(back to top)

## 📝 License

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

(back to top)