SymptomPulse FRONTEND

Welcome to the SymptomPulse mobile app repository! This React Native (Expo) application, built with TypeScript, Redux, and NativeWind, offers users an intuitive interface to check possible conditions from symptoms, receive medical insights via the OpenFDA API, manage medications, and access secure user profiles.

Report Bug · Request Feature

---

Table of Contents

1. About The Project
   • Key Features
   • Built With
2. Getting Started
   • Prerequisites
   • Installation and Setup
   • Usage
3. API Documentation
4. Backend Repository
5. License

---

About The Project

SymptomPulse is a mobile application designed to help users monitor their health by checking symptoms and managing medications with ease. Through an intuitive interface and secure data handling, users can select symptoms (e.g., "headache", "fever"), get potential medical condition suggestions via the OpenFDA API, get medication reminders, and view their health history.

Key Features

1. Symptom Checking
   • Select symptoms from a curated list (or custom) and receive potential condition insights using the OpenFDA API.
2. Medication Management
   • Add medications and get reminders, including dosage and timing details.
3. Secure User Profiles
   • JWT-authenticated profiles ensure that user data is safely managed.
4. State Management with Redux
   • Leverages Redux Toolkit with Redux Thunk for efficient and predictable state management.
5. Responsive Design
   • Styled with NativeWind for a clean, modern, and responsive user interface.

(back to top)

---

Built With

This project is built using a modern mobile development stack to ensure high performance and an exceptional user experience:

(back to top)

---

Getting Started

Follow these instructions to set up the SymptomPulse FRONTEND locally for development and testing.

Prerequisites

• Node.js (v22+ recommended)
  Download & Install Node.js
• npm or yarn
  (npm is bundled with Node.js; Yarn is optional)
• Expo CLI
  Install globally via:

  npm install -g expo-cli

Installation and Setup

1. Clone the Repository

   git clone https://github.com/gayanukabulegoda/SymptomPulse-FRONTEND.git

   Navigate to the project directory:

   cd SymptomPulse-FRONTEND

2. Install Dependencies

   npm install

   or

   yarn install

3. Configure API Connection
   Instead of using a .env file, the backend API connection details are maintained in the config.ts file. Update the file with your backend IP address, port, and API version as shown below:

   const IP_ADDRESS = 'Add your IP address here';
   const PORT = '5000';
   const VERSION = 'v1';
   
   export const API_URL = `http://${IP_ADDRESS}:${PORT}/api/${VERSION}`;

Usage

1. Start the Development Server

   expo start

   This command launches the Expo development environment, allowing you to run the app on an emulator or a physical device.

2. Building for Production For creating a production build, refer to the Expo Documentation.

(back to top)

---

API Documentation

For detailed information on API endpoints, request/response formats, and integration guidelines, refer to the official Postman Collection.

Ensure that the backend server is running and properly configured before making API requests.

---

Backend Repository

The backend for SymptomPulse is built with Node.js, Express, TypeScript, and Prisma. For more details, visit the SymptomPulse BACKEND repository:

• SymptomPulse BACKEND

---

License

Distributed under the MIT License. See LICENSE for more information.

(back to top)

---

© 2025 Gayanuka Bulegoda

---