Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/olubodemichael/meal-app
The Meal Planner App is a React Native application designed to help users discover and manage their favorite meals. It allows users to browse through various meal categories, view detailed information about specific meals, and save their favorite meals for easy access later.
https://github.com/olubodemichael/meal-app
expo javascript react-native
Last synced: 1 day ago
JSON representation
The Meal Planner App is a React Native application designed to help users discover and manage their favorite meals. It allows users to browse through various meal categories, view detailed information about specific meals, and save their favorite meals for easy access later.
- Host: GitHub
- URL: https://github.com/olubodemichael/meal-app
- Owner: OlubodeMichael
- Created: 2024-08-15T16:05:39.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2024-08-15T20:34:10.000Z (5 months ago)
- Last Synced: 2024-11-14T14:15:28.692Z (2 months ago)
- Topics: expo, javascript, react-native
- Language: JavaScript
- Homepage:
- Size: 194 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Meal Planner App
## Overview
The Meal Planner App is a React Native application designed to help users discover and manage their favorite meals. It allows users to browse through various meal categories, view detailed information about specific meals, and save their favorite meals for easy access later.
https://github.com/user-attachments/assets/3810f90d-7d0b-4c92-8b9b-086f2d14082f
## Features
- **Browse Categories**: Explore different categories of meals such as breakfast, lunch, dinner, and snacks.
- **View Meals**: View a list of meals available within each category, with details such as duration, complexity, and affordability.
- **Meal Details**: Access detailed information about each meal, including ingredients and preparation steps.
- **Favorites**: Save meals to your favorites list and easily access them whenever you want.
- **Favorite Management**: Add or remove meals from your favorites with a single click.
## Installation
1. Clone the repository:
```bash
git clone https://github.com/Olubodemichael/mealApp.git
```
2. Navigate to the project directory:
```bash
cd mealApp
```
3. Install the dependencies:
```bash
npm install
```
4. Run the app:
```bash
npm start
```
## File Structure
- **`CategoriesScreen.js`**: Displays a grid of meal categories, allowing users to select and navigate to meals within a specific category【7†source】.
- **`MealsOverviewScreen.js`**: Shows an overview of meals in the selected category, filtered by the chosen category ID【8†source】.
- **`MealDetailScreen.js`**: Provides detailed information about a specific meal, including ingredients, steps, and an option to add/remove the meal from favorites【10†source】.
- **`FavoritesScreen.js`**: Displays a list of the user's favorite meals. If no favorites are selected, a message is shown to the user【9†source】.
## Data Management
- **Dummy Data**: The app uses static dummy data for meal and category information, which can be found in the `dummy-data.js` file.
- **Context API**: The app uses React's Context API to manage the state of favorite meals across different screens.
## Customization
Feel free to customize the app by modifying the dummy data, adjusting the styling, or adding new features.
## Contributing
Contributions are welcome! If you'd like to contribute to the project, please fork the repository and create a pull request.
## License
This project is licensed under the MIT License. See the LICENSE file for more details.
---
This README provides an overview of the app, installation instructions, a file structure breakdown, and other essential details.