パッケージ、リポジトリ、アプリカテゴリを検索

GitHub リポジトリPr0nE/trip-brain-app

trip-brain-app

🌍✈️ Flutter、Go、gRPC を使用して構築されたフルスタックのAI駆動型旅行アプリで、パーソナライズされた旅行の提案、豊富なインサイト、オフラインアクセスを提供します。参加して貢献しましょう!🤝

trip-brain-app のプロジェクト画像
スター
13
フォーク
1
最終プッシュ(UTC)
2023/08/26
プロジェクト状態
公開中

元の 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 ↗