Imaatah is an Android app empowering communities to report road issues and coordinate volunteer efforts to fix them. Connect with local volunteers, track repair progress, and make roads safer for everyone!
- Issue Reporting: Report potholes, debris, or hazards with photos, location, and severity levels.
- Volunteer Hub: Register as a volunteer, manage availability, and join repair teams.
- Task Management: Assign repair tasks, track progress, and organize volunteer schedules.
- Push Notifications: Get alerts for new issues in your area or assigned tasks.
- Progress Tracking: Monitor resolution timelines, volunteer contributions, and community impact.
- Community Map: Visualize reported issues with real-time status updates (reported, in-progress, resolved).
- Jetpack Compose - Modern Android UI toolkit
- Kotlin Coroutines - Asynchronous programming
- ViewModel & LiveData - Lifecycle-aware data management
- Room Database - Local data persistence
- Firebase - Authentication and cloud Datastore (if used)
- Material Design 3 - UI components and theming
- Android Studio Ladybug Feature Drop (2024.2.2)
- Android SDK 33+
- Kotlin 2.0.0
-
Clone the repository
git clone https://github.com/AmaraNecib/Imatah.git
-
Open in Android Studio
- Select "Open an Existing Project"
- Choose the cloned directory
-
Build and Run
- Click the
▶️ Run button in Android Studio - Choose a connected device or emulator
- Click the
not yet
You can see the TPs folder for the tasks description.
We welcome contributions! Please follow these guidelines:
- Fork the repository
- Create a feature branch
git checkout -b feature/your-feature-name
- Commit changes
- Follow Conventional Commits format
- Example:
feat: add user registration screen
- Push and create Pull Request
- Ensure code follows Kotlin style guide
- Include test coverage for new features
- Update documentation when applicable
- Use meaningful variable names
- Follow official Kotlin coding conventions
- Keep composables small and focused
- Use ViewModel for business logic
This project is licensed under the MIT License - see the LICENSE file for details.
For questions or suggestions:
Project Maintainer: [Amara Necib]
GitHub Issues: Create New Issue