JourneyJolt

AI-Based Trip Planner

Discover personalized itineraries and curated hotel recommendations tailored to your interests. Simplify travel planning with smart suggestions for top destinations and activities, making every trip easy and enjoyable.

Visit Now

Report Bug

JourneyJolt is an AI-based travel planning application designed to make trip planning easier and more efficient. This project leverages artificial intelligence to analyze user preferences and provide personalized recommendations for destinations, accommodations, and activities.

Key features of JourneyJolt include:

• Personalized Recommendations: The AI suggests ideal destinations, hotels, and activities tailored to the traveler’s preferences.
• Automated Itinerary Generation: The app automatically creates a full itinerary that considers factors like travel time and user preferences.

JourneyJolt aims to enhance the travel experience by providing a streamlined, easy-to-use platform for trip planning, designed for both casual travelers and frequent explorers alike.

Built With

This project is built with the following major frameworks, libraries, and services:

Getting Started

Setting up JourneyJolt is simple — just configure your .env file, and you're ready to go!

To get started with JourneyJolt, follow these instructions to set up the project locally on your machine for development and testing.

Prerequisites

Before you begin, ensure you have the following installed:

• Node.js (v16.0 or above) - Download Node.js
• VS Code (Code Editor) - Download VS Code

Services & API Keys Setup

To fully integrate JourneyJolt with third-party services, you'll need to sign up for the following services, configure the required settings, and obtain API keys. Below are the steps for each service:

    VITE_FIREBASE_API_KEY = "your-api-key-here"
    VITE_FIREBASE_AUTH_DOMAIN = "your-auth-domain-here"
    VITE_FIREBASE_PROJECT_ID = "your-project-id-here"
    VITE_FIREBASE_STORAGE_BUCKET = "your-storage-bucket-here"
    VITE_FIREBASE_MESSAGING_SENDER_ID = "your-messaging-sender-id-here"
    VITE_FIREBASE_APP_ID = "your-app-id-here"
    VITE_MEASUREMENT_ID = "your-measurement-id-here"
  

The installation process is straightforward. You can either clone the repository or download the zip file of the code.

Steps to Install and Set Up:

1. Clone the repository or download the ZIP file

   • To clone the repo, run the following command:

     https://github.com/satendra03/trip-planner-by-satendra.git

   • Alternatively, you can download the ZIP file from the repository page and extract it.

2. Open the project folder in a code editor
   Open the folder in your preferred code editor (e.g., VS Code).

3. Set up the .env file
   The main objective is to set up your .env file with the necessary API keys.

   • Follow the steps in the Setup and API Keys section to get the required API keys for Google Cloud, Gemini API, Auth0, and Firebase.
   • After getting the keys, create a .env file in the root of the project and add the required keys like so:

     VITE_GOOGLE_MAP_API_KEY = "your-google-api-key"
     VITE_GEMINI_API_KEY = "your-gemini-api-key"
     VITE_AUTH0_CLIENT_ID = "your-auth0-client-id"
     VITE_DOMAIN_NAME = "your-auth0-domain-name"
     VITE_FIREBASE_API_KEY = "your-firebase-api-key"
     VITE_FIREBASE_AUTH_DOMAIN = "your-firebase-auth-domain"
     VITE_FIREBASE_PROJECT_ID = "your-firebase-project-id"
     VITE_FIREBASE_STORAGE_BUCKET = "your-firebase-storage-bucket"
     VITE_FIREBASE_MESSAGING_SENDER_ID = "your-firebase-messaging-sender-id"
     VITE_FIREBASE_APP_ID = "your-firebase-app-id"
     VITE_MEASUREMENT_ID = "your-firebase-measurement-id"

4. Install required NPM packages
   Once the .env file is set up, install the required NPM packages:

   npm install

5. Run the Project
   After the packages are installed, you can start the development server by running:

   npm run dev

   This will run the project locally and you can access it at http://localhost:5173.

By following these simple steps, you'll have the project up and running in no time!

The roadmap represents the challenges and updates that I plan to implement in the future. As I continue to enhance the project, I encourage you to try completing these tasks as well and contribute to the project. Collaboration is welcome, and feel free to open pull requests with improvements or fixes. Here's what's coming next:

• [x] Set up project environment with API keys
• [x] Add Google Cloud API integration for Maps, Geolocation, and Places
• [x] Add Gemini AI API integration for AI-based content generation
• [x] Set up Auth0 authentication for secure login (including Callback URL setup)
• [x] Add Firebase integration for real-time data storage
• [x] Implement a more user-friendly UI for API Key setup
• [ ] Implement additional functionality for Google Maps (e.g., custom markers)
• [x] Optimize app for mobile devices
• [ ] Implement unit testing for all components
• [ ] Add better error handling for API integrations
• [ ] Multi-language Support
  • [ ] Hindi
• [x] Deploy the project to a cloud platform (e.g., Firebase Hosting, Vercel)
• [ ] Add detailed logging for API requests and responses
• [ ] Implement automatic configuration of environment variables from the UI

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

Or Maybe you can just

If you have an idea or feature that would make this project even better, please feel free to contribute. Whether it's fixing bugs, adding new features, improving documentation, or anything else, your help is welcome!

How to Contribute:

1. Fork the repository
   Click on the "Fork" button at the top of this repo to create a copy of the repository on your own GitHub account.

2. Clone the repo
   Clone your forked version of the repo to your local machine.

   git clone https://github.com/satendra03/trip-planner-by-satendra.git

3. Create your feature branch
   Create a new branch for the feature you're working on.

   git checkout -b feature/your-feature-nam

4. Make your Changes
   Modify the code, add new features, or fix bugs. Don't forget to test your changes!

5. Commit your changes
   Commit the changes you've made with a descriptive message.

   git commit -m 'Add a new feature or fix a bug'

6. Push to your branch
   Push the changes to your forked repo.

   git push origin feature/your-feature-name

7. Open a Pull Request
   Go to the original repo and click "New Pull Request". Select your branch and provide a description of what your changes do. Once you're ready, submit the pull request!

Report Issues and Suggestions

If you encounter a bug or have a suggestion to improve the project, please open an issue on the Issues page. If it's a new feature or improvement, tag it as an "enhancement".

Distributed under the MIT License. See LICENSE.md for more information.

We’d love to hear from you! Whether you have a question, suggestion, or issue to report, feel free to get in touch with us.

Ways to Contact Us:

1. GitHub Issues: You can open an issue directly on this repository for bugs, feature requests, or general inquiries.

   • Open an Issue

2. Email: Reach out to us via email at:

   • satendrakumarparteti.work@gmail.com

3. Social Media:

   • Instagram: @_satendra_03
   • LinkedIn: Satendra Kumar Parteti

4. Buy Me A Coffee:

   • Small Contibution: