📱 MediScan – Android Application

A smart medical search & pharmacy locator app built using Android Studio (Java), Firebase Firestore, Retrofit APIs, and RecyclerView.

🚀 Overview

MediScan is an intelligent Android application designed to help users:

Search for medicine details (brand, generic name, purpose)

Locate nearby pharmacies based on city

Save important medicine data

View personal profile

Seamlessly navigate using an intuitive bottom navigation layout

The app is built using clean architecture, multiple fragments, and external REST APIs.

🛠 Tech Stack

Frontend

Android Studio (Java) XML Layouts RecyclerView + Adapters Bottom Navigation View Material Components

Backend / Cloud

Firebase Firestore (User accounts + Saved medicines)

APIs (2 external APIs required by assignment)

OpenFDA Drug API → Used to search medicines by name → Returns brand name, generic name, purpose, etc.

Nominatim (OpenStreetMap Geocoding API) → Finds pharmacies by city → Returns name + address + coordinates → Opens location in Google Maps

Libraries

Retrofit2 (API calls)

Gson Converter

Firebase Firestore SDK

Glide (optional for images)

Material Design Components

📂 Project Structure MediScan/ │ ├── data/ │ ├── FirebaseHelper.java │ ├── api/ │ │ ├── OpenFdaClient.java │ │ ├── OpenFdaService.java │ │ ├── OpenFdaResponse.java │ │ ├── NominatimClient.java │ │ ├── NominatimService.java │ │ └── NominatimResult.java │ ├── ui/ │ ├── LoginActivity.java │ ├── RegisterActivity.java │ ├── MainActivity.java │ ├── fragments/ │ │ ├── SearchFragment.java │ │ ├── PharmaciesFragment.java │ │ ├── SavedFragment.java │ │ └── ProfileFragment.java │ ├── adapters/ │ ├── DrugAdapter.java │ └── PharmacyAdapter.java │ ├── res/ │ ├── layout/xml files │ ├── item layouts │ ├── icons │ └── bottom_nav_menu.xml

🔐 Authentication

The app uses Firebase Firestore to store:

Name

Email

Password (hashed using Base64)

FirebaseHelper.java handles:

User registration

User login

Database save/retrieve operations

Callback interfaces for cleaner code separation

🔎 Search Feature (OpenFDA API) Functionality:

Search any medicine by name

API returns:

Brand name

Generic name

Purpose

Display results using RecyclerView

Save any medicine to Firestore

🗺 Pharmacy Finder (Nominatim API)

Users can:

Enter a city (e.g., "Colombo", "Kandy")

Fetch a list of pharmacies using geocoding

View name + address

Open location directly in Google Maps

📦 Saved Items

A separate fragment displays all saved medicine entries.

🎨 UI & UX

Bottom navigation for easy movement

CardView-based RecyclerView items

Clean, modern layout

Adaptive app icon (MediScan icon)

▶️ How to Run the Project

Clone or download the project

Open in Android Studio

Connect your Firebase project

Add your google-services.json to:

app/

Sync Gradle

Run on emulator or real device (API 24+)

🧪 Testing

Tested on:

Pixel 4 Emulator (API 34)

Samsung A15 5G physical device

No crashes during API fetch or Firebase operations

💬 Viva / Presentation Points

You can confidently say:

“I implemented two external APIs using Retrofit (OpenFDA + Nominatim).”

“I used Firebase Firestore for user accounts and saved medicine data.”

“For UI, I used fragments, RecyclerView, and BottomNavigationView.”

“I separated logic using helper classes and adapters to keep the project modular.”

📘 License

This project is developed as part of an academic assignment for SLIIT / university coursework. Use for learning and educational purposes.

Developer: Imalka Perera

Email: imalkaperera07@gmail.com