BlueBridge is an Android application designed to help communities in Africa monitor and manage their water wells efficiently. The app facilitates communication between community members, tracks water consumption, and provides real-time information about nearby wells and users.
- Real-time monitoring of water well status
- Track water consumption and usage patterns
- View well locations on an interactive map
- Configure well parameters and settings
- Secure user authentication
- User profiles with customizable roles
- Water needs specification (farming, drinking, livestock)
- Priority-based water allocation system
- Find nearby users and wells
- Built-in compass navigation to wells
- Real-time user online status
- Distance calculations to nearby resources
- Community message board
- Direct messaging between users
- Emergency alerts for well issues
- Water needs coordination
- Theme customization (Light/Dark/System)
- Language settings
- Location permissions management
- Profile customization
- Android 7.0 (Nougat) or higher
- Gradle 8.11.1
- Kotlin 1.9.x
- Android Studio Arctic Fox or newer
- MVVM (Model-View-ViewModel) architecture
- Kotlin Coroutines for asynchronous operations
- Jetpack Compose for UI
- Hilt for dependency injection
- Kotlin Serialization for data handling
- Implemented a basic server to connect from anywhere (always free google EC2 instance for low userbase)
- Implemented a basic user authentication system
- Implemented a basic well monitoring system
- Implemented a basic map system
- Implemented a basic compass system
- Implemented a basic nearby users system
- Implemented a basic SMS message sending ( no internet required )
Go check in the issues of Github to get more infos about what works and what doesn't
- Clone the repository:
git clone https://github.com/Pierrequiroulenamasspamouss/Blue_Bridge/.git-
Open the project in Android Studio
-
Configure the server it has to connect to :
<domain includeSubdomains="true">YOUR-DOMAIN</domain><string name="ProductionServerUrl">http://bluebridge.homeonthewater.com:3000/</string>- Build and run the project:
./gradlew build- Fork the repository
- Create a feature branch
- Commit your changes
- Push to the branch
- Create a Pull Request
This project falls under the restrictions of the Apache 2.0 licensing. Contact me if you want to fork this project, we can find an agreement on that
- Thanks to Pierre Sluse who did all the coding... And fuck you to Joel
- Built with support from the Kanard'eau organization.
For support or queries, please contact:
- Email: pierresluse@gmail.com
or do a request on the gitHub project
- Website: http://bluebridge.homeonthewater.com