💊 MediFast — Medicine Delivery App

A beautiful, production-ready Flutter medicine delivery app built for portfolio showcase.

---

✨ Features

Feature	Status
Splash Screen with animations	✅
3-Slide Onboarding	✅
Login & Register with validation	✅
Home Screen (search, categories, pharmacies, medicines)	✅
Pharmacy List & Detail	✅
Medicine List with category filters	✅
Medicine Detail with add-to-cart	✅
Cart Screen with quantity management	✅
Checkout Screen (address + payment selection)	✅
Order Success Screen with animation	✅
Order History Screen	✅
Live Order Tracking with animated driver on Google Maps	✅
Bottom Navigation Bar	✅
Riverpod 2.0 state management	✅
Clean Architecture folder structure	✅
Teal/Blue + White medical theme	✅

---

🗂️ Folder Structure

lib/
├── core/
│   ├── constants/       # Colors, strings, sizes, routes
│   ├── theme/           # AppTheme (light)
│   └── routes/          # go_router setup with shell route
├── features/
│   ├── auth/            # Login, Register, AuthProvider
│   ├── home/            # HomeScreen
│   ├── pharmacy/        # PharmacyList, PharmacyDetail
│   ├── medicine/        # MedicineList, MedicineDetail
│   ├── cart/            # CartScreen, CartProvider
│   ├── order/           # Checkout, OrderSuccess, OrderHistory, OrderProvider
│   └── tracking/        # OrderTrackingScreen (Google Maps)
├── models/              # Medicine, Pharmacy, CartItem, Order, AppUser
├── services/            # FakeDataService (mock data)
├── shared/
│   └── widgets/         # AppButton, AppTextField, MedicineCard, PharmacyCard, etc.
├── main.dart
└── app.dart

---

🚀 Getting Started

1. Prerequisites

• Flutter SDK 3.24+
• Dart 3.3+
• Android Studio / VS Code
• A Google Maps API Key

2. Clone & Install

git clone https://github.com/MIKECHITI/medifast.git
cd medifast
flutter pub get

4. Add Fonts

Download Nunito from Google Fonts and place the .ttf files in:

assets/fonts/
  Nunito-Regular.ttf
  Nunito-Medium.ttf
  Nunito-SemiBold.ttf
  Nunito-Bold.ttf
  Nunito-ExtraBold.ttf

5. Create Asset Folders

mkdir -p assets/images assets/icons assets/animations assets/fonts

6. Run

flutter run

---

📱 Demo Login

Use any email + any password (6+ chars). Or tap the Demo Account hint on the login screen.

Email: demo@medifast.com
Password: demo123

---

🛠️ Tech Stack

Layer	Technology
UI Framework	Flutter 3.24+
State Management	Riverpod 2.0 (StateNotifier)
Navigation	go_router 14+
Maps	google_maps_flutter
Local Storage	shared_preferences, hive_flutter
Animations	flutter_animate, animate_do
Page Indicators	smooth_page_indicator
Date Formatting	intl
Unique IDs	uuid

---

🎨 Design System

Token	Value
Primary	#0A9EBF (Teal Blue)
Accent	#00C896 (Mint Green)
Background	#F8FAFB
Font Family	Nunito
Border Radius	8 / 12 / 16 / 20px

---

📸 Screen Flow

Splash → Onboarding → Login/Register
                           ↓
                      Home Screen
                    /     |      \
              Pharmacy  Medicine  Cart
                ↓          ↓       ↓
            Pharmacy    Medicine  Checkout
             Detail      Detail      ↓
                                Order Success
                                     ↓
                               Order Tracking
                               (Live GPS Map)

---

📝 License

MIT License — free to use in your portfolio.

---

Built with ❤️ using Flutter