Skip to content

TripPlanr is a web application designed to help users plan their trips effortlessly. Whether you're looking for the best places to visit, transportation options, or need some travel inspiration through YouTube videos, TripPlanr has got you covered!

License

Notifications You must be signed in to change notification settings

sidinsearch/TripPlanr

Repository files navigation

TripPlanr 🌍✈️

TripPlanr Banner

React 18 TypeScript Tailwind Google Gemini

TripPlanr - AI-Powered Travel Itinerary Generator

Create personalized travel plans for your dream destinations in seconds

⚠️ Important Notice

This repository is NOT open-source software. It is provided solely as a demonstration of the code structure and architecture of the TripPlanr application. The complete, functional version of this application is proprietary and not publicly available.

This repository contains simplified code snippets and mock implementations to illustrate the overall structure of the application. It does not include the full functionality, API integrations, or proprietary algorithms used in the actual TripPlanr application.

🎬 Demo

Demo-Video-Triplanr.mp4

πŸ”— Live Demo

Experience TripPlanr in action: https://triplanr-hosted.onrender.com/

✨ Features

TripPlanr leverages cutting-edge AI technology to create personalized travel itineraries based on your preferences:

🎯 Key Features

  • AI-Powered Itineraries πŸ€–: Generate detailed day-by-day travel plans using Google's Gemini AI
  • Destination Explorer πŸ”: Discover popular and hidden gem locations worldwide
  • Budget Optimization πŸ’°: Plan trips that fit your financial constraints
  • Travel Style Matching 🧳: Customize itineraries based on your preferred travel style
  • Attraction Recommendations πŸ›οΈ: Get personalized suggestions for must-visit places
  • Video Recommendations πŸ“Ή: Watch curated travel videos about your destination
  • Responsive Design πŸ“±: Seamless experience across desktop, tablet, and mobile devices
  • Interactive Maps πŸ—ΊοΈ: Visualize your journey with integrated maps

🧳 β†’ πŸ—ΊοΈ β†’ πŸ“ β†’ ✈️

The multi-step form process for creating personalized itineraries

πŸ› οΈ Tech Stack

TripPlanr is built with modern technologies for optimal performance and user experience:

Frontend

  • React 18 with TypeScript
  • Tailwind CSS for styling
  • Vite for fast development and building
  • React Router for navigation
  • Custom UI Components inspired by shadcn/ui
  • Framer Motion for animations

Backend

  • Node.js with Express
  • API Integrations:
    • Google Gemini API (AI)
    • YouTube API (Travel Videos)
    • OpenTripMap API (Attractions)

Infrastructure

  • Vercel for frontend hosting
  • Railway for backend services
  • MongoDB Atlas for database

πŸ“± Frontend ↔️ πŸ–₯️ Backend ↔️ πŸ€– AI Services

High-level architecture of TripPlanr

πŸš€ Getting Started

This repository contains a simplified version of TripPlanr for demonstration purposes. To run it locally:

# Clone the repository
git clone https://github.com/sidinsearch/TripPlanr.git
cd TripPlanr

# Install dependencies
npm install

# Start the development server
npm run dev

πŸ“ Project Structure

The project follows a modular architecture for maintainability and scalability:

tripplanr/
β”œβ”€β”€ public/               # Static assets
β”œβ”€β”€ src/
β”‚   β”œβ”€β”€ components/       # React components
β”‚   β”‚   β”œβ”€β”€ ui/           # Reusable UI components
β”‚   β”‚   └── ...           # Feature-specific components
β”‚   β”œβ”€β”€ pages/            # Page components
β”‚   β”œβ”€β”€ services/         # API service layer (mocked)
β”‚   β”œβ”€β”€ styles/           # Global styles
β”‚   β”œβ”€β”€ utils/            # Utility functions
β”‚   β”œβ”€β”€ App.tsx           # Main application component
β”‚   └── main.tsx          # Application entry point
β”œβ”€β”€ server.js             # Simplified backend server
└── package.json          # Project dependencies

πŸ“‚ β†’ πŸ“„ β†’ 🧩 β†’ πŸš€

From code organization to production deployment

πŸ—ΊοΈ Roadmap

Future plans for TripPlanr include:

  • Mobile App: Native mobile applications for iOS and Android
  • AI Enhancements: More personalized recommendations based on user history
  • Social Features: Community sharing and rating of itineraries
  • Booking Integration: Direct booking of accommodations and activities
  • AR Features: Augmented reality guides for destinations

πŸ“± Mobile β†’ πŸ€– AI+ β†’ πŸ‘₯ Social β†’ 🏨 Bookings β†’ πŸ” AR

Future development roadmap

Legal Notice

All code and assets in this repository are provided for demonstration purposes only. Unauthorized use, reproduction, or distribution of this code for commercial purposes is strictly prohibited. All rights reserved.



✈️ 🌍 🧳

Made with ❀️ by Siddharth Shinde

Β© 2024 TripPlanr. All rights reserved.

About

TripPlanr is a web application designed to help users plan their trips effortlessly. Whether you're looking for the best places to visit, transportation options, or need some travel inspiration through YouTube videos, TripPlanr has got you covered!

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published