An open-source smart recipe app with features like importing products from recipe scans, calculating and suggesting recipes based on available ingredients.
Explore the docs »
View Demo
·
Report Bug
·
Request Feature
Table of Contents
Freat is an open-source variation of a smart recipe app designed to make cooking easier and more enjoyable. It allows users to import products from receipt/bill scans, calculates available ingredients, and suggests recipes based on what's in your kitchen.
Here's why Freat is awesome:
- Smart import of products from receipt/bill scans
- Intelligent calculation and suggestion of recipes based on available ingredients
- Open-source and community-driven development
Feel free to contribute by forking this repo and creating a pull request or opening an issue. Your feedback and contributions are highly appreciated!
This section should list any major frameworks/libraries used to build your project. Here are a few examples for a Compose Multiplatform project.
SqlDelight
- Compose Multiplatform
- Voyager
- Moko
- Koin
- JUnit
- Turbine
This is an example of how you may give instructions on setting up your project locally. To get a local copy up and running, follow these simple example steps.
This is an example of how to list things needed to build and run the app.
-
Clone the repo
git clone https://github.com/MarcelIwanicki/freat.git
-
Open the project in Android Studio
-
Build and run the app on your Android device or emulator
Use this space to showcase useful examples of how to use the app. You can include screenshots, code examples, and demos to illustrate its features.
- Smart import of products from receipt scans
- Intelligent calculation and suggestion of recipes
- Integrate project with Bitrise CI/CD
- Material You support
- Cover code with unit tests
- Cover code with UI tests
- Production ready on iOS
- Improve recipe scanning algorithm
- Improve string similarity algorithm
- Multi-language support
- English
- Other languages - IN PROGRESS
See the open issues for a full list of proposed features and known issues.
Contributions are welcome! If you have suggestions, enhancements, or bug fixes, please follow these steps:
- Fork the Project
- Create your Feature Branch (
git checkout -b feature/AmazingFeature) - Commit your Changes (
git commit -m 'Add some AmazingFeature') - Push to the Branch (
git push origin feature/AmazingFeature) - Open a Pull Request
Distributed under the MIT License. See LICENSE.txt for more information.
Marcel Iwanicki - @marcel-iwanicki - iwanickimarcel@outlook.com
Project Link: https://github.com/MarcelIwanicki/freat
Use this space to give credit to resources that have been helpful. Here are a few to start: