Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

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


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

Last synced: 8 days ago
JSON representation

Awesome Lists containing this project

README

        



Recipe App | Ruby on Rails Capstone Project


# 📗 Table of Contents

- [📖 About the Project](#about-project)
- [🛠 Built With](#built-with)
- [Tech Stack](#tech-stack)
- [Key Features](#key-features)

- [💻 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)
- [📝 License](#license)

---

# Recipe app

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

These is the ERD for the project:
![image](./recipe_app_erd.png)

---

## 🛠 Built With

### Tech Stack

The project is built using the following technologies:

* Ruby on Rails.
* PostgreSQL.
* RSpec.
* Rubocop.
* Stylelint.


---

### Key Features

- [x] Create and delete recipes and ingredients.
- [x] 'Make public' option to share recipes with other users.
- [x] User authentication.
- [x] Responsive design.

Please note: Each feature will be marked with an "x" when it is fully implemented and operational.


  • HTML & CSS3

  • Ruby on Rails

  • Linters

    • Rubocop

    • StyleLint



  • Follow Microverse's list of best practices

(back to top)

---

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

- Installed Ruby and Ruby on Rails.
- 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 https://github.com/grauJavier/recipe-app.git
```

Navigate to the cloned repository and run the following command to install the necessary gems:
```
cd blog-app
bundle install
```

(back to top)

### Usage
Initialize it with
```
rails server
```
Then open `http://localhost:3000` in your browser.

(back to top)

### Test
To run the tests try the following command:
```
rspec spec
```

(back to top)

(back to top)

---

## 👥 Authors

👤 **Javier Grau**
- GitHub: [@grauJavier](https://github.com/grauJavier)
- Twitter: [@jgrauchile](https://twitter.com/jgrauchile)
- LinkedIn: [LinkedIn](https://www.linkedin.com/in/javiergrau)

👤 **Ruth Abreu**

- GitHub: [@Ruthmy](https://github.com/Ruthmy)
- Twitter: [@rury_exe](https://twitter.com/rury_exe)
- LinkedIn: [LinkedIn](https://linkedin.com/in/ruth-abreu)

(back to top)

---

## 🔭 Future Features

Upcoming improvements:

- [ ] Search functionality for locating specific articles.
- [ ] User profiles with customizable avatars.

(back to top)

---

## 🤝 Contributing

Contributions, issues, and feature requests are welcome!

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

(back to top)

---

## ⭐️ Show your support

If you like this project and know someone who might find it helpful, please share it.
Or give it a **star** ⭐️

(back to top)

---

## 🙏 Acknowledgments

I thank Microverse for this fantastic opportunity, and the code reviewers for their advice and time.

(back to top)

---

## 📝 License

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

(back to top)

---