
Project Overview
My Itinerary is AI-driven web application designed to transform how travelers plan their journeys. By leveraging the advanced reasoning capabilities of the Google Gemini AI model, the app generates hyper-personalized, structured, and actionable travel plans tailored to the smallest detail of a user’s preferences.
Core Functionalities
1. Intelligent Itinerary Architect
The heart of the app is a sophisticated prompt-building engine. Instead of generic suggestions, the system constructs a complex, structured request for the AI based on several parameters:
- Geospatial Logic: Defines main destinations and complex multi-stop intermediate routes.
- Temporal Precision: Users specify exact arrival and departure dates/times, allowing the AI to calculate logical durations for each stay.
- Interest-Based Filtering: A multi-select system for categories like Art & Culture, Nature, Adventure, Hidden Gems, Nightlife, and more.
- Gastronomic Customization: Deep filtering for food preferences (Street Food, Fine Dining, Vegan, Gluten-Free) to suggest specific experiences.

2. Travel Style & Persona Modeling
The app adapts its “voice” and planning logic based on user personas:
- Traveler Type: Optimized for Solo Travelers, Couples, Families, Groups, or Business Trips.
- Vibe Selection: Styles range from Relaxed/Slow Travel to Intensive/High-Energy, Luxury, or Budget-Conscious.
- Budgeting: Integrates budget tiers (Low, Medium, High, Luxury) to ensure suggested activities and dining venues align with the user’s financial plan.
3. Advanced AI Processor (Gemini Integration)
- Dynamic Prompting: The app generates a technical “Internal Prompt” that instructs the AI to return data in a strictly structured format while maintaining an engaging narrative.
- Depth Control: Users can toggle between Synthesized (quick overview) and Detailed (deep dives into history, logistics, and insider tips) depth for their itineraries.
- Data Enrichment: Options to include real-time logistics, estimated pricing, time-of-day breakdowns, and external links for bookings and navigation.
4. Cloud Synchronization & Persistence
The app offers robust data management:
- Secure Authentication: Google OAuth integration ensures users can safely access their data across devices.
- Library Management: Users can save their prompts and generated itineraries for future reference. Moreover an instant updates and deletion of saved travel plans.
5. Usage Governance & Performance Monitoring
- Token-Based Limits: An integrated tracking system monitors Gemini API token consumption per user, ensuring fair usage and preventing resource exhaustion.
- Admin Dashboard: Built-in logic for administrative oversight of usage quotas and system health.
User Experience (Workflow)
- Planning: The user fills out a multi-dimensional form representing their “Ideal Trip.”
- Generation: The AI processes the request and generates a day-by-day breakdown (Morning/Afternoon/Evening) including “Insider Knowledge” sections.
- Refinement: Users can copy the generated prompt to further tweak responses or download the result.
- Archiving: Users save the plan to their private cloud library for access during the actual trip.


