Sanjeevani - Herbal Wellness App 🌿

Discover Natural Health with Smart Herb Recommendations

A complete Flutter application for discovering, learning about, and ordering medicinal herbs. Features intelligent disease/symptom-based recommendations, comprehensive herb information, and secure authentication.

Perfect for hackathons, wellness startups, and herbal commerce platforms.

✨ Key Features

✅ 10 Medicinal Herbs - Turmeric, Ginger, Ashwagandha, Neem, Tulsi, Aloe Vera, Mint, Curry Leaves, Basil, Triphala

✅ Smart Disease/Symptom Search - Type "arthritis" → Get Turmeric. Type "fever" → Get recommendations

✅ Comprehensive Herb Information - Benefits, dosage, usage instructions, prevention tips

✅ Dual Authentication - Email/password signup & Google Sign-In with Firebase

✅ Shopping Cart - Add herbs, manage quantity, place orders

✅ User Profiles - View account info, order history, settings

✅ Beautiful UI - Material Design 3 with modern, clean interface

🚀 Quick Start

5 minutes to get running:

# 1. Install dependencies
flutter pub get

# 2. Setup Firebase (see SETUP_GUIDE.md)
# - Create Firebase project
# - Download google-services.json
# - Place in android/app/

# 3. Run app
flutter run

For detailed setup, see QUICKSTART.md and SETUP_GUIDE.md

📸 App Screens

Login	Home	Search	Details
Email/Google Auth	Herb Grid + Search	Disease Search	Dosage/Usage

💊 Herb Database

Herb	Treats	Search Keywords
Turmeric 🌱	Inflammation, Arthritis	arthritis, pain, inflammation
Ginger 🔥	Digestion, Nausea, Cold	nausea, cold, fever, digestion
Ashwagandha 💤	Stress, Sleep	stress, anxiety, insomnia
Neem 🍃	Skin, Immunity	skin, infection, acne
Tulsi 🌿	Respiratory, Fever	respiratory, fever, cough
Aloe Vera 💚	Burns, Skin	burns, skin problems
Mint 🍃	Digestion, Headache	digestion, headache, nausea
Curry Leaves 🌾	Anemia, Hair	anemia, hair, immunity
Basil 🌿	Antibacterial	bacterial, infection
Triphala 🌰	Detox, Digestion	constipation, detox

🏗️ Architecture

lib/
├── main.dart                    # Firebase initialization, app setup
├── firebase_options.dart        # Firebase configuration
├── models/herb.dart             # Herb data structure
├── services/auth_service.dart   # Firebase authentication
├── screens/
│   ├── login_screen.dart        # Email + Google Sign-In
│   ├── home_screen.dart         # Herb browsing
│   ├── herb_detail_screen.dart  # Full herb information
│   ├── herb_search_screen.dart  # Disease/symptom search
│   ├── cart_screen.dart         # Shopping cart
│   └── profile_screen.dart      # User profile
└── data/herbs_database.dart     # Static herb data

🔐 Authentication

• Email/Password: Complete signup and login with validation
• Google Sign-In: OAuth 2.0 integration with Firebase
• Session Management: Persistent login across app restarts
• User Data: Email, name, profile picture stored in Firebase

🔍 Search Features

Type disease/symptom and get recommendations:

Search: "arthritis" → Turmeric (+ description, dosage, usage)
Search: "fever" → Ginger, Tulsi
Search: "insomnia" → Ashwagandha
Search: "skin" → Neem, Aloe Vera

Or search by:

• Herb name ("turmeric")
• Benefits ("anti-inflammatory")
• Scientific name ("Curcuma longa")

🛒 Shopping Features

• Add herbs from home screen or detail view
• View cart with item count badge
• Manage quantities
• View order total
• Place order (payment gateway ready)

👤 User Profile

• View user information
• Order history
• Favorites (expandable)
• Settings
• Logout

📊 Tech Stack

Component	Technology
Frontend	Flutter 3.38.5+
Language	Dart 3.10.4+
Backend	Firebase
Auth	Firebase Auth + Google Sign-In
Database	Static data (Firestore ready)
Design	Material Design 3

📋 Herb Model

Each herb includes:

- id, name, scientificName
- description
- benefits (List)
- treatsConditions (for disease search)
- dosage
- usage (how to use)
- preventions (tips)
- price
- imageUrl (emoji)

🎯 Use Cases

✅ E-commerce: Herbal product marketplace ✅ Wellness: Natural health information platform ✅ Ayurveda: Ayurvedic herb discovery app ✅ Hackathon: Complete starter template ✅ Educational: Learn about medicinal plants

🔧 Firebase Setup

1. Create project at Firebase Console
2. Enable Email/Password and Google Sign-In authentication
3. Download google-services.json
4. Place in android/app/
5. Update credentials in firebase_options.dart if needed

See SETUP_GUIDE.md for detailed instructions.

🚀 Future Enhancements

• Firestore backend integration
• Order tracking
• Reviews and ratings
• Herb comparisons
• Personalized recommendations
• Dark mode
• Multiple languages
• Payment gateway
• Admin dashboard

📱 Supported Platforms

• ✅ Android
• ✅ iOS
• ✅ Web
• ✅ Windows/Linux (framework ready)

🤝 Contributing

This is a hackathon project. Contributions welcome!

• Add more herbs
• Improve search algorithm
• Enhance UI/UX
• Add new features

📄 Documentation

• QUICKSTART.md - Get running in 5 minutes
• SETUP_GUIDE.md - Complete Firebase setup guide
• Herb Database - All 10 herbs with data

🙋 Support

For issues or questions:

• Check SETUP_GUIDE.md for Firebase errors
• Run flutter clean and flutter pub get
• Check console logs: flutter logs

📝 License

Open source - use freely for personal and commercial projects.

---

Built with ❤️ for natural health and wellness 🌿✨

Questions? See QUICKSTART.md or SETUP_GUIDE.md