🍽️ Flutter Meals Application

A beautifully crafted Flutter app that lets users explore meal categories, view detailed recipes, apply dietary filters, and save their favorite meals — all with a clean, responsive UI powered by Riverpod state management.

---

📱 Features

• Meal Categories — Browse meals organized into visually rich category cards
• Meal Details — View full recipe details including ingredients and step-by-step cooking instructions
• Dietary Filters — Filter meals by dietary preferences (Gluten-Free, Lactose-Free, Vegan, Vegetarian)
• Favorites — Mark meals as favorites and access them quickly from a dedicated tab
• Smooth Navigation — Seamless screen transitions with bottom navigation and drawer support
• Fade-in Images — Lazy-loaded images with smooth fade transitions using transparent_image
• Google Fonts — Polished typography with custom font styling

---

🛠️ Tech Stack

Technology	Purpose
Flutter	UI Framework
Dart	Programming Language
flutter_riverpod	State Management
google_fonts	Custom Typography
transparent_image	Fade-in Image Loading

---

📂 Project Structure

Flutter-Meals-Application/
├── android/          # Android platform files
├── ios/              # iOS platform files
├── linux/            # Linux desktop support
├── macos/            # macOS desktop support
├── web/              # Web support
├── windows/          # Windows desktop support
├── lib/              # Main Dart source code
│   ├── main.dart     # App entry point
│   ├── models/       # Data models (Meal, Category)
│   ├── screens/      # UI screens
│   ├── widgets/      # Reusable UI widgets
│   └── providers/    # Riverpod state providers
├── test/             # Unit and widget tests
├── pubspec.yaml      # Project dependencies
└── README.md

---

🚀 Getting Started

Prerequisites

Make sure you have the following installed:

• Flutter SDK (Dart SDK ^3.8.1)
• Android Studio / Xcode (for mobile targets)
• A connected device or emulator

Installation

1. Clone the repository

   git clone https://github.com/gopal5587/Flutter-Meals-Application.git
   cd Flutter-Meals-Application

2. Install dependencies

   flutter pub get

3. Run the app

   flutter run

Build for Release

# Android APK
flutter build apk --release

# iOS (requires macOS)
flutter build ios --release

# Web
flutter build web

---

🖥️ Supported Platforms

Platform	Supported
Android	✅
iOS	✅
Web	✅
Windows	✅
macOS	✅
Linux	✅

---

📦 Dependencies

dependencies:
  flutter_riverpod: ^2.6.1   # State management
  google_fonts: ^6.2.1        # Custom fonts
  transparent_image: ^2.0.1   # Fade-in images
  cupertino_icons: ^1.0.8     # iOS-style icons

---

🤝 Contributing

Contributions are welcome! To contribute:

1. Fork the repository
2. Create a new branch (git checkout -b feature/your-feature)
3. Commit your changes (git commit -m 'Add your feature')
4. Push to the branch (git push origin feature/your-feature)
5. Open a Pull Request

---

📄 License

This project is open-source and available under the MIT License.

---

👤 Author

gopal5587

• GitHub: @gopal5587

---

Built with ❤️ using Flutter