group-track-flutter

Grouptrack - Stay connected, Anywhere!

Enhancing family safety and communication with real-time location sharing and modern UIs.

cover

Overview

Welcome to Grouptrack, an open-source Flutter 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 while facilitating seamless communication regardless of their location.

Grouptrack adopts a declarative UI approach with Flutter and utilizes flutter riverpod for state management. This architecture promotes a clear separation of concerns, making the codebase more maintainable, scalable, and testable. Flutter’s widget-based system allows for the creation of highly responsive UIs, while flutter riverpod ensures efficient state handling across different components, leading to a smooth and intuitive user experience.

Download App

</img>

Features

Grouptrack is currently in active development 🚧, with plans to incorporate additional features shortly.

Grouptrack ensures your loved ones’ well-being with:

Create and Join Spaces: Set up your own personalised spaces and invite others to join, or become part of an existing group to stay connected.
Live Location Sharing: Share your real-time location with members of your space, allowing them to follow your journey and stay informed about your whereabouts.
Track Journeys: Whether it’s your own route or someone else’s, track journeys in real-time to ensure smooth navigation and timely arrivals.
Place Notifications: Add specific places within your space, and get notified whenever a member enters or leaves that location, making coordination effortless.
Real-Time Chat: Stay in touch with other space members through built-in chat functionality, enabling you to coordinate, plan, or simply catch up in real-time.

Upcoming Features 🚀

End-to-End Encryption (Coming Soon)

Enhanced privacy and security through robust end-to-end encryption, leveraging the Signal Protocol to ensure your location data remains private and secure.

Planned Security Features:

Industry-standard Signal Protocol integration for secure data transmission
Client-side encryption with AES-256
Zero-knowledge architecture - only group members can access location data
Unique encryption keys per user and space
Secure key exchange protocols

Your location data will be encrypted before leaving your device and can only be decrypted by authorized group members, ensuring complete privacy and protection against unauthorized access.

Screenshots

Create/Join Space	Share Location

Geofencing	Communication

Requirements

Ensure 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.

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 for android and Info.plist for ios file as follows: Android: ``` MAPS_API_KEY=your_map_api_key ``` IOS: ``` ApiMapKey your_map_api_key ``` Note: Set iOS minimum deployment target to 14.0 or higher ### Add config.dart Inside the `data/lib` directory, create a new file named `config.dart`. This file will store your place API key, follow format: ``` class AppConfig { static const String placeApiKey = 'YOUR PLACE 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 `android/app` module for android and `ios/Runner` module for IOS. For more information, refer to the [Firebase documentation](https://firebase.google.com/docs/flutter/setup?platform=android). Grouptrack uses the following Firebase services, Make sure you enable them in your Firebase project: - Authentication (Phone, Google, Apple) - Firestore (To store user data)

Tech stack

Grouptrack utilizes the latest Flutter technologies and adheres to industry best practices. Below is the current tech stack used in the development process:

Flutter Riverpod
Dart
async + Stream
Go Router
SQLite
Freezed
Firebase Authentication
Firebase Firestore
Cloud Functions
Google Maps Flutter

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 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. You can follow them on X at @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.