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

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

The RecipeApp is a web application build on Ruby on Rails and TailwindCSS that allows 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/nitbravoa92/recipe-app

cancancan capybara devise rspec-rails ruby-on-rails

Last synced: about 1 month ago
JSON representation

The RecipeApp is a web application build on Ruby on Rails and TailwindCSS that allows 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

          


Recipe App | Ruby on Rails


# πŸ“— Table of Contents

- [πŸ“— Table of Contents](#-table-of-contents)
- [πŸ“– Recipe App ](#-recipe-app-)
- [πŸ›  Built With ](#-built-with-)
- [Tech Stack](#tech-stack)
- [Key Features](#key-features)
- [πŸ’» Getting Started ](#-getting-started-)
- [Prerequisites](#prerequisites)
- [Setup](#setup)
- [Usage](#usage)
- [Install](#install)
- [Run tests](#run-tests)
- [πŸ‘₯ Authors ](#-authors-)
- [πŸ”­ Future Features ](#-future-features-)
- [🀝 Contributing ](#-contributing-)
- [⭐️ Show your support ](#️-show-your-support-)
- [πŸ™ Acknowledgments ](#-acknowledgments-)
- [πŸ“ License ](#-license-)

# πŸ“– Recipe App

The **Recipe App** is a web application build on Ruby on Rails that allows 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.

## πŸ›  Built With

### Tech Stack

Back-end

Front-end

### Key Features
* Use of Rails framework.
* MVC architecture.
* Save and retrieve information from a PostgreSQL database.
* Log in and registration with Devise gem.
* Integration and unit tests with Capybara and RSpec.
* Authorization with CanCanCan gem.
* Find and solve N + 1 problems with Bullet gem.

(back to top)

### πŸš€ Live Demo

To see the application working live, you can click on the following link that contains the demo version:

- [easyCOOK - Live Demo](https://recipe-app-zxdn.onrender.com/)

(back to top)

## πŸ’» Getting Started

### Prerequisites
In order to run this project you need to have:

- Installed Ruby (v 3.2.2).
- Installed PostgreSQL.
- If you're using Windows, have installed WSL.
- If you're using MacOS, an option is using UTM.

### Setup
To clone this repository to your desired folder, run the following command:

```
git clone git@github.com:NitBravoA92/recipe-app.git
```

(back to top)

### Usage
To open a local server, type the following command:
```
rails server
```

(back to top)

### Install
To install all the ruby gems, use the following command:
```
bundle install
```
To install the npm dependencies, use the following command:
```
npm install
```
After installing the gems, run this command to create and migrate a database:
```
rails db:create db:migrate
```

(back to top)

### Run tests
To run the RSpec unit and integration tests, use the following command:
```
rspec
```

(back to top)

## πŸ‘₯ Authors

πŸ‘€ **Nitcelis Bravo**

- GitHub: [Nitcelis Bravo](https://github.com/NitBravoA92)
- Twitter: [@softwareDevOne](https://twitter.com/softwareDevOne)
- LinkedIn: [Nitcelis Bravo Alcala](https://www.linkedin.com/in/nitcelis-bravo-alcala-b65340158)

πŸ‘€ **Manuel SΓ‘nchez**

- GitHub: [@Luffytaro22](https://github.com/Luffytaro22)
- LinkedIn: [Manuel SΓ‘nchez](https://www.linkedin.com/in/manuel-alejandro-sanchez-sierra/)

(back to top)

## πŸ”­ Future Features
- [ ] Allow the users to follow each other.
- [ ] Implement a like button to the recipes.
- [ ] Generate API endpoints.
- [ ] Deploy the application.

(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
If you like this project please give it a star ⭐️

(back to top)

## πŸ™ Acknowledgments

I would like to give credits to the following:
* **Microverse** for this readme template.

(back to top)

## πŸ“ License

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

(back to top)