Grid هو تطبيق آمن لمشاركة الموقع مع تشفير من طرف إلى طرف (E2EE) ومتكامل مع بروتوكول Matrix. تم بناؤه باستخدام Flutter، ويوفر Grid حلاً يركز على الخصوصية لمشاركة موقعك مع جهات الاتصال الموثوقة.

الميزات

• التشفير من طرف إلى طرف (E2EE): جميع بيانات الموقع المشتركة عبر Grid مشفرة لضمان الخصوصية والأمان.
• التكامل مع بروتوكول Matrix: يستفيد Grid من بروتوكول Matrix للاتصال الآمن والتخزين اللامركزي للبيانات.
• متعدد المنصات: تم تطويره باستخدام Flutter، ويعمل Grid بسلاسة على أجهزة Android و iOS.
• مشاركة الموقع في الوقت الفعلي: شارك موقعك في الوقت الفعلي مع الأصدقاء أو المجموعات، مع تحكم دقيق في من يمكنه رؤية موقعك.
• إمكانية الاستضافة الذاتية: تم تصميم Grid لتمكين المستخدمين من استضافة خادم الخلفية وموفر خريطة التجانب الخاص بهم بسهولة للتحكم الكامل في كيفية المشاركة.

المجتمع

انضم إلى Discord لتقديم طلبات الميزات، والتصويت على الميزات الجديدة، والإبلاغ عن الأخطاء، والحصول على المساعدة، والتواصل مع المجتمع والمطورين!

الاستضافة الذاتية

هذا المستودع خاص بتطبيق Grid: مشاركة الموقع الخاصة (iOS/Android) المحمول. إذا كنت تبحث عن استضافة خادم للتطبيق بنفسك، راجع وثائقنا أو انضم إلى Discord!

البدء مع التطبيق

إذا كنت ترغب في تطوير/المساهمة بطلبات سحب للتطبيق، اتبع الخطوات أدناه:

المتطلبات الأساسية

قبل البدء، تأكد من تثبيت ما يلي:

• Flutter SDK: تثبيت Flutter
• Android Studio: تنزيل Android Studio
• Xcode (لتطوير iOS): تثبيت Xcode
• CocoaPods (لـ iOS): تثبيت CocoaPods

التثبيت

1. استنساخ المستودع:

   root@kitploit:~

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

2. تثبيت التبعيات:

   قم بتشغيل الأمر التالي لتثبيت التبعيات اللازمة:

   root@kitploit:~

   flutter pub get
   

3. إعداد متغيرات البيئة:

   انسخ ملف تكوين البيئة النموذجي وقم بتعديله بعناوين URL المناسبة:

   root@kitploit:~

   cp .env.example .env
   

   قم بتحرير .env لتهيئة عناوين API والخادم.

4. الإعداد الخاص بالمنصة:

   لنظام iOS:

   • انتقل إلى دليل ios/:

     root@kitploit:~

     cd ios
     

   • قم بتثبيت تبعيات CocoaPods:

     root@kitploit:~

     pod install
     

   • عد إلى الدليل الجذر:

     root@kitploit:~

     cd ..
     

   لنظام Android:

تشغيل التطبيق

1. افتح Android Studio:

   • افتح المستودع المستنسخ في Android Studio.
   • تأكد من إعداد Flutter SDK بشكل صحيح في Android Studio.

2. إعداد المحاكي أو الجهاز الفعلي:

   • أنشئ محاكي Android أو قم بتوصيل جهاز فعلي.
   • تأكد من أن الجهاز قيد التشغيل ويتم اكتشافه بواسطة Android Studio.

3. تشغيل التطبيق:

   استخدم الأمر التالي في الطرفية لبناء التطبيق وتشغيله على الجهاز المتصل أو المحاكي:

   root@kitploit:~

   flutter run
   

هيكل المشروع

• lib/: يحتوي على كود تطبيق Flutter الرئيسي.
• assets/: يخزن الصور والأيقونات والموارد الأخرى.
• pubspec.yaml: يحدد التبعيات والموارد للمشروع.

المساهمة

نرحب بالمساهمات! للقيام بذلك، يرجى الرجوع إلى إرشادات المساهمة الخاصة بنا هنا!

الترخيص

هذا المشروع مرخص بموجب رخصة GNU Affero General Public License v3.0 - راجع ملف LICENSE للحصول على التفاصيل.