Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/devmunyi/recipe-app

The Recipe app keeps track of all your recipes, ingredients, and inventory. It will allow you to save ingredients, keep track of what you have, create recipes, and generate a shopping list based on what you have and what you are missing from a recipe.
https://github.com/devmunyi/recipe-app

authentication authorization cancancan devise erb mvc postgresql ruby ruby-on-rails rubygems testing

Last synced: 25 days ago
JSON representation

The Recipe app keeps track of all your recipes, ingredients, and inventory. It will allow you to save ingredients, keep track of what you have, create recipes, and generate a shopping list based on what you have and what you are missing from a recipe.

Awesome Lists containing this project

README

        

# πŸ“— 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)
- [Setup](#setup)
- [Prerequisites](#prerequisites)
- [Install](#install)
- [Usage](#usage)
- [Run tests](#run-tests)
- [Deployment](#triangular_flag_on_post-deployment)
- [πŸ‘₯ Authors](#authors)
- [πŸ”­ Future Features](#future-features)
- [🀝 Contributing](#contributing)
- [⭐️ Show your support](#support)
- [πŸ™ Acknowledgements](#acknowledgements)
- [❓ FAQ (OPTIONAL)](#faq)
- [πŸ“ License](#license)

# πŸ“– Recipe App

> The Recipe app keeps track of all your recipes, ingredients, and inventory. It will allow you to save ingredients, keep track of what you have, create recipes, and generate a shopping list based on what you have and what you are missing from a recipe. Also, since sharing recipes is an important part of cooking the app should allow you to make them public so anyone can access them.

## πŸ›  Built With

### Tech Stack

Client

Server

Database

### Key Features

- **[keeps track of all your recipes, ingredients, and inventory]**
- **[allow you to save ingredients, keep track of what you have, create recipes, and generate a shopping list based on what you have and what you are missing from a recipe]**
- **[allow you to make recipes public so anyone can access them]**

(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 followed installed on your computer:
- Ruby v3+,
- Rails v7+
- PostgreSQL
- An IDE e.g [Visual studio code](https://code.visualstudio.com/).
- [A terminal](https://code.visualstudio.com/docs/terminal/basics).

### Setup

Clone this repository to your desired folder or download the Zip folder:

```
git clone https://github.com/devMunyi/Recipe-App
```

- Navigate to the location of the folder in your machine:

**`you@your-Pc-name:~$ cd Recipe-App`**

### Install

To install all dependencies, run:

```
bundle install
```

### Usage

To run the project, follow these instructions:

- After Cloning this repo to your local machine.
- To get it running on your machine, you may open the project on your IDE and open the terminal
- On the terminal you can run:

```
rails s OR rails server
```
- After, you can follow along the app and run the appropriate option from navsigations to interact with it.

### Run tests

- To run rubcop tests, run the following command:

```
rubocop
```

- To run rspec tests, run the following command:

```
rspec
```

(back to top)

## πŸ‘€ Authors

πŸ‘€ **Samuel Munyi**

- GitHub: [@devMunyi](https://github.com/devMunyi)
- LinkedIn: [Samuel Munyi](https://www.linkedin.com/in/samuel-munyi)
- Twitter: [@munyi_sam](https://twitter.com/munyi_sam)

πŸ‘€ **Tarik Bouari**

- GitHub: [@tarikbouari](https://github.com/tarikbouari)
- LinkedIn: [tarikbouari](https://linkedin.com/tarikbouari)
- Twitter: [@tarikbouari](https://twitter.com/tarikbouari)

(back to top)

## πŸ”­ Future Features

- [ ] **Implement more methods.**
- [ ] **Improve the UI.**
- [ ] **Deploy to live server.**

(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 and how I managed to build it!

(back to top)

## πŸ™ Acknowledgments

- The original design ideal from MicroverseπŸ’•.
- Project from [Microverse](https://bit.ly/MicroverseTN) Ruby / Database and Interviewing module.
- Thanks to the Microverse team for the great curriculum.
- Thanks to the Code Reviewer(s) for the insightful feedbacks.
- A great thanks to My coding partner(s), morning session team, and standup team for their contributions.
- Hat tip to anyone whose code was used.

(back to top)

## ❓ FAQ

- **Can I fork and reuse the repository**

- Yes please, feel free.

- **Can I improve the repository, and my changes will be accepted if they are good?**

- Yes please, nice ideas are welcome, please.

(back to top)

## πŸ“ License

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

(back to top)