Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

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

This is a Ruby on Rails capstone project about building 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.
https://github.com/tsheporamantso/budget-app

devise erb-html postgresql rspec ruby-on-rails

Last synced: 18 days ago
JSON representation

This is a Ruby on Rails capstone project about building 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.

Awesome Lists containing this project

README

        

Budget App

# 📗 Table of Contents

- [📖 About the Project](#about-project)
- [🛠 Built With](#built-with)
- [Tech Stack](#tech-stack)
- [Key Features](#key-features)
- [🚀 Live Demo](#live-demo)
- [💻 Getting Started](#getting-started)
- [Prerequisites](#prerequisites)
- [Setup](#setup)
- [Install](#install)
- [Usage](#usage)
- [Run tests](#run-tests)
- [Deployment](#deployment)
- [👥 Authors](#authors)
- [🔭 Future Features](#future-features)
- [🤝 Contributing](#contributing)
- [⭐️ Show your support](#support)
- [🙏 Acknowledgements](#acknowledgements)
- [❓ FAQ (OPTIONAL)](#faq)
- [📝 License](#license)

# 📖 Recipe App

**Budget App** This is a Ruby on Rails capstone project about building 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**
- **Ruby**
- **HTML**
- **CSS**

### Tech Stack

Server


### Key Features

- **Ruby on Rails**
- **Creating data model**
- **Functional website**
- **Database**
- **Unit Testing**

(back to top)

## 🚀 Live Demo

- Live demo [link](https://budget-app-xdmc.onrender.com)
- Presentation [link](https://drive.google.com/file/d/1Pe7wPLhLAgDZx4ih-z1e_vvkMEdk9YtR/view?usp=sharing)

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

- Install ruby using [link](https://www.ruby-lang.org/en/documentation/installation/#apt)
- Install ruby on rails using [link](https://guides.rubyonrails.org/)

### Setup

Clone this repository to your desired folder:

```sh
mkdir Recipe-App
cd Recipe-App
git clone [email protected]:tsheporamantso/budget-app.git
```

### Install

Install this project with:

```sh
bundle install
```

```sh
rails rails db:create
```

```sh
rails db:migrate
```

### Usage

To run the project, execute the following command:
run the result on the terminal through:

```sh
rails server
```

### Run tests

To run tests, execute the following command on the terminal

```sh
bundle exec rspec
```

### Deployment

Not deployed

(back to top)

## 👥 Authors

👤 **Gladwin Tshepo Ramantso**

- GitHub: [@tsheporamantso](https://github.com/tsheporamantso)
- Twitter: [@ramgt001](https://twitter.com/ramgt001)
- LinkedIn: [Tshepo Gladwin Ramantso](https://www.linkedin.com/in/tshepo-ramantso-b6a35433/)

(back to top)

## 🔭 Future Features

- [ ] **Validation and Model specs**
- [ ] **Processing data in models**
- [ ] **Controllers**
- [ ] **Controllers specs**
- [ ] **Views**
- [ ] **Forms**
- [ ] **Intergration specs for Views and fixing n+1 problems**
- [ ] **Add Devices**

(back to top)

## 🤝 Contributing

Contributions, issues, and feature requests are welcome!

Feel free to check the [issues page](https://github.com/tsheporamantso/budget-app/issues).

(back to top)

## ⭐️ Show your support

If you like this project please give a star on [github](https://github.com/tsheporamantso/OOP-School-Library) & follow us on [twitter](https://twitter.com/ramgt001) and also connect on [Linkedin](https://www.linkedin.com/in/tshepo-ramantso-b6a35433/).

(back to top)

## 🙏 Acknowledgments

I would like to thank:

- [ ] **Gregoire Vella on Behance for the design pattern**
- [ ] **Microverse and all the staff**
- [ ] **Microverse Communinity**
- [ ] **Thanks to my coding Partners**
- [ ] **Thanks to my Morning-Session-Group and Standup-Team Partners and**
- [ ] **Thanks to Code Reviewers**

(back to top)

## 📝 License

This project is [MIT](https://github.com/tsheporamantso/budget-app/blob/6aaa6472a70d39e138257eaceabcc5093f3da1e2/LICENSE) licensed.

(back to top)