Grid is a secure, end-to-end encrypted (E2EE) location sharing application integrated with the Matrix Protocol. Built using Flutter, Grid provides a privacy-focused solution for sharing your location with trusted contacts.
| 🔒 End-to-end encrypted | Location data is encrypted on your device. The server stores ciphertext it cannot read. |
| 🌐 Built on Matrix | Secure, decentralized transport and storage over the Matrix protocol. |
| 📍 Real-time sharing | Share live location with a person or a group, and revoke it at any time. |
| 🎛️ Fine-grained control | You choose who sees you, and for how long. Toggle sharing off whenever you want. |
| 📱 iOS and Android | One Flutter codebase, native builds for both platforms. |
| 🏠 Self-hostable | Run your own backend server and map tile provider for complete control. |
Join our Discord to submit feature requests, vote on new features, report bugs, get help, and connect with the community & developers!
Grid is free, open source, and funded by the people who use it. If it is useful to you, you can help keep the servers running:
This repository is for the Grid: Private Location Sharing mobile application (iOS/Android). If you are looking to self host a server for the app, check out our docs or join our Discord!
If you wish to develop/contribute PRs to application, follow the steps below:
Before you begin, ensure you have the following installed:
- Flutter SDK: Install Flutter
- Android Studio: Download Android Studio
- Xcode (for iOS development): Install Xcode
- CocoaPods (for iOS): Install CocoaPods
git clone https://github.com/Rezivure/Grid-Mobile.git
cd Grid-Mobile
flutter pub get
cp .env.example .env # then edit .env with your API and server URLsPlatform-specific setup
iOS — install the CocoaPods dependencies:
cd ios
pod install
cd ..Android — no additional setup is required.
Running the app
-
Open the cloned repository in Android Studio and make sure your Flutter SDK is configured.
-
Create an Android Emulator or connect a physical device, and confirm it is detected.
-
Build and run:
flutter run
- lib/: Contains the main Flutter application code.
- assets/: Stores images, icons, and other assets.
- pubspec.yaml: Defines the dependencies and assets for the project.
We welcome contributions! To do so, please reference our Contribution Guidelines here!
This project is licensed under the GNU Affero General Public License v3.0 - see the LICENSE file for details.