Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/canopas/group-track-android
An open-source Android app employing MVVM architecture and Jetpack Compose. Enhance family safety with real-time location sharing.
https://github.com/canopas/group-track-android
android android-app android-application datastore firestore firestore-database jetpack-android jetpack-compose jetpack-navigation kotlin location-tracker location-tracking mvvm
Last synced: about 1 month ago
JSON representation
An open-source Android app employing MVVM architecture and Jetpack Compose. Enhance family safety with real-time location sharing.
- Host: GitHub
- URL: https://github.com/canopas/group-track-android
- Owner: canopas
- Created: 2024-01-05T12:35:02.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2024-10-29T10:02:04.000Z (3 months ago)
- Last Synced: 2024-10-29T12:05:49.465Z (3 months ago)
- Topics: android, android-app, android-application, datastore, firestore, firestore-database, jetpack-android, jetpack-compose, jetpack-navigation, kotlin, location-tracker, location-tracking, mvvm
- Language: Kotlin
- Homepage:
- Size: 36.5 MB
- Stars: 59
- Watchers: 1
- Forks: 4
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# GroupTrack - Stay connected, Anywhere!
Enhancing family safety and communication with real-time location sharing and modern UIs.
## Overview
Welcome to GroupTrack, an open-source Android application designed to enhance family safety through real-time location sharing and communication features. GroupTrack aims to provide peace of mind by ensuring the safety of your loved ones and facilitating seamless communication regardless of their location.
GroupTrack adopts the MVVM architecture pattern and leverages Jetpack Compose for building modern UIs declaratively. This architecture ensures a clear separation of concerns, making the codebase more maintainable and testable. Jetpack Compose simplifies UI development by allowing developers to define UI elements and their behavior in a more intuitive way, resulting in a seamless user experience.
## Download App
## Features
GroupTrack is currently in active development 🚧, with plans to incorporate additional features shortly.
GroupTrack ensures your loved ones' well-being with:
- [X] Real-time Location Sharing
- [X] Secure Communication
- [X] Location History with Routes
- [X] Geo-fencing
- [ ] SOS Help Alert
## Screenshots
Create/Join Space
Share Location
Location History
Geofencing
Communication
## Requirements
Make sure you have the latest stable version of Android Studio installed.
You can then proceed by either cloning this repository or importing the project directly into Android Studio, following the steps provided in the [documentation](https://developer.android.com/jetpack/compose/setup#sample).
Click to expand
### Google Maps SDK
To enable the MapView functionality, obtaining an API key as instructed in the [documentation](https://developers.google.com/maps/documentation/android-sdk/get-api-key) is required. This key should then be included in the local.properties file as follows:
```
MAPS_API_KEY=your_map_api_key
```
### Firebase Setup
To enable Firebase services, you will need to create a new project in the [Firebase Console](https://console.firebase.google.com/).
Use the `applicationId` value specified in the `app/build.gradle` file of the app as the Android package name.
Once the project is created, you will need to add the `google-services.json` file to the app module.
For more information, refer to the [Firebase documentation](https://firebase.google.com/docs/android/setup).
GroupTrack uses the following Firebase services, Make sure you enable them in your Firebase project:
- Authentication (Phone, Google)
- Firestore (To store user data)
## Tech stack
GroupTrack utilizes the latest Android technologies and adheres to industry best practices. Below is the current tech stack used in the development process:
- MVVM Architecture
- Jetpack Compose
- Kotlin
- Coroutines + Flow
- Jetpack Navigation
- Retrofit
- Fusion Location Provider
- Google Maps SDK
- DataStore
- Room Database
- Firebase Authentication
- Firebase Firestore
- Cloud Functions
- Google Maps SDK
- Hilt
## Contribution
The Canopas team enthusiastically welcomes contributions and project participation! There are a bunch of things you can do if you want to contribute! The [Contributor Guide](CONTRIBUTING.md) has all the information you need for everything from reporting bugs to contributing entire new features. Please don't hesitate to jump in if you'd like to, or even ask us questions if something isn't clear.
## Credits
GroupTrack is owned and maintained by the [Canopas team](https://canopas.com/). You can follow them on X at [@canopassoftware](https://x.com/canopassoftware) for project updates and releases. If you are interested in building apps or designing products, please let us know. We'd love to hear from you!
## License
GroupTrack is licensed under the Apache License, Version 2.0.
```
Copyright 2024 Canopas Software LLP
Licensed under the Apache License, Version 2.0 (the "License");
You won't be using this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
```