Embark on Seamless Journeys: Your Ultimate Trip Planner

Table of Contents

1. About The Project
   • Built With
2. Getting Started
   • Prerequisites
   • Installation
   • Setup Google API Key
3. Contributing
4. Contact

About The Project

There are many ways to plan your next trip; however, none of them offer you the freedom to organize them in a simple and concise way. We wanted to create an app for all those travelers who would like to save their adventures to revisit them later.

Here's why:

• Your time thinking about the next place to visit is important and should not be wasted
• You should have a very intuitive way to check all your planned trips
• You can share it with other users who wish to take the same trip

We want to offer you the best experience to organize all your trips, that's why we are going to keep adding more features in the future and improving what we currently have. You may also suggest changes by forking this repo and creating a pull request or opening an issue.

(back to top)

Built With

Android

• Android Studio
• Kotlin
• Gradle
• MVVM
• Dagger Hilt
• Repository
• Coroutines
• Live Data
• Flow
• Intent
• Room
• Junit
• Datastore Preferences
• Locations

Jetpack Compose

• Android Compose
• Google Map
• Coil
• Animations
• Material 3
• Lottie
• Accompanist-Permissions
• Splash Screen
• Navegation
• Horizontal Pager

Libraries

• Retrofit
• Mockk
• MockWebServer
• Joda Time
• ZXING

(back to top)

Getting Started

Prerequisites

• Android Studio (lastest version)
• Google API Key

Installation

There are a few ways to open the project.

• Android Studio

1. Android Studio -> File -> New -> From Version control -> Git
2. Enter https://github.com/MartinAlbanesi/TripOut.git into URL field and press Clone button

• Command-line And Android Studio

1. Run git clone https://github.com/MartinAlbanesi/TripOut.git command to clone the project
2. Open Android Studio and select File | Open... from the menu. Select the cloned directory and press Open button

Setup Google API Key

3. If you don't have a Google API Key, follow the steps at Google Maps Platform Documentation
4. Enter your API in local.properties

   MAPS_API_KEY = "ENTER YOUR API"

(back to top)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

(back to top)

Contact

• Martín Albanesi - Linkedin - Github - [email protected]
• Gabriel Gomez - Linkedin - Github - [email protected]

Project Link: https://github.com/MartinAlbanesi/TripOut

(back to top)