https://github.com/cod-e-codes/kitjinn
A smart, hands-free kitchen assistant app that helps you plan meals, manage your pantry, and discover recipes with voice recognition and delightful Lottie animations.
https://github.com/cod-e-codes/kitjinn
flutter kitchen-assistant lottie-animation meal-planning pantry-management recipe-app voice-recognition
Last synced: 8 months ago
JSON representation
A smart, hands-free kitchen assistant app that helps you plan meals, manage your pantry, and discover recipes with voice recognition and delightful Lottie animations.
- Host: GitHub
- URL: https://github.com/cod-e-codes/kitjinn
- Owner: Cod-e-Codes
- Created: 2024-11-26T00:58:20.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2024-11-26T01:29:41.000Z (11 months ago)
- Last Synced: 2025-01-04T20:42:36.454Z (9 months ago)
- Topics: flutter, kitchen-assistant, lottie-animation, meal-planning, pantry-management, recipe-app, voice-recognition
- Language: Dart
- Homepage: https://github.com/Cod-e-Codes/KitJinn
- Size: 861 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# KitJinn - Your Hands-Free Kitchen Assistant π³β¨
KitJinn is a smart, hands-free kitchen assistant app developed by **CodΔCodes**. It helps you plan meals, manage your pantry, and discover recipes efficiently. With voice recognition commands and engaging Lottie animations, KitJinn ensures your culinary journey is seamless and enjoyable.
## Features
- **Hands-Free Operation**: Use voice commands to navigate and interact with the app while keeping your hands free for cooking.
- **Lottie Animations**: Smooth, engaging animations enhance the user experience and make the app visually appealing.
- **Home Screen**: A dashboard to access key features like meal planning, pantry organization, and recipes.
- **Meal Planner**: Plan your meals for the week with easy-to-use scheduling tools.
- **Pantry Management**: Track ingredients and inventory in your pantry to reduce food waste.
- **Recipe Discovery**: Browse, search, and save recipes with detailed instructions and images.
- **Recipe Detail View**: View in-depth recipe information, including ingredients, steps, and cooking tips.
- **Settings**: Customize the app experience, including theme preferences and notifications.
## Screenshots πΈ
1. **Home Screen**
2. **Meal Planner**
3. **Pantry Screen**
4. **Recipe List**
5. **Recipe Detail**
## Folder Structure
```plaintext
KitJinn/
βββ lib/
β βββ main.dart # Entry point of the app
β βββ settings_provider.dart # App settings and state management
β βββ models/
β β βββ recipe.dart # Recipe data model
β β βββ recipe.g.dart # Generated code for recipe model
β βββ screens/
β β βββ home_screen.dart # Home screen
β β βββ meal_detail_screen.dart # Meal detail screen
β β βββ meal_planner_screen.dart # Meal planner screen
β β βββ pantry_screen.dart # Pantry management screen
β β βββ recipe_detail_screen.dart # Recipe detail view
β β βββ recipe_list_screen.dart # List of recipes
β β βββ settings_screen.dart # App settings
β βββ widgets/
β β βββ custom_bottom_app_bar.dart # Custom navigation bar
βββ assets/
β βββ images/ # App assets and images
β β βββ genie.jpg
β β βββ genie.json
β β βββ genie2.json
β β βββ genie3.json
βββ pubspec.yaml # App dependencies and metadata
```
## Getting Started
### Prerequisites
Ensure you have Flutter installed. If not, follow the [Flutter installation guide](https://flutter.dev/docs/get-started/install).
### Installation
1. Clone this repository:
```bash
git clone https://github.com/Cod-e-Codes/KitJinn.git
```
2. Navigate to the project directory:
```bash
cd KitJinn
```
3. Fetch dependencies:
```bash
flutter pub get
```
4. Run the app:
```bash
flutter run
```
## Contribution
Feel free to fork this repository and submit pull requests. Contributions are always welcome!
## Author
Developed by [CodΔCodes](https://github.com/Cod-e-Codes). For inquiries or collaboration, reach out via the GitHub profile.
---
KitJinn - Your hands-free kitchen companion with voice commands and delightful animations. π½οΈβ¨