Grid è un'applicazione sicura per la condivisione della posizione con crittografia end-to-end (E2EE) integrata con il protocollo Matrix. Realizzata con Flutter, Grid offre una soluzione incentrata sulla privacy per condividere la tua posizione con contatti fidati.

Funzionalità

• Crittografia End-to-End (E2EE): Tutti i dati di posizione condivisi tramite Grid sono crittografati per garantire privacy e sicurezza.
• Integrazione con il protocollo Matrix: Grid sfrutta il protocollo Matrix per comunicazioni sicure e archiviazione decentralizzata dei dati.
• Multi-piattaforma: Sviluppato con Flutter, Grid funziona senza problemi sia su dispositivi Android che iOS.
• Condivisione della posizione in tempo reale: Condividi la tua posizione in tempo reale con amici o gruppi, con un controllo granulare su chi può vedere la tua posizione.
• Capacità di self-hosting: Grid è progettato per consentire agli utenti di ospitare facilmente il proprio server backend e il provider di tile mappa per un controllo completo su come condividono.

Community

Unisciti al nostro Discord per inviare richieste di funzionalità, votare nuove funzionalità, segnalare bug, ottenere aiuto e connetterti con la community e gli sviluppatori!

Self Hosting

Questo repository è per l'applicazione mobile (iOS/Android) Grid: Private Location Sharing. Se stai cercando di ospitare un server per l'app, consulta la nostra documentazione o unisciti al nostro Discord!

Per iniziare con l'app

Se desideri sviluppare/contribuire con PR all'applicazione, segui i passaggi seguenti:

Prerequisiti

Prima di iniziare, assicurati di avere installato:

• Flutter SDK: Installa Flutter
• Android Studio: Scarica Android Studio
• Xcode (per sviluppo iOS): Installa Xcode
• CocoaPods (per iOS): Installa CocoaPods

Installazione

1. Clona il repository:

   root@kitploit:~

   git clone https://github.com/Rezivure/grid-frontend.git
   cd grid-frontend
   

2. Installa le dipendenze:

   Esegui il seguente comando per installare le dipendenze necessarie:

   root@kitploit:~

   flutter pub get
   

3. Configura le variabili d'ambiente:

   Copia la configurazione d'ambiente di esempio e modificala con gli URL appropriati:

   root@kitploit:~

   cp .env.example .env
   

   Modifica .env per configurare gli URL dell'API e del server.

4. Configurazione specifica della piattaforma:

   Per iOS:

   • Naviga nella directory ios/:

     root@kitploit:~

     cd ios
     

   • Installa le dipendenze CocoaPods:

     root@kitploit:~

     pod install
     

   • Torna alla directory principale:

     root@kitploit:~

     cd ..
     

   Per Android:

   Non è richiesta alcuna configurazione aggiuntiva.

Esecuzione dell'app

1. Apri Android Studio:

   • Apri il repository clonato in Android Studio.
   • Assicurati che il tuo Flutter SDK sia configurato correttamente in Android Studio.

2. Configura emulatore o dispositivo fisico:

   • Crea un emulatore Android o collega un dispositivo fisico.
   • Assicurati che il dispositivo sia in esecuzione e rilevato da Android Studio.

3. Esegui l'app:

   Usa il seguente comando nel terminale per compilare ed eseguire l'app sul dispositivo connesso o sull'emulatore:

   root@kitploit:~

   flutter run
   

Struttura del progetto

• lib/: Contiene il codice principale dell'applicazione Flutter.
• assets/: Memorizza immagini, icone e altre risorse.
• pubspec.yaml: Definisce le dipendenze e le risorse del progetto.

Contribuire

Accogliamo con favore i contributi! Per farlo, consulta le nostre Linee guida per i contributi qui!

Licenza

Questo progetto è concesso in licenza con GNU Affero General Public License v3.0 - consulta il file LICENSE per i dettagli.