Meal Planner

Database initialization in planner.py creates users (username, email, password_hash), meals (name, ingredients text, instructions, prep_time, cook_time, servings, category, user_id, community flag), ingredients (pantry rows with quantity, unit, category, expiry_date), meal_plan (date, meal_id, meal_type, user_id), favorites, and shopping_list (name, quantity, unit, category, is_purchased). The @login_required decorator guards dashboard, meals, ingredients, calendar, friends, and shopping routes.

Meals and pantry The /meals flow lists and adds meals; POST /add_meal persists new recipes; DELETE /delete_meal removes them. Community meals can be copied into “my meals” via /add_to_my_meals. /ingredients handles pantry CRUD with categories (produce, dairy, meat, etc.) and optional expiry for waste tracking.

Calendar and automation /calendar renders the monthly grid; /get_day_meals/<date> and /save_meal_plan load and persist plans. POST /auto_generate_plan randomly assigns saved meals across the month for a starting point. /get_meal_details and related JSON endpoints back modal/detail UI without full page reloads.

Shopping and social /shopping_list shows list rows; POST /generate_shopping_list aggregates ingredients from the current plan; toggle_purchased, mark_as_purchased, and delete endpoints manage checkout state. /friends supports browsing or sharing meal ideas (community-oriented data tied to is_community meals). The UI uses Bootstrap 5 and Font Awesome across templates such as dashboard.html, meals.html, ingredients.html, calendar.html, shopping_list.html, and friends.html.

Entry: python planner.py runs Flask on port 5000 by default (configurable). init_db() runs at import so the schema exists before first request.

Migrations and maintenance: The repo includes database_migrations.py, database_maintenance.py, migrate_db.py, and fix_db.py for evolving the SQLite file beyond the inline CREATE TABLE bootstrap — useful when adding columns or repairing installs.

Deployment: A Procfile is present for Heroku-style hosts; requirements list Flask stack dependencies.