Itinerarly is an AI-powered travel planning application that helps you create perfect itineraries for exploring India. Born from the frustration of indecisive group travel planning, this tool leverages AI to make travel planning effortless and enjoyable.
- you can write about the exact place you wanna go for the number of days and number of people , we will generate you an itinerary about and around that place
- you don't know where exactly to go but you know which month you gonna go with how many people and your budget , again we can help you generate a itinerary based on your budget and time duration
- you wanna visit a state , you can click on that state and we can tell you that particular indian state's cuisine , safety and the places to visit of that state.
- if you click on the dropdown , it will tell you the various wild life sanctuaries , hill stations , beaches , cities of this beautiful country . click on the selected destination, click on show details and we can show you the details of that particular place along with it's current weather .
I sincerely hope you enjoy the stay and visit of this beautiful country and your safety and security is maintained throughout. :D
itinerarly.mp4
- 🗺️ Interactive India Map with react-simple-maps visualization
- 🤖 AI-Powered Recommendations using Google's Gemini API
- 🏛️ 1000+ Curated Destinations across India (Hill Stations, Historical Sites, Beaches, Wildlife Sanctuaries)
- 📱 Modern Responsive UI with Tailwind CSS and shadcn/ui
- ⚡ Fast & Type-Safe with Next.js 14 and TypeScript
- 🌤️ Weather Integration for destination planning
- 🏨 Smart Suggestions for accommodations and attractions
- Framework: Next.js 14 with App Router
- Language: TypeScript 5.0+
- Styling: Tailwind CSS + shadcn/ui
- Maps: react-simple-maps
- AI: Google Gemini API
- State Management: Zustand
- Testing: Vitest & React Testing Library
Itinerarly features 1000+ carefully curated destinations across India:
- 🏔️ Hill Stations: Mountain retreats from Himalayas to Western Ghats
- 🏛️ Historical Sites: UNESCO sites, monuments, forts, and cultural landmarks
- 🏖️ Beaches (150+): Complete coastal coverage including islands (Lakshadweep, Andaman & Nicobar)
- 🦌 Wildlife Sanctuaries (100+): National parks across all biogeographic regions
Complete Coverage: All 28 states and 8 union territories with verified, up-to-date information.
📍 View Database: Tourist Destinations (sections.js) | Map Data (india-geoJson.json)
- Node.js 18.17+
- npm 9+ or yarn 1.22+
- Google Gemini API key (Get it here)
# Clone and install
git clone https://github.com/yourusername/itinerarly.git
cd itinerarly
npm install
# Set up environment
echo "GEMINI_API_KEY=your_api_key_here" > .env.local
# Start development
npm run devVisit http://localhost:3000 to start planning!
📖 Need help? Check our Contributing Guide for detailed setup instructions.
itinerarly-FE/
├── app/ # Next.js app directory
│ ├── (routes)/ # Application routes
│ └── start/india-geoJson.json # Map data
├── components/ # React components
│ ├── ui/ # shadcn/ui components
│ ├── IndiaMap.tsx # Interactive map
│ └── StateDetailsModal.tsx # AI recommendations
├── data/sections.js # 1000+ destinations database
├── lib/ # Utilities & API handlers
└── types/ # TypeScript definitions
- Interactive Map: Click any state for detailed destination info
- AI Recommendations: Smart travel suggestions via Google Gemini
- Destination Database: 1000+ curated locations with regular updates
npm run dev # Start development server
npm run build # Build for production
npm run test # Run tests
npm run lint # Code linting| Variable | Description | Required |
|---|---|---|
GEMINI_API_KEY |
Google Gemini API Key | ✅ |
NEXT_PUBLIC_API_URL |
Backend API URL | ❌ |
- Contributing Guide - Setup, development workflow, and contribution guidelines
- Future Roadmap - Upcoming features and long-term vision
- Troubleshooting - Common issues and solutions
We welcome contributions! Please check our Contributing Guide for:
- Development setup instructions
- Coding standards and best practices
- How to submit pull requests
- Testing requirements
- ✅ 500+ New Destinations across all categories
- ✅ Complete Island Coverage (Lakshadweep, Andaman & Nicobar)
- ✅ 100+ Wildlife Sanctuaries added
- ✅ Enhanced UI/UX with improved error handling
- ✅ All States Covered - comprehensive data for 28 states + 8 UTs
Exciting features coming soon! Check our Future Plans for:
- 🤖 Advanced AI personalization
- 💬 Social travel planning & group chat
- 📱 Mobile apps (iOS/Android)
- 💰 Premium features & token system
- 🌍 International destinations
- 🐛 Report Issues
- 💡 Feature Requests
- 📧 Contact Us
- ⭐ Star on GitHub to stay updated
Special thanks to Udit-001 for the comprehensive Indian geographic data compilation.
MIT License - see LICENSE file for details.
Made with ❤️ for Indian travelers | Start Planning Your Next Adventure →