Skip to content

Gitesh/MealPlanner

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

70 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🍽️ Simple Meal Planner

Plan your week, one delicious meal at a time.

Live Demo

Say goodbye to the dreaded "What's for dinner?" question! Simple Meal Planner is your personal meal planning companion that makes weekly meal organisation effortless, fun, and flexible. Whether you're planning for 3 days or a whole week, we've got you covered!


Why You'll Love It

  • Smart Randomisation: Tired of eating the same things? Let our intelligent algorithm surprise you with meal suggestions based on popularity scores.
  • Drag & Drop Magic: Don't like a suggestion? Simply drag and drop any meal from your database to replace it instantly.
  • Instant Shopping Lists: Generate comprehensive shopping lists with one click - complete with calendar integration!
  • Powerful Search: Find meals by name or tags in seconds
  • Your Data, Your Way: Import and export your meal database in JSON or CSV format
  • Beautiful & Responsive: Works seamlessly on desktop, tablet, and mobile devices
  • Lightning Fast: No sign-ups, no servers, runs entirely in your browser!

Getting Started

It's incredibly simple:

  1. Visit: https://gitesh.github.io/MealPlanner/
  2. Explore: The app comes pre-loaded with example meals
  3. Customise: Add your own favourite meals to the database
  4. Plan: Generate a meal plan for 3, 5, or 7 days. Search / filter meals by tag, then drag from the list on the right to replace a meal
  5. Organise: Click the calendar icon to add the meal to your calendar
  6. Shop: Create your shopping list and start cooking!

See It In Action

Main Interface - Your Weekly Meal Hub

The clean, intuitive interface shows your weekly meal plan on the left and your entire meal database on the right. Choose between 3, 5, or 7-day plans and customise them to your heart's content! Watch as dates instantly appear when you toggle the "Show dates" option! Main Interface


Smart Meal Randomisation

Don't like the suggested meals? Just hit that randomise button and watch your entire meal plan transform! The intelligent algorithm uses popularity scores to suggest meals you'll love.


Smart Search & Filtering

Looking for something specific? Use our powerful search to filter by meal names or tags like "Mexican", "Quick", "Vegetarian" - watch the results update in real-time as you type!


Shopping List Generator

One click generates your complete shopping list from your meal plan! Watch as you tick off items you already have, copy the list to your clipboard, or add everything directly to your calendar. Meal prep has never been easier! Shopping List Modal


Easy Meal Management

Adding new meals is a breeze! Watch as we create "Vegetable Curry" - just enter the name, tags, ingredients, and set a popularity score. The meal instantly appears in your database!


Drag & Drop Customisation

Not feeling the suggested meal? No problem! Watch as we drag a meal from the database and drop it to replace any day's meal. It's that simple! Drag and Drop


Key Features

Meal Planning

  • Flexible Plans: Choose 3, 5, or 7-day meal plans
  • Smart Randomisation: Weighted algorithm favours your most popular meals
  • Optional Dates: Toggle date display for your meal plan
  • Instant Refresh: Don't like the plan? Randomise again instantly!

Meal Database

  • Add/Edit/Delete: Full CRUD operations on your meal collection
  • Tag System: Organise meals by cuisine, cooking time, dietary preferences, etc.
  • Popularity Ratings: Rate meals from 0-1 to influence randomisation
  • Search & Filter: Find meals quickly by name or tag
  • Ingredients Tracking: Store ingredient lists for each meal

Shopping Lists

  • Auto-Generation: Creates shopping lists from your meal plan
  • Interactive Checkboxes: Mark items you already have
  • Copy to Clipboard: One-click copy for easy sharing
  • Calendar Integration: Add meals directly to your calendar with ingredients

Data Management

  • Export Options: Download your meals as JSON or CSV
  • Import Support: Upload previously exported data
  • Browser Storage: All data saved locally - your privacy is guaranteed
  • No Account Needed: Use immediately without sign-up

Technical Highlights

Built with modern web technologies for maximum performance and simplicity:

  • Pure Vanilla JavaScript: No frameworks, blazing fast performance
  • CSS3: Beautiful gradients, smooth animations, and glassmorphism effects
  • Local Storage API: Persistent data without servers
  • Drag & Drop API: Native browser drag-and-drop functionality
  • Responsive Design: Mobile-first approach with Flexbox
  • Google Fonts: Poppins font family for clean typography
  • Material Symbols: Modern icon system

💡 Pro Tips

  1. Rate Your Favourites: Set higher popularity scores (0.8-1.0) for meals you love - they'll appear more often in randomised plans!
  2. Use Tags Wisely: Tag meals with cuisines, cooking time (Quick, Slow), dietary needs (Vegetarian, Vegan), or main proteins (Chicken, Fish)
  3. Save Regularly: Export your meal database occasionally as a backup
  4. Plan Ahead: Use the calendar integration to add meals to your schedule days in advance
  5. Batch Ingredients: When adding meals, list all ingredients to get comprehensive shopping lists

Design Philosophy

We believe meal planning should be joyful, not a chore. That's why Simple Meal Planner features:

  • Vibrant Colour Palette: Eye-catching gradients and modern colours
  • Smooth Animations: Delightful micro-interactions throughout
  • Intuitive UX: Everything is where you expect it to be
  • Mobile-First: Designed for thumbs and fingers, not just mice
  • Easy on the Eyes: Balanced contrast and readable typography

Perfect For

  • Busy Families: Plan meals for the whole week in minutes
  • Home Cooks: Keep track of your recipe repertoire
  • Meal Preppers: Organise your weekly prep sessions
  • Students: Budget-friendly meal planning
  • Health Enthusiasts: Track and plan nutritious meals

Contributing

Found a bug? Have a feature idea? Contributions are welcome! Feel free to:

  • 🐛 Report issues
  • ✨ Suggest features
  • 🔧 Submit pull requests
  • ⭐ Star the repo if you find it useful!

Try It Now!

Ready to revolutionise your meal planning?

No installation, no sign-up, just simple meal planning at your fingertips!


Made with lots of good food in mind

Live DemoReport BugRequest Feature

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published