Travel Mate - Your Personal Travel Companion

Overview

Travel Mate is a modern and user-friendly Android app designed to assist travelers in planning, organizing, and documenting their trips seamlessly. The app allows users to create travel itineraries, manage journals with notes and media, and access weather forecasts and navigation assistance using Google Maps API.

Features

• User Authentication (Firebase Authentication)
• Trip Planning (Google Maps API for source/destination selection)
• Travel Journal (Add notes, images (video coming soon) and locations)
• Offline Access (Stores data locally using Firebase Firestore caching)
• Profile & Settings (User preferences and account management)
• Simple & Intuitive UI (Dual-tone design with Material UI components)

Tech Stack

• Programming Language: Java (Android Studio)
• Database: Firebase Firestore
• Authentication: Firebase Authentication
• Cloud Storage: Firebase Storage (for media uploads)
• APIs Used:
  • Google Maps API (Navigation & Location)
  • OpenWeather API (Weather Forecasts)
  • Firebase Firestore (Database)

Minimum Requirements

• Android 8.0 (API Level 26)
• Android Studio (Latest Version)
• Google Play Services Installed

Setup & Installation

1. Clone the repository:

   git clone https://github.com/yourusername/TravelMate.git
   cd TravelMate

2. Open the project in Android Studio
3. Configure Firebase:
   • Create a Firebase project in the Firebase Console.
   • Download google-services.json and place it in app/ directory.
4. Enable Google Maps API:
   • Go to Google Cloud Console
   • Enable "Maps SDK for Android"
   • Get API Key and add it to AndroidManifest.xml:

     <meta-data
         android:name="com.google.android.geo.API_KEY"
         android:value="YOUR_API_KEY" />

5. Run the project:
   • Connect an Android device or use an emulator.
   • Click Run ▶️ in Android Studio.

Release

• check out in release section

Contributing

• Feel free to fork the repo and submit pull requests!
• Report issues or suggest new features in the Issues section.

License

⚖️ License & Usage Terms © 2025 Parth Mahadik. All Rights Reserved.

This project and its source code are protected under a Custom License:

❌ You may NOT copy, publish, distribute, upload, or post this code (in full or in part) on any public or private platform without explicit written permission from the author.

🧩 Usage is strictly limited to local testing, learning, and evaluation purposes only.

🚫 Commercial, academic, or public redistribution is prohibited.

⚙️ You may run, test, or modify the project on your local machine for personal learning only.

⚖️ Any violation will be treated as a copyright infringement under applicable law.

For special permissions or collaborations, contact the author at parthsmahadik12027@gmail.com.

🚀 Happy Traveling with Travel Mate! 🚀