Welcome to Feastly!
This guide will walk you through the main features of the app. All your data is stored locally in your browser, so it's completely private.
Manage Meals Tab
This is where you manage your recipe collection.
- Add a New Meal: Fill out the form to add a recipe manually. You can include details like prep time, nutrition, and an image URL.
- Import from Text: Click the "✨ Import from Text" button to paste a recipe from a website or document.
- AI Parsing: This is the default and recommended option. It uses AI to intelligently extract details from the text. This requires a free Gemini API key. Click "Setup AI Parsing" to add your key.
- Basic Parsing: If you disable the AI toggle, the app will use a simpler text parser. It's less accurate but doesn't need an API key.
- Search & Filter: Use the search bar to find meals by name or click the tags (Dinner, Lunch, etc.) to filter your list.
- Edit/Delete: On each meal card, you'll find buttons to View, Edit, or Delete the recipe.
Meal Planner Tab
Create a customized meal plan for the upcoming days or weeks.
- Set Duration: Choose how many days you want to plan for.
- Meals Per Week: Specify how many breakfasts, lunches, and dinners you need each week.
- Options: You can set a daily calorie limit, plan for multiple people, and enable leftovers to reduce cooking.
- Generate Plan: Click the button to create your plan. The app will randomly select from your "enabled" meals that fit the criteria.
View Plan & List Tab
Here you can see your generated plan and the corresponding shopping list.
- Meal Plan: A day-by-day view of your meals. Click on any meal to see the full recipe.
- Shopping List: All ingredients from your planned meals are automatically aggregated and converted into a convenient shopping list.
- Printing: Use the "Print" buttons to get a physical copy of your plan, recipes, or shopping list.
Data Management
In the "Manage Meals" tab, you'll find a Data Management card.
- Download Data: Exports all your meals and your current plan into a single JSON file. This is great for backups!
- Import Data: Lets you import a previously downloaded data file to restore your meals and plan.
