/TravelPakistan

Primary LanguageKotlin

Travel Pakistan App

Overview

Travel Pakistan is a mobile application that enables users to explore and book various tour packages offered by different tour agencies in Pakistan. The app provides features such as browsing tour packages, booking tours, giving feedback, requesting private tours, and receiving tour suggestions. It is built using Kotlin, Jetpack libraries, Compose, Retrofit, and Hilt, following the MVVM architectural pattern. The backend is powered by a custom Node.js server with a MongoDB database.

Features

  • Explore Tour Packages: Users can browse through a wide range of tour packages uploaded by different tour agencies across Pakistan. Each package includes details such as destination, duration, activities, accommodation, and pricing.

  • Book Tour Packages: Users can select and book tour packages directly from the app. The booking process is smooth and secure, ensuring a seamless experience for users.

  • Feedback and Ratings: Users can provide feedback and ratings for the tour packages they have experienced. This feature helps other users in making informed decisions while selecting their desired tour package.

  • Request Private Tours: Users have the option to request customized and private tour packages according to their specific preferences. They can provide details such as the desired destinations, activities, duration, and group size, and the app will match them with suitable tour agencies.

  • Tour Suggestions: The app uses an intelligent recommendation system to suggest tour packages based on the user's preferences, past bookings, and feedback. This feature enhances the user's experience by providing personalized and tailored recommendations.

Tech Stack

  • Kotlin
  • Jetpack Libraries
  • Jetpack Compose
  • Retrofit
  • Hilt
  • MVVM Architecture
  • Node.js (Backend)
  • MongoDB (Database)

Video Showcase

travel_pak_demo.mp4

Getting Started

To run the Travel Pakistan app locally, follow these steps:

  1. Clone the repository:

    git clone https://github.com/your-username/travel-pakistan.git

  2. Set up the backend server by following the instructions provided in the backend repository.

  3. Open the project in Android Studio or your preferred IDE.

  4. Build the project to resolve dependencies.

  5. Run the app on an Android device or emulator.

Contributing

Contributions to improve the Travel Pakistan app are welcome. If you would like to contribute, please follow these steps:

  1. Fork the repository.

  2. Create a new branch for your feature or bug fix.

  3. Make the necessary changes and additions.

  4. Test the app thoroughly.

  5. Commit your changes and push the branch to your forked repository.

  6. Create a pull request to merge your changes into the main repository.

Please ensure that your contributions adhere to the code style guidelines and maintain high code quality.