Skip to content

Latest commit

 

History

5 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

✈️ AI Travel Itinerary Planner

TypeScript React Netlify License Live Demo

A full-stack AI-powered travel planning app that generates personalized day-by-day itineraries based on your destination, budget, interests, and travel style.


✨ Features

  • 🗓️ Personalized Itineraries — Day-by-day plans for 1 to 30 days
  • 💰 Budget-Aware Planning — All recommendations fit within your total budget
  • 🎯 Interest-Driven — Filter by Culture, Food, Adventure, Nature and more
  • 🏨 Accommodation & Transport — Customize hotel type and travel mode
  • 🆘 Emergency Contacts — Local emergency info included in every plan
  • 📱 Responsive UI — Works on desktop and mobile

🛠️ Tech Stack

Layer Technology
Frontend React 18, TypeScript, Vite, React Router
Styling TailwindCSS, Radix UI, shadcn/ui, Lucide Icons
Backend Node.js, Express 5
AI Perplexity AI API
Serverless Netlify Functions
Testing Vitest

🚀 Quick Start

1. Clone the repo

git clone https://github.com/StreetCoder02/Travel-Itinerary.git
cd Travel-Itinerary

2. Install dependencies

npm install

3. Setup environment variables

cp .env.example .env

Add your keys to .env: PERPLEXITY_API_KEY=your_key_here

4. Start the app

npm run dev

Open http://localhost:8080


📁 Project Structure

Travel-Itinerary/ ├── client/ # React frontend (pages, components, hooks) ├── server/ # Express API routes ├── netlify/ # Serverless functions for deployment ├── shared/ # Shared TypeScript types └── package.json

🔌 API

POST /api/generate-itinerary

{
  "city": "Jaipur",
  "budget": 50000,
  "days": 4,
  "travelers": 2,
  "interests": ["Culture & History", "Food & Dining"],
  "accommodation": "hotel",
  "transportation": "public"
}

🔐 Environment Variables

Variable Required Description
PERPLEXITY_API_KEY Optional For live AI itinerary generation
GOOGLE_MAPS_API_KEY Optional For live place lookups

If keys are missing, the app falls back to internal logic automatically.


🚢 Deployment

Configured for Netlify out of the box:

npm run build

Connect your GitHub repo to Netlify for auto-deploy on every push.


🤝 Contributing

  1. Fork the repo
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Commit changes (git commit -m 'feat: add amazing feature')
  4. Push and open a Pull Request

📝 License

MIT License — see LICENSE for details.


Made with ❤️ by Aniruddha Pratap Singh

⭐ Star this repo if you found it useful!

About

Full-stack AI travel planner that generates personalized day-by-day itineraries based on destination, budget, interests, and travel style

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages