FlavorPlan — Competition Form Content
✏️ Project Story — "About the project"
FlavorPlan — Your AI-Powered Cooking Companion 🍳
Inspiration
Every home cook knows the struggle: staring at a fridge full of ingredients with no idea what to make, juggling dietary restrictions, trying to eat healthy, and wasting time hunting for recipes across dozens of websites. We built FlavorPlan to solve all of that in one place — an intelligent cooking companion that thinks with you, plans for you, and adapts to your lifestyle.
What It Does
FlavorPlan is a feature-rich, offline-first mobile app built with Flutter that combines AI-powered planning, smart ingredient scanning, and personalized nutrition tracking into a seamless cooking experience — monetized through RevenueCat subscriptions.
🧑🍳 Create Your Own Recipes
Build and save your personal recipes with full details — ingredients with quantities, step-by-step instructions, cooking time, difficulty level, photos, and nutritional information. Your recipe collection is unlimited for premium users and always available offline.
🥗 Calorie Tracking & Goal Achievement
Set personalized health goals — Weight Loss, Weight Gain, Muscle Building, or Maintenance — and FlavorPlan calculates your daily calorie and macro targets using the Mifflin-St Jeor equation. Track your progress across multiple dates with a daily calorie dashboard (circular progress + macro bars) and weekly nutrition insights with 7-day trend charts.
⚠️ Allergy & Dietary Preferences
Exclude specific foods or entire food categories based on your allergies and dietary choices. Whether you're vegan, vegetarian, gluten-free, keto, or paleo, FlavorPlan filters every suggestion, meal plan, and recipe recommendation to match your restrictions — so you never have to worry about unsafe or unwanted ingredients.
🤖 AI-Powered Weekly Meal Planner
Our standout feature: tell FlavorPlan your preferences — cuisine, dietary restrictions, calorie goals, difficulty level — and the AI generates a complete weekly meal plan dedicated to your choices. Breakfast, lunch, dinner, and snacks for 7 days, fully customized to your taste and nutritional needs. Drag-and-drop to rearrange, swap meals, or regenerate individual days.
📸 Smart Ingredient Scanner
Point your camera at what's in your hand or in your fridge — FlavorPlan's ML Kit-powered AI recognizes the ingredients and suggests recipes you can make right now based on what you actually have. Each suggestion shows a match percentage so you know exactly how close you are. Missing one ingredient? It goes straight to your shopping list.
🎬 Import Recipes from Video or PDF
See a recipe you love in a YouTube video? Paste the link and Gemini AI extracts the full structured recipe — title, ingredients, instructions, cooking time — automatically. Same for PDF files: import any recipe document and FlavorPlan parses it into a usable, editable recipe card.
🌓 Dark & Light Mode
FlavorPlan supports both dark and light themes with Material Design 3, adapting to your system preference for a comfortable cooking experience day or night.
🛒 Automatic Shopping List Generation
Tap a recipe → shopping list generated instantly. Plan your whole week with AI → complete shopping list for the entire week plan created automatically. Items are cumulated intelligently (no duplicates), can be checked off as you shop, and everything works offline with < 50ms response time.
Additional Features
- 100+ curated recipes from global cuisines with advanced search & filtering
- Smart Grocery Stock — track what's in your kitchen with real-time status indicators
- Reviews & Ratings — 5-star system with helpful voting and community feedback
- Gamification — earn points, unlock 30+ achievement badges, complete daily/weekly challenges
- PDF Export — save and print your favorite recipes
- Cloud Sync — your data backed up and synced across devices (premium)
How We Built It
| Layer | Technology |
|---|---|
| Framework | Flutter 3.9+ / Dart |
| Architecture | Clean Architecture (Domain → Data → Presentation), 21 feature modules |
| State Management | Riverpod 2.4 |
| Backend | Firebase (Auth, Firestore, Storage, Analytics, Functions) |
| Local Storage | Hive — offline-first, < 10ms writes |
| Monetization | RevenueCat (purchases_flutter 8.10+, purchases_ui_flutter 8.11+) |
| AI / ML | Google ML Kit (ingredient scanning), Google Gemini AI (video/recipe extraction, weekly plan generation) |
| PDF Import | PDF parsing + structured recipe extraction |
| Navigation | go_router 13.0 with deep linking |
How RevenueCat Powers FlavorPlan
RevenueCat is the backbone of our monetization, powering a 3-tier subscription model:
| Free | Premium ($9.99/mo) | Family ($19.99/mo) | |
|---|---|---|---|
| Recipe Library | 50% | 100% (1000+) | 100% |
| Custom Recipes | Max 10 | Unlimited | Unlimited |
| AI Weekly Meal Plan | ❌ | ✅ | ✅ |
| AI Ingredient Scanner | Limited | Unlimited | Unlimited |
| Allergy Filters | Basic | Advanced | Advanced |
| Calorie & Nutrition Tracking | ❌ | ✅ | ✅ |
| Auto Shopping Lists | Basic | Full (week plans) | Full (week plans) |
| Cloud Sync | ❌ | ✅ | ✅ |
| Ad-Free | ❌ | ✅ | ✅ |
| PDF/Video Import | ❌ | ✅ | ✅ |
| Family Profiles | ❌ | ❌ | Up to 5 users |
| Nutrition Coaching | ❌ | ❌ | ✅ |
RevenueCat integration:
- SDK initialized at app startup with entitlement-based access control
premiumandpremium_familyentitlements gate features throughout the app- Native RevenueCat paywall UI for frictionless subscription flow
- Restore purchases for seamless device transitions
- Premium gate widgets in every feature module
Challenges We Faced
- AI meal plan generation — generating coherent, nutritionally balanced 7-day plans that respect allergies, dietary preferences, and calorie goals required extensive prompt engineering with Gemini
- Ingredient scanner accuracy — ML Kit food labeling needed careful confidence threshold tuning and food-keyword filtering to avoid false positives on non-food items
- Video-to-recipe extraction — parsing unstructured video/transcript content into structured recipe entities (ingredients with quantities, step-by-step instructions) with Gemini
- Offline-first sync — designing a conflict-resolution strategy between Hive local storage and Firestore cloud backup that never loses user data
- RevenueCat configuration — precisely matching StoreKit product IDs across RevenueCat dashboard, App Store Connect, and the Flutter codebase
What We Learned
- RevenueCat simplifies subscription complexity enormously — entitlement-based access control is far cleaner than managing raw StoreKit receipts
- Local-first is king for UX — users notice when an action takes > 100ms; Hive gives us < 10ms writes
- AI features are the differentiator — the ingredient scanner and AI weekly planner are what make users say "wow"
- Allergy/dietary filtering must be bulletproof — users with real allergies depend on accurate exclusion
What's Next
- Grocery store API integrations with real-time price comparison
- Social features — follow other cooks, share recipes, community collections
- Smart kitchen device integration
- Voice-guided cooking mode
✏️ Built with
Flutter, Dart, Firebase, RevenueCat, Google Gemini AI, Google ML Kit, Riverpod, Hive, Cloud Firestore, Firebase Auth, Clean Architecture
✏️ Short Summary
FlavorPlan is an AI-powered cooking companion that scans your fridge ingredients, generates personalized weekly meal plans, imports recipes from videos and PDFs, tracks calories across multiple dates, respects allergies and dietary preferences (vegan, gluten-free, etc.), and auto-creates shopping lists — all monetized through RevenueCat subscriptions with Free, Premium, and Pro tiers.
Log in or sign up for Devpost to join the conversation.