KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #ai-agent #developer-tools #codex #typescript #cli #deepseek-harness #claude-code #ai-agents #mcp #rust

Recipe-Recommender

★ 7 Open GitHub ↗

An application that suggests food recipes given certain ingredients or themes.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Recipe Recommender - ورقة وقلم

If you are a student and want to eat or a housewife and want to feed your children and husband, this app is made for you.

## Authors
- [Abdelrahman Ahmed Bahaa](https://github.com/AbdelrahmanMosly)
- [Ahmed Adel Abudef](https://github.com/Deffo0)
- [Louai Zahran](https://github.com/LouaiZahran)
- [Muhammad Ibrahim Elkotb](https://github.com/MuhammadElkotb)
- [Mohamed Mamdouh](https://github.com/MohamedMamdouh18)
- [Youssef Ali Mohamed Bazina](https://github.com/Bazina)

## Documentation

- [Overall Designs](https://github.com/MAMA-LY/Recipe-Recommender/blob/main/docs/architecture/overall%20design.md)
- [UI/UX Primitive Prototypes](https://github.com/MAMA-LY/Recipe-Recommender/blob/main/docs/architecture/UI_Design_Prototype.md)
- [Class Diagram](https://github.com/MAMA-LY/Recipe-Recommender/blob/main/docs/architecture/Class%20Diagram.md)
- [Deployment Details and Capabilities](https://github.com/MAMA-LY/Recipe-Recommender/blob/main/docs/deployment.md)
## Environment Variables

To run the Backend of this project locally, you will need to add the following environment variables to your .env file:

`BrainFoodEndPoint`

`BrainFoodUsername`

`BrainFoodPassword`

To run the Frontend of this project, you will need to add the following environment variables to your .env file

`BrainFoodBackEndIP`
- To get them you must contact with one of the authors.

## Tech Stack

**Client:** Flutter

**Server:** Spring Boot, Azure Deployment

**Database:** PostgreSQL, Supabase Deployment

## FrontEnd Installation

Install with flutter

```bash
  flutter pub get
  flutter run
```
    
## Features

- Splash Screen
- User Authentication
- Home Page
- Setting Page
- Search Page
- Search Filters
- Save Favorite Recipes
- Recipe themes
- Cultural Cuisines
- Recommending Recipes given Ingredients
- Recipe Rating
- Show Recipe Ingredients
- Show Recipe Nutrition Content
- Supports list view
- Swipe to change menus
- Color themes (Dark and Light Modes)
- Calorie Tracker

## Roadmap

- Add NN to recommend recipes in the home page.

- Add meal calendar.

- Solve the remaining issues.

## FAQ

#### Question 1
>How to request a feature?
- you can follow the [issue template](https://github.com/MAMA-LY/Recipe-Recommender/blob/main/.github/ISSUE_TEMPLATE/feature_request.md) to request a feature. 
#### Question 2
>How to report a bug?
- you can follow the [issue template](https://github.com/MAMA-LY/Recipe-Recommender/blob/main/.github/ISSUE_TEMPLATE/bug_report.md) to report a bug.

## Contributing

Contributions are always welcome!

See `CODE_OF_CONDUCT.md` for ways to get started.

## Feedback

If you have any feedback, please reach out to us at mamaly.brainfood@gmail.com

## License

[GNU AGPLv3](https://choosealicense.com/licenses/agpl-3.0/#)

Recipe-Recommender

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README