Khadra is an Android application that connects volunteers with plant irrigation opportunities, enabling community-driven plant care through scheduling and tracking of watering activities.
- Volunteer Registration: Create accounts and manage volunteer profiles
- Plant Tracking: View plant locations and irrigation requirements
- Watering Scheduling: Schedule and manage watering tasks
- Notifications: Reminders for upcoming watering duties
- Progress Tracking: Monitor plant health and watering history
- Community Map: Interactive map showing plants needing care
- 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/Khadra.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