Healthify

Dec 21, 2025Β·
Cayden Miguel Theseira
Cayden Miguel Theseira
,
Jethro
Β· 3 min read
Image credit: Me
Table of Contents
GitHub Logo GitHub Repository for Healthify

Overview

Healthify is an Android app built with Flutter (Material 3) that makes healthcare access more convenient through:

  • an AI Health Assistant (Google Gemini),
  • clinic discovery via maps and location services,
  • and a streamlined appointment booking experience.

Built by Jethro and I for our Mobile Computing Project (Year 3, Computer Engineering Specialisation).


Slides

Healthify by caydenmtheseira

Problem

Finding clinics, understanding what service you need, and booking appointments often requires:

  • switching between apps or websites,
  • searching unfamiliar clinic details,
  • and navigating unclear booking flows.

Healthify consolidates these steps into a single, user-friendly workflow.


Key Features

πŸ€– AI Health Assistant (Gemini)

  • Natural chat interface for health-related questions
  • Supports image uploads for AI-powered analysis and insights
  • Maintains conversational context for more useful follow-ups
  • Helps infer booking intent from user inputs

πŸ“… Appointment Booking

  • Guided booking flow with service categories, time selection, and notes
  • Stores bookings and history in Firebase Firestore
  • Sends email confirmations using Resend API

Service Categories

  • Doctor Consultation
  • Vaccination
  • Screening & Tests
  • Nursing Services
  • Allied Health
  • Dental

πŸ—ΊοΈ Clinic Discovery & Maps

  • Interactive map built on OpenStreetMap
  • Finds nearby clinics using GPS and distance calculations
  • Clinic cards with quick actions (save / book)

πŸ‘€ User Accounts & Profiles

  • Authentication via Firebase Authentication
  • Profile management (e.g., name, age, contact details)
  • Profile pictures uploaded through Cloudinary

Tech Stack

  • Frontend: Flutter 3.6.0+ (Material Design 3)
  • State Management: Provider
  • Backend: Firebase Authentication, Firestore
  • AI: Google Gemini API
  • Maps & Location: flutter_map, OpenStreetMap, geolocator, Geoapify
  • Email: Resend API
  • Media: Cloudinary

My Role

I focused on building and integrating core mobile features across UI and functionality:

  • Implemented Material 3 UI theming and screen layouts
  • Built map and location-based clinic discovery (markers, distance logic, UI cards)
  • Developed appointment booking workflows and Firestore integration
  • Integrated the Gemini AI assistant into the chat experience
  • Supported testing, bug-fixing, and performance improvements across the app

Getting Started

  1. Clone the repository:
git clone https://github.com/yourusername/Healthify.git
cd Healthify
  1. Install dependencies:
flutter pub get
  1. Create a .env file:
GEMINI_API_KEY=your_gemini_api_key_here
GEOAPIFY_API_KEY=your_geoapify_api_key_here
RESEND_API_KEY=your_resend_api_key_here
  1. Configure Firebase (Authentication + Firestore)

  2. Run the app:

flutter run

Project Structure

lib/
β”œβ”€β”€ models/          # Data models (Clinic, Appointment, User)
β”œβ”€β”€ screens/         # UI screens
β”‚   β”œβ”€β”€ health_assistant.dart
β”‚   └── make_appointments_screen.dart
β”œβ”€β”€ utilities/       # Helper functions and Firebase calls
β”œβ”€β”€ widgets/         # Reusable UI components
└── main.dart        # Application entry point

Outcome

Healthify demonstrates a practical integration of AI, maps, and secure user management to deliver a simple, end-to-end healthcare workflow β€” from asking questions to finding a clinic and booking an appointment.