MedEase

MedEase is a React Native (Expo) mobile app that helps patients identify medications by scanning barcodes. It looks up drug information from the RxNorm API and presents details with optional text-to-speech playback.

Features

• Scan medication barcodes with the device camera
• Fetch medication name, dosage, purpose, and instructions via RxNorm (NDC lookup)
• Listen to medication details with text-to-speech
• Browse a scan history screen
• Simulate Scan (Dev) — test the scan flow in the iOS Simulator without a camera

Screenshots

Simulator testing (no camera needed)

Tap Start Scanning, then Simulate Scan (Dev) to look up a test medication via RxNorm:

 

Prerequisites

• Node.js (v18+ recommended)
• npm
• Expo Go on a physical device, or Xcode / Android Studio for simulators

Getting Started

# Install dependencies
npm install

# Start the Expo dev server
npm start

iOS Simulator

npx expo start --localhost

In another terminal:

xcrun simctl openurl booted "exp://127.0.0.1:8081"

On the Scan screen, tap Simulate Scan (Dev) to test with NDC 00054001725 (prednisone 10 MG). This button only appears in development builds (__DEV__).

Physical device

• Press i to open the iOS simulator, or a for Android emulator
• Scan the QR code with Expo Go on your phone (requires matching Expo SDK version)

The app needs camera access to scan barcodes on a real device.

Project Structure

App.tsx              # App entry point
src/
  AppNavigator.js    # Screen navigation
  screens/           # Home, Scan, Medication, and History screens
  services/          # RxNorm and Amplify integrations
assets/              # App icons and splash screen
docs/screenshots/    # README screenshots

Tech Stack

• Expo ~51 / React Native
• React Navigation
• RxNorm REST API
• expo-barcode-scanner, expo-speech