पैकेज, रिपॉज़िटरी और ऐप श्रेणियाँ खोजें

GitHub रिपॉज़िटरीPr0nE/trip-brain-app

trip-brain-app

🌍✈️ फ्लटर, गो, और gRPC के साथ निर्मित एक पूरी बैकएंड एआई-चालित यात्रा ऐप, व्यक्तिगत यात्रा सुझाव, समृद्ध जानकारी और ऑफलाइन एक्सेस के लिए। शामिल हों और योगदान दें! 🤝

trip-brain-app प्रोजेक्ट कवर
स्टार
13
फ़ोर्क
1
अंतिम पुश (UTC)
26 अग॰ 2023
प्रोजेक्ट स्थिति
सक्रिय

मूल README

यह अंग्रेज़ी मूल स्नैपशॉट है। नवीनतम सामग्री GitHub पर देखें।

Travel Brain 🌍✈️

Welcome to Travel Brain! Your go-to app for personalized travel suggestions tailored to your interests and dislikes. Get travel notes, historical background, and more!

Features 🌟

  • Travel Suggestions 🗺️: Get destinations that match your vibe.
  • Insightful Information 📚: Learn more about each place.
  • gRPC Communication ⚡: Fast and efficient backend communication.
  • Offline Support 📴: No internet? No problem!

Demo video

https://github.com/Pr0nE/trip-brain-app/assets/25032492/fbfaa7cf-057b-4380-acd9-17a3329fff5c

Architecture 🏗️

This project is organized into three main layers: UI, Data, and Domain. Each layer is in its own package to prevent code mixing.

  • UI Package 🎨: Widgets only, depends on domain.
  • Data Package 💾: Classes that produce domain language.
  • Domain Package 🛠️: Interfaces and models only.
  • App Package 📦: The glue that binds everything.

📝 Upcoming: Detailed article on architecture.

Getting Started 🚀

Prerequisites 🛠️
  • Flutter SDK
  • Docker
  • Firebase project
  • OpenAI API Key
  • Unsplash API Key
  • Google Client ID
API Keys and Client ID Setup 🔑
  1. OpenAI API Key: Required for natural language processing features.
  2. Unsplash API Key: Needed for fetching dynamic travel images.
  3. Google Client ID: For Google Sign-In authentication.
Firebase Setup 🔥

Provide these files for Firebase:

  • android/app/google-services.json
  • lib/firebase_options.dart
  • ios/firebase_app_id_file.json
  • ios/Runner/GoogleService-Info.plist
Step 1: Env Setup 🌱

Rename .env.example to .env and fill it out.

mv .env.example .env

📝 Note: Open .env and complete the variables.

Step 2: Docker Up 🐳

Run this to start Docker containers:

docker compose up -d

🟢 Success: Containers should be running.

Step 3: Flutter Run 🏃‍♂️

Run your Flutter app:

flutter run

Contributing 🤝

We welcome your help! Here's what you can do:

  1. Backend Refactor 🛠️: Assistance needed for refactoring Go code.
  2. Platform Testing 📱: Help needed for iOS and web.
  3. Testing 🧪: Tests are in progress.
  4. UI/UX 🎨: Room for improvement.

License 📄

MIT

Contact 📞

Questions? Reach out to [Mohammad Teimouri](mailto:moshi1376@yahoo.com).

Mohammad GitHub avatar
GitHub लेखक

Mohammad ↗

भाषाएँDartGoSwiftDockerfileJavaShellKotlinObjective-C

Flutter निर्भर घटक

ऐप श्रेणियाँ

अपने प्रोजेक्ट के लिए रिपॉज़िटरी कैसे चुनें?

उपयोग के अनुसार छाँटें, गतिविधि की तुलना करें और अपनाने से पहले मूल प्रोजेक्ट की आवश्यकताएँ जाँचें।

  1. नाम, लेखक या विवरण से खोजें और तकनीकी विषय से परिणाम सीमित करें।
  2. स्टार, फ़ोर्क और हाल के पुश की तुलना करें। स्टार रुचि दर्शाते हैं, गुणवत्ता की गारंटी नहीं।
  3. उपयोग से पहले GitHub पर README, लाइसेंस और Issues जाँचें।

स्रोत और रखरखाव

“A repository is the most basic element of GitHub.”

GitHub Docs — About repositories ↗