Skip to content

VanXodus305/Medley

Repository files navigation

πŸ’Š Medley - AI-Powered Medical Assistant

Medley Logo

Next.js React TypeScript Tailwind CSS Google Gemini

πŸš€ Find The Medicines You Need - Fast and Easy

An intelligent medical assistant that helps you discover medicines, find nearby pharmacies, and get AI-powered health recommendations.

✨ Live Demo β€’ πŸ“š Documentation β€’ πŸ› Report Bug β€’ πŸ’‘ Request Feature


🌟 Features

πŸ€– AI-Powered Chat Assistant

  • Intelligent Medical Queries: Ask about symptoms, conditions, or specific medicines
  • Google Gemini Integration: Advanced AI responses with medical knowledge
  • Contextual Recommendations: Get personalized medicine and pharmacy suggestions
  • Interactive Chat Interface: Modern, user-friendly conversation experience

πŸ’Š Smart Medicine Discovery

  • Comprehensive Database: 200+ medicines with detailed information
  • Advanced Filtering: Filter by medicine form (Tablet, Capsule, Syrup, Injection, etc.)
  • Interactive Carousel: Smooth, responsive medicine browsing experience
  • Detailed Medicine Cards: Complete information including uses, brands, and dosage

πŸͺ Pharmacy Locator

  • Nearby Shop Finder: Discover pharmacies in your area
  • Real-time Pricing: Compare medicine prices across different shops
  • Distance Calculation: Smart distance formatting (meters/kilometers)
  • Contact Information: Direct access to pharmacy phone numbers

🎨 Modern User Interface

  • Responsive Design: Perfect experience on all devices
  • Smooth Animations: Framer Motion powered interactions
  • Green Health Theme: Calming, medical-focused color scheme
  • Carousel Navigation: Interactive medicine and shop browsing

πŸ“§ Contact & Communication

  • EmailJS Integration: Seamless contact form functionality
  • Professional Email Templates: Styled correspondence
  • Real-time Form Validation: Instant feedback for users
  • Multi-field Contact Forms: Name, email, and message support

πŸ› οΈ Technology Stack

Frontend

Next.js React TypeScript Tailwind CSS

UI Components & Animation

HeroUI Framer Motion React Slick

AI & Backend Services

Google Gemini EmailJS

Icons & Assets

Lucide React FontAwesome React Icons


🎯 Core Components

🏠 Landing Page

  • Hero Section: Compelling introduction with call-to-action
  • Navigation Bar: Smooth scrolling navigation with responsive design
  • Footer: Comprehensive contact information and social links

πŸ’¬ Chat Interface

  • Real-time AI Chat: Powered by Google Gemini 2.5-flash model
  • Medicine Cards Carousel: Interactive display of recommended medicines
  • Shop Cards Carousel: Nearby pharmacy suggestions with pricing
  • Auto-scrolling: Smooth chat experience with automatic scroll-to-bottom
  • Custom Carousel Controls: Previous/Next navigation for card browsing

πŸ“‹ Medicine Catalog

  • Filterable Medicine List: 200+ medicines with form-based filtering
  • Smart Card Design: Visual icons for different medicine forms
  • Responsive Carousel: Adapts to screen size and content count
  • HeroUI Integration: Modern select dropdown for filtering

πŸ₯ Shop Directory

  • Interactive Shop Cards: Detailed pharmacy information
  • Distance Calculation: Smart formatting for user convenience
  • Contact Integration: Direct phone number access
  • Location Display: Clear address and distance information

🌈 Design Highlights

🎨 Visual Design

  • Consistent Green Theme: Health-focused color palette (#4FAA84, #059669, #3C7168)
  • Typography: Clean, readable fonts with proper hierarchy
  • Card-based Layout: Modern, Pinterest-style information display
  • Responsive Grid: Adapts beautifully to all screen sizes

✨ Animations & Interactions

  • Smooth Transitions: 300ms duration for all interactive elements
  • Hover Effects: Subtle scale and shadow transformations
  • Loading States: Professional loading indicators and states
  • Micro-interactions: Delightful user feedback throughout

πŸ“± Mobile Experience

  • Touch-Friendly: Optimized for mobile interactions
  • Responsive Carousels: Adapts slide count to screen size
  • Mobile Navigation: Collapsible menu for smaller screens
  • Thumb-Friendly: Properly sized touch targets

🧠 AI Integration

πŸ€– Google Gemini Features

  • Advanced Medical Knowledge: Trained responses for health queries
  • Contextual Understanding: Interprets symptoms and conditions intelligently
  • Structured Responses: Organized medicine and shop recommendations
  • Real-time Processing: Fast AI response generation

πŸ”§ Smart Data Processing

  • JSON Schema Validation: Ensures consistent AI response format
  • Error Handling: Graceful fallbacks for API failures
  • Type Safety: Full TypeScript integration for reliability
  • Caching Strategy: Optimized performance for repeated queries

πŸ“Š Data Management

πŸ’Ύ Medicine Database

  • 200+ Medicines: Comprehensive catalog with detailed information
  • Multiple Forms: Tablets, Capsules, Syrups, Injections, Eye Drops, etc.
  • Brand Information: Popular brand names and manufacturers
  • Use Cases: Detailed medical applications and conditions

πŸͺ Shop Database

  • 25+ Pharmacies: Local pharmacy network with real data
  • Pricing Information: Competitive pricing across locations
  • Contact Details: Phone numbers and addresses
  • Distance Calculation: Smart location-based sorting

πŸ”§ Developer Experience

πŸ“ Code Quality

  • TypeScript: Full type safety and IntelliSense support
  • ESLint Configuration: Consistent code formatting and best practices
  • Component Architecture: Modular, reusable React components
  • Clean Code: Well-documented, maintainable codebase

πŸš€ Performance

  • Next.js Optimization: Server-side rendering and static generation
  • Turbopack: Lightning-fast development builds
  • Lazy Loading: Efficient resource loading strategies
  • Responsive Images: Optimized media delivery

πŸŽ‰ Getting Started

Prerequisites

  • Node.js 18+
  • npm or yarn package manager
  • Environment variables for EmailJS and Google Gemini API

Environment Setup

Create a .env.local file with:

NEXT_PUBLIC_EMAILJS_SERVICE_ID=your_service_id
NEXT_PUBLIC_EMAILJS_TEMPLATE_ID=your_template_id
NEXT_PUBLIC_EMAILJS_PUBLIC_KEY=your_public_key
GOOGLE_GEMINI_API_KEY=your_gemini_api_key

Quick Start

# Install dependencies
npm install

# Run development server
npm run dev

# Build for production
npm run build

# Start production server
npm start

🀝 Contributing

We welcome contributions! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.


πŸ“œ License

This project is licensed under the MIT License - see the LICENSE file for details.


πŸ™ Acknowledgments

  • Google Gemini AI for providing intelligent medical assistance
  • HeroUI for beautiful React components
  • Lucide React for stunning icons
  • Framer Motion for smooth animations
  • EmailJS for seamless email integration

Built with ❀️ by Team Sahayta

Find The Medicines You Need - Fast and Easy πŸ’Š

About

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 5