📱 Irchad Aidant – Assistance Module

This repository contains the Assistance part of the Irchad mobile application. Developed using Kotlin and Jetpack Compose, this app is designed to help caregivers assist visually impaired individuals through real-time location sharing.

---

🚀 Getting Started

📥 1. Clone the Repository

First, clone this repository to your local machine:

git clone https://github.com/IrchadX/IrchadAidant.git

🧑‍💻 2. Open the Project in Android Studio

• Launch Android Studio (Hedgehog or later is recommended).
• Select "Open" and navigate to the cloned irchad-aidant folder.
• Wait for Gradle Sync to finish (it should start automatically).

🌐 Network Configuration

🔧 Step 1: Set the Base URL

Update the base URL used to communicate with the backend server.

Path to file:

IrchadAidant/app/src/main/java/com/example/irchadaidant/data/remote/RetrofitInstance.kt

Modify the following line:

private const val BASE_URL = "http://192.168.X.X:3000"

• Replace 192.168.X.X with your local IP address (you can find it via ipconfig or ifconfig).
• This IP must be reachable from your Android device.

💡 Using an emulator? Use this instead:

private const val BASE_URL = "http://10.0.2.2:3000"

🌐 Step 2: Ensure Devices Are on the Same Network

• The backend server and Android device/emulator must be connected to the same Wi-Fi or LAN.
• If they are not, network requests may fail.

▶️ Run the Backend Server

Before using the mobile app, make sure your backend server is up and running.

From your backend project directory, run:

npm run start:dev

Ensure the server listens on port 3000.

✨ Features

• 📍 Live location tracking of the visually impaired user
• 📞 Real-time audio calling between the user and the aidant
• 🔐 Secure and fast local network communication

🧰 Tech Stack

• Language: Kotlin
• UI: Jetpack Compose
• Architecture: MVVM
• Networking: Retrofit
• IDE: Android Studio (Hedgehog+)

🙌 Acknowledgements

This app was developed as part of the Irchad project to improve accessibility and empower helpers to support the visually impaired more effectively.