🚀 Map Action Mobile is an application used by citizens to report incidents. Users can capture a photo of the incident and, if they wish, provide a title, description, a 5-second video, and an audio recording. Geolocation is enabled in real-time.

Upon reporting, our AI-powered prediction model is immediately activated to detect the type of incident, its potential impact, context, and possible solutions for resolution.

Citizens can track the progress of their reported incidents through the mobile app

Access the complete project documentation here: Developer Documentation

This app leverages a modern tech stack for performance and efficiency:

• React Native for mobile app development.
• Expo for managing native features easily.
• Django REST Framework for backend APIs.
• PostgreSQL as the database.

1. Incident Capture: Take a photo of the incident directly from the app.
2. Add Content: Add a voice note to describe the situation and attach an explanatory video.
3. Automatic Geolocation: Incidents are geolocated automatically for precise documentation.
4. Collaboration: Multiple users or organizations can collaborate on the same incident.

Before getting started, make sure you have the following:

• Node.js v18 or later (use nvm to manage Node.js versions).
• Expo CLI for handling native features.

git clone https://github.com/223MapAction/Map-Action-Mobile-App.git

• Using npm:

npm install

• Using Yarn/Expo:

yarn upgrade
# or
npx expo install

Ensure you have your .env files set up correctly to manage API keys and environment variables.

• Using npm:

npm run android
npm run ios

• Using expo:

npx expo start
# or
npx expo run:android
# or
npx expo run:ios

We recommend using Visual Studio Code with the following extensions:

• ESLint for real-time code analysis.
• Prettier for automatic code formatting

This project is licensed under the GNU General Public License v3.0 - see the LICENSE file for details.

Map Action is an open source project. Fell free to fork the source and contribute with your features. Please follow our contribution guidelines.