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

https://github.com/willie-conway/foodie-app

🍽️ Foodie Recipe App🍲🫕 lets users browse, explore, and save recipes. With features like detailed recipe pages, favorites, and personal collections, it's the perfect app for food lovers! 🍳📱
https://github.com/willie-conway/foodie-app

cookbook expo favorites foodie mobile mobile-app mobile-development navigation react-native-app recipes redux

Last synced: 6 months ago
JSON representation

🍽️ Foodie Recipe App🍲🫕 lets users browse, explore, and save recipes. With features like detailed recipe pages, favorites, and personal collections, it's the perfect app for food lovers! 🍳📱

Awesome Lists containing this project

README

          

# 🍽️ Foodie Recipe App 🥘
![Foodie Recipe App](https://github.com/Willie-Conway/Foodie-App/blob/32bc6ec4118644830aec1f204bda072e0935d91a/Screenshots/Foodie%20App.png)

Welcome to **Foodie Recipe App**, your ultimate companion to discover, save, and manage delicious recipes from all around the world. This app allows users to browse through a collection of recipes, view their details, save their favorites, and even add their own culinary creations.

![Foodie-App](https://github.com/Willie-Conway/Foodie-App/blob/9138d980c637117ae75d08fd58ccca85ea4296c2/Screenshots/Foodie-App.gif)

## 🧑‍🍳 What You Will Build

In this project, you will build a React Native application that:

- Fetches and displays a list of recipes 🍝
- Allows users to navigate to detailed recipe pages 📜
- Lets users save favorite recipes 💖
- Provides a personal space for adding and managing your own recipes 🍽️

## 🚀 Key Features

### 1. **Main Feed** 🍴
- View a list of recipes with their names and images 🖼️.
- Scroll through various categories of dishes via a horizontal scroll bar 🔄.
- Each recipe is clickable to view detailed content.

### 2. **Recipe Details** 📝
- View detailed information about each recipe:
- Recipe image 📸
- List of ingredients 🍅
- Step-by-step instructions 🔪
- Preparation time ⏰
- Servings 🍽️
- Calories 🍏
- Difficulty level ⚡
- Favorite recipes with a toggle button 💖.

### 3. **Favorites Section** 💾
- Store your favorite recipes for easy access later.
- Revisit saved recipes anytime from the "Favorites" section.

### 4. **My Food (Personal Recipes)** 🍱
- Add, edit, or delete your own recipes.
- Upload images, input recipe names, ingredients, and steps.

### 5. **Back Button** 🔙
- Every page includes a back button for smooth navigation.

## 🌍 Technologies Used

- **React Native**: Framework for building native mobile apps using React.
- **React Navigation**: For handling navigation between screens.
- **Redux**: To manage the app state, such as favorite recipes.
- **React Native Responsive Screen**: For responsive design on different screen sizes.

## ⚙️ Setup Instructions

### Prerequisites

Before getting started, ensure you have the following installed:

- Node.js (latest LTS version)
- npm or Yarn
- React Native (You can use Expo for easier setup)
- A mobile device or emulator to test the app

### Getting Started

1. **Clone the repository:**

```bash
git clone https://github.com/Willie-Conway/Foodie-App.git
```

2. **Install dependencies:**

Navigate to the project directory and install the required dependencies.

```bash
cd Foodie-App
npm install
```

3. **Start the app:**

If you're using Expo (recommended for easier setup):

```bash
expo start
```

If you're using React Native CLI, run the following:

```bash
npx react-native run-android # For Android
npx react-native run-ios # For iOS
```

## 🛠️ Features to Be Implemented

- **Add New Recipe**: A form to input recipe name, ingredients, and instructions.
- **Search Functionality**: Allow users to search for recipes by name or ingredient.
- **Advanced Filtering**: Sort recipes based on difficulty level, prep time, or category.

## 📸 Screenshots

*Home Menu.*

![Home Screen](https://github.com/Willie-Conway/Foodie-App/blob/32bc6ec4118644830aec1f204bda072e0935d91a/Screenshots/All%20Recipes%20Home.png)

*Main feed with recipe list.*

![My Favorites](https://github.com/Willie-Conway/Foodie-App/blob/5ac97b1ef166d97577e23e9e403b92a588fed0c0/Screenshots/My%20Favorites.png)

![Favorites](https://github.com/Willie-Conway/Foodie-App/blob/32bc6ec4118644830aec1f204bda072e0935d91a/Screenshots/Favorites.png)

*Add or Delete My Items.*

![My Food](https://github.com/Willie-Conway/Foodie-App/blob/b55758e0cde1312ff86f5c49cb032c0a27cfbf4f/Screenshots/My%20Recipe.png)

![My Item](https://github.com/Willie-Conway/Foodie-App/blob/afce6e796bd5f5b455d04ca24118e67c7f5357bb/Screenshots/My%20Item.png)

![Add or Delete](https://github.com/Willie-Conway/Foodie-App/blob/afce6e796bd5f5b455d04ca24118e67c7f5357bb/Screenshots/Add%20or%20Delete%20Item.png)

![Save Recipe](https://github.com/Willie-Conway/Foodie-App/blob/b28e84e779501b9726711a4c41f0e6bf37d88889/Screenshots/Save%20Recipe.png)

![Multiple Items](https://github.com/Willie-Conway/Foodie-App/blob/6a2766f94e51cd516775674f538e773fb1016323/Screenshots/My%20Multiple%20Items.png)

*Recipe detail page showing instructions and ingredients.*

## 📋 To Do

- [ ] Implement the Add New Recipe form 📑
- [ ] Create Recipe Categories (e.g., Vegan, Gluten-Free, etc.) 🍲
- [ ] Enhance styling for better UX 💅
- [ ] Add search functionality 🔍

## 🔧 Technologies Used

- **React Native** 📱
- **React Navigation** 🚀
- **Redux** 🛠️
- **Axios** for data fetching 🌐

## 🙋‍♂️ Contributing

If you'd like to contribute to this project, feel free to fork it, make changes, and submit a pull request! We welcome contributions from everyone.

- **Fork the repo**: Create your own copy of this project by forking it.
- **Create a branch**: Make a new branch for your changes.
- **Make changes**: Implement the feature or fix the bug.
- **Create a pull request**: Submit your changes for review.

## 📄 License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

**Happy Cooking! 🍳👨‍🍳👩‍🍳**