JourniQ is a full-stack web application that helps travelers plan their trips effortlessly. Powered by Google Generative AI, it creates smart itineraries, hotel recommendations, cost breakdowns, and more. Built with React, TailwindCSS, Firebase, Amadeus API, Google Places API, and Visual Crossing Weather API.
Frontend:
- React — For building a fast and dynamic user interface.
- TailwindCSS — For modern, responsive, and consistent styling.
- Axios / Fetch API — For making API requests to external services.
Backend & Services:
- Google Generative AI (Gemini) — Generates AI-powered travel recommendations and itineraries.
- Amadeus API — Provides real-time flight search, pricing, and booking options.
- Google Places API — Fetches place details, hotels, and high-quality photos.
- Visual Crossing Weather API — Provides 7-day detailed weather forecasts.
- Firebase Firestore — For persistent storage and retrieval of user trip data.
- Firebase Authentication — For secure user login and authentication via Google OAuth.
- Vercel (Optional) — For serverless deployment of backend API routes.
- 🌍 AI-Powered Travel Plans — Generate personalized travel itineraries and hotel recommendations using Google Generative AI.
✈️ Flight Search (Amadeus) — Find and compare real-time flight options for your chosen destination.- 🏨 Dynamic Place Information — View detailed information and photos of places and hotels using Google Places API.
- 🔍 Explore More Nearby — Discover nearby attractions and points of interest around your chosen destination.
- ☀️ Weather Forecast Integration — Get a 7-day weather forecast to plan your activities better.
- 🔐 User Authentication — Secure login with Google OAuth.
- 🎨 Interactive UI — Clean, user-friendly, and responsive interface designed with TailwindCSS.
- 💾 Data Storage — Save and manage user trips in Firebase Firestore.
- 📅 Travel Itineraries — Daily plans including attractions, timings, and ticket pricing.
- 💰 Estimated Cost Breakdown — Get a clear budget overview with categorized costs (flights, hotels, meals, activities, and total).
- 📄 Itinerary PDF Export — Download your trip plan and cost breakdown as a professional PDF.
Before running the project, make sure you have:
- ✅ Node.js & npm — Installed on your system.
- ✅ Firebase Project — Create a Firebase project and enable:
- Firestore Database
- Google Authentication (for login/signup)
- ✅ API Keys:
- Google Generative AI (Gemini) API key
- Google Places API key
- Amadeus API key (for flight search)
- Visual Crossing Weather API key
- ✅ Vercel / Local Server (Optional) — For deploying serverless API routes.
- ✅ Environment Variables (.env.local) — Store your API keys securely, e.g.:
VITE_GOOGLE_API_KEY=your_google_places_key VITE_GEMINI_API_KEY=your_gemini_key VITE_AMADEUS_API_KEY=your_amadeus_key VITE_WEATHER_API_KEY=your_visualcrossing_key VITE_FIREBASE_API_KEY=your_firebase_key VITE_FIREBASE_AUTH_DOMAIN=your_project.firebaseapp.com VITE_FIREBASE_PROJECT_ID=your_project_id VITE_FIREBASE_STORAGE_BUCKET=your_project.appspot.com VITE_FIREBASE_MESSAGING_SENDER_ID=your_sender_id VITE_FIREBASE_APP_ID=your_app_id VITE_FIREBASE_MEASUREMENT_ID=your_measurement_id