Travel Assistant
OpenClawd Operator Adaptation
Run this skill as part of the OpenClawd operator deck. Preserve the skill-specific workflow below, but frame outputs for Solana-native agents when relevant: prefer OpenClawd language, note whether the work can support autonomous agent operations, and keep financial, legal, tax, hiring, medical, or other regulated outputs informational unless the skill already requires a stricter disclaimer. Use the Llobster Legend persona only as light operator framing; do not let branding override accuracy, safety, or the user's stated domain.
Build comprehensive travel planners tailored to the user's needs. This skill ensures the agent gathers all necessary information before building, chooses the right output format, and includes essential features from the start. It also covers practical travel knowledge — flights, entry requirements, pacing, and budgeting.
When to Use
Itinerary building, flight/accommodation strategy, budget estimation
"What do I need to enter [country]?" — visa/vaccine/ETIAS checks
Building interactive trip planning web apps
When NOT to Use
- Booking (can't transact); travel insurance (insurance-optimizer)
Step 1: Ask Output Format First
Before building anything, ask the user what format they want:
Interactive website — Best for browsing, exploring options, and sharing with travel companions. Can include maps, filters, and selection tools.
PDF report — Best for offline use, printing, and taking on the trip. Clean, formatted document.
Excel/spreadsheet — Best for budget-focused planning, collaborative editing, and people who prefer tabular data.
Combination — e.g., a website with PDF export (most common for serious trip planning).
Step 2: Gather Trip Details
Collect these essentials before generating any content:
Where are you traveling from? (origin city/airport — required for flight search)
Dates and duration — When and how long (or flexible?)
Destinations / regions — Specific cities, or open to suggestions?
Group size and composition — Number of adults, children, babies, elderly. This directly affects activity recommendations, restaurant choices, and accessibility needs (stroller-friendly, wheelchair access, etc.)
Travel style — Budget, mid-range, luxury, or mixed
Priorities — Food-focused, adventure, culture, relaxation, nightlife, nature, family fun
Must-dos and must-avoids — Any specific places, activities, or experiences they want or want to skip
Pace preference — Packed schedule vs. slow and relaxed
Dietary needs — Allergies, vegetarian, etc. (affects restaurant recommendations)
Do NOT search for flights without knowing the origin city — you will get it wrong.
Step 3: Content Depth
Ask how detailed they want the plan:
High-level outline — Day-by-day overview with main activities
Detailed recommendations — Specific restaurants, activities, alternatives, prices, links, and booking info
Full concierge — Everything above plus rain plans, backup options, and curated picks
Entry Requirements — Check Before Anything Else
Getting this wrong ends the trip at the airport. webSearch every time — rules change.
| Check | Source | Notes |
|-------|--------|-------|
| Visa requirements | travel.state.gov(US citizens) or[passport country] [destination] visa requirements | |
| Schengen 90/180 (Europe) | ec.europa.eucalculator orschengenvisainfo.com/visa-calculator | 90 days in any rolling 180-day window. Does NOT reset on exit. Count days not months. Entry + exit days both count as full days. Schengen ≠ EU (UK, Ireland out; Switzerland, Norway in) |
| ETIAS (Europe) | etias.com | Pre-authorization now required even for visa-free travelers |
| Passport validity | — | Many countries require 6 months validity beyond your departure date. Check blank pages too (some need 2+) |
| Vaccines | cdc.gov/travel | Yellow fever is mandatory (with certificate) for some countries if arriving from an endemic zone |
| Onward ticket proof | — | Some countries (Thailand, Philippines, Indonesia, Costa Rica, Peru) won't let you board without proof you're leaving |
| Safety advisories | travel.state.gov/content/travel/en/traveladvisories | |
Itinerary Pacing — The #1 Mistake Is Overplanning
Hard limits
Max 1 anchor activity per half-day. One museum in the morning, one neighborhood in the afternoon. Hour-by-hour schedules fall apart by day 2.
Transit tax: every change of location costs 30-60 min more than Google Maps says (finding the entrance, ticketing, getting lost once). Budget it.
Day 1 after a long-haul flight is dead. Plan a walk and an early dinner, nothing with a timed entry.
3-night minimum per city for multi-city trips. 2 nights = 1 real day. Fewer cities, done well, beats a checklist.
One unplanned afternoon per 3 days. The best travel moments are unscheduled.
Cluster by geography — plot everything on a map first, then group by neighborhood. Never cross the city twice in a day.
Known closure patterns
Europe: many museums closed Mondays (Louvre, Prado) or Tuesdays (Italy). Always verify.
Japan: many restaurants/shops closed one weekday (often Mon or Wed). Golden Week (late Apr-early May) = everything packed.
Middle East: Friday is the weekend day; expect closures.
Siesta countries (Spain, Greece, parts of Italy): 2-5pm dead zone outside tourist cores.
Step 4: Build with These Standards
Flights
Search for flights using webSearchwith queries like"Google Flights [origin] to [destination] [dates]","Skyscanner [origin] to [destination] [month]".
Present options with direct links to booking/search pages:
**Option 1: [Airline] — $XXX roundtrip**
- Outbound: [date], [time] [origin] → [time] [dest] (Xh Xm, nonstop/1 stop)
- Return: [date], [time] [dest] → [time] [origin] (Xh Xm, nonstop/1 stop)
- [Google Flights link](URL) | [Book direct with airline](URL)
**Option 2: [Airline] — $XXX roundtrip**
...
Include at least 3 options when possible: cheapest, best schedule, best airline. Note open-jaw options if doing a multi-city trip.
Flight search tools — use multiple, they surface different fares
| Tool | What it's best at |
|------|-------------------|
| Google Flights | Speed; calendar price grid; search up to 7 origin + 7 destination airports at once; price-history graph shows if "now" is cheap |
| Skyscanner | "Everywhere" destination (cheapest places from your airport, sorted by price); "Whole month" date view; surfaces budget carriers Google misses |
| Skiplagged | Hidden-city fares — flight A→C with layover at B is cheaper than A→B, so you get off at B. Savings up to 60%. Constraints: carry-on only (checked bags go to C), one-way only (skipping a leg cancels the rest), don't do it repeatedly on the same airline (they ban accounts) |
| Going.com / Secret Flying | Error fares, mistake prices — time-sensitive |
Booking rules
Find the fare on an aggregator → book direct with the airline. OTAs (Expedia etc.) are useless when flights get cancelled — airline agents will say "call Expedia"
Domestic sweet spot: 1-3 months out. International: 2-6 months. Last-minute is almost always worse except on empty routes
Tuesday/Wednesday/Saturday departures are typically cheapest
Open-jaw (fly into city A, out of city B) via multi-city search — often cheaper than round-trip + ground transport
Hotels / Accommodations
Search using webSearchfor hotels in the destination area with queries like"best hotels [neighborhood] [city] [budget level]","[city] hotels [dates] site:booking.com","[city] airbnb [neighborhood]".
Present options with direct links:
**[Hotel Name]** — $XXX/night | [neighborhood] | [rating] stars
- [Key feature 1], [key feature 2] (e.g., rooftop pool, walkable to old town, free breakfast)
- [Booking.com link](URL) | [Hotel website](URL)
**[Hotel/Airbnb Name]** — $XXX/night | [neighborhood] | [rating]
...
Include 3-5 options spanning the user's budget range. Note the neighborhood and why it's a good base. For multi-city trips, list accommodations per city.
| Platform | Best for |
|----------|----------|
| Booking.com | Widest hotel inventory, free cancellation options, price match |
| Airbnb | Apartments, longer stays, groups, kitchens |
| Hostelworld | Budget/social travelers |
| Hotel direct sites | Loyalty perks, best-rate guarantees |
Day-by-Day Itinerary
Structure each day with anchor activities and restaurant recommendations with links:
## Day X — [Neighborhood/Theme]
**Anchor (AM):** [Activity] — book ahead? y/n — ~$XX — nearest metro: [station]
**Lunch:** [Restaurant name](URL) — [cuisine, 1-line description] — ~$XX/person
**Anchor (PM):** [Activity]
**Dinner:** [Restaurant name](URL) — [cuisine, 1-line description] — ~$XX/person
**Alt dinner:** [Restaurant name](URL) — [backup option]
**Transit:** [A→B method, ~time, ~cost]
**If it rains / you're tired:** [one swap]
**Day est:** $XX
For restaurant links, search with webSearchfor"best [cuisine] restaurant [neighborhood] [city]"or"[city] [neighborhood] restaurants site:google.com/maps". Link to Google Maps, Yelp, or the restaurant's website.
Always Include from the Start
- Links for every venue — Every restaurant, activity, and accommodation must have:
A Google Maps link (mapLink)
A website URL (websiteLink) — use the venue's official site when possible
These should be in the data model from day one, not added later
- PDF/Excel export — If building a website, always include export functionality. Users will want to take their itinerary offline while traveling. Use
jspdf for PDF generation on the client side.
- Booking and availability context — The app should connect to travel platforms for live data where possible, and fall back to deep links when direct integration isn't available:
Target platforms and their capabilities
Accommodations: Booking.com, Airbnb, Expedia, Hotels.com — search availability by dates/location/group size, show prices, ratings, reviews, photos, amenities, cancellation policies
Restaurants: OpenTable, TheFork, Resy — search availability by date/time/party size, show ratings, reviews, cuisine type, price tier, reservation slots
Activities/Experiences: GetYourGuide, Viator, Fever, Klook — search by destination/dates, show availability, prices, ratings, reviews, duration, cancellation policy
Transportation: Trainline, Rome2Rio, FlixBus, local transit APIs — search routes, schedules, prices, duration between destinations
Car Rental: Rentalcars.com, AutoEurope — search by pickup/dropoff location and dates, show vehicle options, prices, insurance
Integration approach (in priority order)
Replit integrations — Check if a Replit integration exists for any of these platforms. If so, use it for direct API access (availability search, reviews, pricing). This is the preferred method.
Direct APIs — If no Replit integration exists but the platform offers a public or partner API (e.g., Booking.com Affiliate API, GetYourGuide Partner API), use it with appropriate API keys stored as secrets.
Web search enrichment — Use web search to find current reviews, ratings, prices, and availability for venues. Parse and display relevant data.
Deep links as fallback — When no API access is available, generate deep links that pre-fill search parameters on the platform:
Booking.com: https://www.booking.com/searchresults.html?ss={destination}&checkin={date}&checkout={date}&group_adults={n}&group_children={n}
Airbnb: https://www.airbnb.com/s/{destination}/homes?checkin={date}&checkout={date}&adults={n}&children={n}&infants={n}
OpenTable: https://www.opentable.com/s?term={restaurant}&covers={n}&dateTime={datetime}
GetYourGuide: https://www.getyourguide.com/s/?q={activity}&date_from={date}&date_to={date}
Expedia: https://www.expedia.com/Hotel-Search?destination={destination}&startDate={date}&endDate={date}&rooms=1&adults={n}
Data to surface from these platforms when available
Availability status (available / sold out / limited)
Price range and specific pricing
User ratings and review count
Photos
Cancellation/refund policy
Key amenities or highlights
Booking confirmation status
Important: Always check for new Replit integrations before falling back to deep links. The integration landscape evolves — what isn't available today may be available tomorrow.
Persistent state — Selection state (which items the user picks) should survive page refresh. Use localStorage at minimum, or a lightweight backend for sharing.
Mobile-first design — Trip planners are most useful on phones while traveling. Design mobile-first with responsive breakpoints. Consider PWA features for offline access.
Collaborative features — For group trips, consider:
Shareable links
Voting/favoriting on options
Comments on activities
At minimum, make the plan easy to share (PDF export, copy link)
Web App — Map + Itinerary
Always build a web app that combines two views the user can switch between:
- Map view — all locations plotted on an interactive map with color-coded markers by type (airports, hotels, activities, restaurants). Each marker has a popup with name, time, and links. Connect same-day stops with route lines so the user can see the flow.
- Itinerary view — a beautiful, card-based day-by-day layout. Each day is a card with the day number, neighborhood/theme, and a timeline of activities, meals, and transit. Include photos or icons for each stop, estimated costs, and direct links to book or learn more.
Use the Nominatim API (OpenStreetMap) for geocoding addresses to lat/lng — no API key required.
The user should be able to toggle between map and itinerary views. Clicking a day in the itinerary should highlight that day's markers on the map.
AI-Powered Recommendations
Use AI integrations to generate smarter, personalized content rather than relying solely on hardcoded data:
Destination research — Use an AI model to research destinations based on the user's preferences (travel style, group composition, interests) and generate tailored restaurant, activity, and accommodation suggestions.
Seasonality awareness — Factor in the time of year when recommending activities. Suggest outdoor markets and harvest festivals in fall, ski resorts in winter, beaches and hiking in summer, cherry blossoms in spring. Flag activities that may be closed or less enjoyable in the chosen season.
Personalization — Adjust recommendations based on group composition. A trip with babies should emphasize stroller-friendly paths, early dinner reservations, and nap-friendly schedules. A trip with adventurous adults should prioritize hikes, wine tours, and late-night dining.
Local events — Research festivals, concerts, exhibitions, and seasonal markets happening during the travel dates and suggest them as bonus activities.
Real-Time Data Integration
Where possible, enrich the planner with live information:
Weather forecasts — Pull weather data for the travel dates and destination. Show expected conditions on each day card. Use this to inform rain plan recommendations.
Exchange rates — For international trips, show current exchange rates and convert budget estimates to the traveler's home currency.
Event calendars — Check for local holidays, festivals, and closures that affect the itinerary.
Venue hours and closures — Verify opening hours and seasonal closures. Flag restaurants closed on specific days (e.g., many Italian restaurants close Mondays). Alert if a suggested venue is likely to be closed on the planned visit day.
Implementation — Use web search or external APIs to fetch this data. Cache results to avoid repeated lookups. Display weather/events as supplementary info on day cards, not as blocking requirements.
Transportation Planning
Include travel logistics between stops:
Driving/transit times — Show estimated travel time between each day's activities. This helps users judge whether a day plan is realistic. Use Google Maps distance estimates or similar.
Optimal routing — If a day has multiple stops, suggest the best order to minimize driving. Group nearby activities together.
Transfer days — For multi-region trips, explicitly plan transfer days with:
Departure and arrival times
Recommended routes (scenic vs. fastest)
Luggage logistics (hotel checkout times, car rental pickups/dropoffs)
Suggested stops along the way (rest stops, scenic viewpoints, lunch spots)
Transport modes — Note whether each leg is best done by car, train, bus, ferry, cable car, or walking. Include ticket booking links where applicable.
Data model — Add transport-related fields to the day itinerary:
interface TransportLeg {
from: string;
to: string;
mode: 'car' | 'train' | 'bus' | 'ferry' | 'cable-car' | 'walking' | 'flight';
durationMinutes: number;
distance?: string;
notes?: string;
bookingLink?: string;
}
interface DayItinerary {
// ...existing fields...
transport?: TransportLeg[];
}
Packing List Generator
Based on trip parameters, generate a suggested packing list:
Weather-based — Pull expected weather for the destinations and dates. Suggest layers for variable weather, rain gear if rain is likely, sun protection for warm destinations.
Activity-based — Add items based on planned activities (hiking boots for mountain trails, swimsuit for lake/beach, smart casual for fine dining, comfortable shoes for city walking).
Baby/child-specific — If traveling with babies or young children, suggest: portable high chair, stroller rain cover, baby carrier for trails, snacks, entertainment for transit, travel crib if not provided by accommodation.
Destination-specific — Note cultural requirements (modest dress for religious sites, specific adapter types for power outlets, local SIM card recommendations).
Duration-based — Scale quantities to trip length. Suggest laundry considerations for trips over a week.
Categorize the list — Group items by: Clothing, Toiletries, Electronics, Documents, Baby/Kids, Activity Gear, Miscellaneous.
Cost Estimation and Budget Tracking
Go beyond static price estimates:
Currency conversion — For international trips, detect the traveler's home currency and show prices in both local and home currency. Use current exchange rates.
Dynamic pricing — Where possible, link to actual pricing sources rather than static estimates. Note that prices vary by season and should be verified.
Budget categories — Break costs down by: Accommodation, Dining, Activities, Transportation, Shopping/Souvenirs, Miscellaneous.
Daily budget view — Show estimated spend per day alongside the itinerary, so users can see which days are expensive and where to cut back.
Running total — Show cumulative spend as the user assigns restaurants and activities to days, so they can track against their overall budget.
Group cost splitting — For group trips, show per-person costs alongside total costs. Account for different pricing (e.g., children free, adult tickets).
Budget estimation reference (per person)
| Category | Budget | Mid | High | Notes |
|----------|--------|-----|------|-------|
| Sleep /night | $25-50 | $80-180 | $250+ | Hostels/guesthouses → 3-star → boutique |
| Food /day | $15-30 | $40-80 | $120+ | Street + one sit-down → restaurants → tasting menus |
| Local transit /day | $5-15 | $15-30 | $50+ | Metro pass → occasional taxi → car+driver |
| Activities /day | $0-20 | $30-60 | $100+ | Free walking tours → paid entries → private guides |
Southeast Asia / Central America / Eastern Europe: use the low end. Western Europe / Japan / Australia: mid-to-high. Switzerland / Norway / Iceland: add 30% to whatever you estimated.
Always add: intercity transport (trains/flights between cities — often the hidden budget killer), travel insurance (4-8% of trip cost), SIM/eSIM ($20-40), visa fees, 10-15% buffer.
Budget Summary
| Category | Est. Total |
|----------|-----------|
| Flights | $XXX |
| Accommodation (X nights) | $XXX |
| Food | $XXX |
| Activities/Entries | $XXX |
| Local Transport | $XXX |
| Trip Total|$X,XXX |
Trip Templates
Save and reuse trip structures:
Save as template — Allow completed trip plans to be saved as reusable templates. Strip personal details but keep the structure, venue recommendations, and day flow.
Template library — Maintain a collection of proven itineraries that can serve as starting points. Tag templates by destination, duration, travel style, and group type.
Customizable templates — When loading a template, let users adjust dates, swap venues, and modify the pace while keeping the overall structure.
Implementation — Store templates as JSON files with the full itinerary structure. Include metadata (destination, duration, style, best season, group type) for search and filtering.
Multi-Region Trip Logic
Handle trips that span multiple destinations or regions:
Region segmentation — Clearly separate the itinerary into region blocks (e.g., "Lake Garda — Days 1-7" and "Dolomites — Days 8-14"). Use visual badges and color coding to distinguish regions.
Transfer planning — Automatically identify transfer days between regions. Suggest departure times, scenic routes, and midway lunch stops.
Region-specific recommendations — Tailor restaurant and activity suggestions to each region. Don't suggest a Lake Garda restaurant for a Dolomites day.
Luggage logistics — Note when hotel changes require packing up. Suggest leaving heavy luggage at a storage point if doing a day trip before checking into the next region's accommodation.
Suggested day allocation — Based on the number of attractions and the pace preference, suggest how many days to allocate to each region. Flag if a region is over-packed or under-utilized.
Data Architecture
Structure venue data with these fields from the start:
interface BookingInfo {
platform: string;
deepLink: string;
rating?: number;
reviewCount?: number;
price?: string;
availability?: 'available' | 'limited' | 'sold-out' | 'unknown';
cancellationPolicy?: string;
lastChecked?: string;
}
interface Restaurant {
id: string;
name: string;
city: string;
region: string;
cuisine: string;
priceRange: string;
description: string;
mustTry: string;
familyFriendly: boolean;
mapLink: string;
websiteLink?: string;
bookingInfo?: BookingInfo[];
michelinStatus?: string;
closedOn?: string[];
suggestedMeal: 'lunch' | 'dinner' | 'either';
suggestedDays?: number[];
}
interface Activity {
id: string;
name: string;
city: string;
region: string;
category: string;
duration: string;
priceRange: string;
description: string;
highlights: string[];
familyFriendly: boolean;
strollerAccessible: boolean;
mapLink: string;
websiteLink?: string;
bookingInfo?: BookingInfo[];
seasonalAvailability?: string[];
suggestedDays?: number[];
}
interface Accommodation {
id: string;
name: string;
region: string;
stars: number;
priceRange: string;
features: string[];
familyFriendly: boolean;
babyFriendly: boolean;
mapLink: string;
websiteLink: string;
bookingInfo?: BookingInfo[];
checkInTime?: string;
checkOutTime?: string;
why: string;
}
Feature Checklist
For a full-featured web-based travel planner, include:
Design Defaults
For travel planners, warm and inviting palettes work well:
Use destination-inspired colors (e.g., terracotta/olive/amber for Italy, blue/white for Greece, red/gold for Japan, sage/slate for Scandinavia)
Serif headings (Playfair Display, Cormorant) + clean sans-serif body (DM Sans, Inter)
Subtle animations for expanding sections (Framer Motion)
Card-based layouts for restaurants and activities
Cream/warm backgrounds rather than pure white
Region-specific accent colors for multi-destination trips
PDF Export Implementation
When generating PDFs with jspdf:
Paint page backgrounds only on new pages (in addPage callback), never re-paint over existing content in loops
Use a checkPageBreak helper that handles both page breaks and background painting
Include: header with trip title/dates, day sections with activities, selected picks, alternatives, rain plans, page numbers
Style consistently with the web app's color palette
Include packing list as a final section if generated
Add a budget summary page at the end
Useful Lookups (webSearch)
"[city] 3 day itinerary reddit" — real traveler pacing, not SEO content
"rome2rio [city A] to [city B]" — compares train/bus/flight/ferry with rough prices
"numbeo cost of living [city]" — meal/taxi/beer price baselines
"seat61 [country]" — train travel bible, especially Europe/Asia
"[attraction] skip the line" — whether advance booking is actually necessary
Common Pitfalls to Avoid
Don't hardcode venues without links — always include mapLink and websiteLink
Don't skip export functionality — users always want to take plans offline
Don't forget group composition affects recommendations — babies need stroller access, elderly need less walking
Don't build desktop-first — travelers use their phones
Don't lose selection state on refresh — persist with localStorage or backend
Don't try to build booking into the app — link to booking platforms instead
Don't ignore travel times — a day with 4 activities spread across a region may not be realistic
Don't recommend venues without checking seasonal availability — a summer beach activity shouldn't appear in a winter itinerary
Don't show prices only in local currency — international travelers need conversion
Don't treat multi-region trips as a flat list — segment by region with clear transfer days
Don't forget packing needs change with activities — hiking gear, swimming gear, and fine dining outfits are all different
Don't search for flights without knowing the origin city
Limitations
1---2name: travel-assistant3description: Plan trips, build itineraries, find flights and hotels, and estimate travel budgets.4metadata:5 source: https://skillmd.com/skills/clawdsolana/travel-assistant6---78# Travel Assistant910## OpenClawd Operator Adaptation1112Run this skill as part of the OpenClawd operator deck. Preserve the skill-specific workflow below, but frame outputs for Solana-native agents when relevant: prefer OpenClawd language, note whether the work can support autonomous agent operations, and keep financial, legal, tax, hiring, medical, or other regulated outputs informational unless the skill already requires a stricter disclaimer. Use the Llobster Legend persona only as light operator framing; do not let branding override accuracy, safety, or the user's stated domain.131415Build comprehensive travel planners tailored to the user's needs. This skill ensures the agent gathers all necessary information before building, chooses the right output format, and includes essential features from the start. It also covers practical travel knowledge — flights, entry requirements, pacing, and budgeting.1617## When to Use1819- Itinerary building, flight/accommodation strategy, budget estimation20- "What do I need to enter [country]?" — visa/vaccine/ETIAS checks2122- Building interactive trip planning web apps2324## When NOT to Use2526- Booking (can't transact); travel insurance (insurance-optimizer)2728## Step 1: Ask Output Format First2930Before building anything, ask the user what format they want:3132- **Interactive website** — Best for browsing, exploring options, and sharing with travel companions. Can include maps, filters, and selection tools.33- **PDF report** — Best for offline use, printing, and taking on the trip. Clean, formatted document.3435- **Excel/spreadsheet** — Best for budget-focused planning, collaborative editing, and people who prefer tabular data.36- **Combination** — e.g., a website with PDF export (most common for serious trip planning).3738## Step 2: Gather Trip Details3940Collect these essentials before generating any content:4142- **Where are you traveling from?** (origin city/airport — required for flight search)43- **Dates and duration** — When and how long (or flexible?)4445- **Destinations / regions** — Specific cities, or open to suggestions?46- **Group size and composition** — Number of adults, children, babies, elderly. This directly affects activity recommendations, restaurant choices, and accessibility needs (stroller-friendly, wheelchair access, etc.)4748- **Travel style** — Budget, mid-range, luxury, or mixed49- **Priorities** — Food-focused, adventure, culture, relaxation, nightlife, nature, family fun5051- **Must-dos and must-avoids** — Any specific places, activities, or experiences they want or want to skip52- **Pace preference** — Packed schedule vs. slow and relaxed5354- **Dietary needs** — Allergies, vegetarian, etc. (affects restaurant recommendations)5556Do NOT search for flights without knowing the origin city — you will get it wrong.5758## Step 3: Content Depth5960Ask how detailed they want the plan:6162- **High-level outline** — Day-by-day overview with main activities63- **Detailed recommendations** — Specific restaurants, activities, alternatives, prices, links, and booking info6465- **Full concierge** — Everything above plus rain plans, backup options, and curated picks6667## Entry Requirements — Check Before Anything Else6869Getting this wrong ends the trip at the airport. webSearch every time — rules change.7071| Check | Source | Notes |7273|-------|--------|-------|7475| Visa requirements | `travel.state.gov`(US citizens) or`[passport country] [destination] visa requirements` | |7677| Schengen 90/180 (Europe) | `ec.europa.eu`calculator or`schengenvisainfo.com/visa-calculator` | 90 days in any rolling 180-day window. Does NOT reset on exit. Count days not months. Entry + exit days both count as full days. Schengen ≠ EU (UK, Ireland out; Switzerland, Norway in) |7879| ETIAS (Europe) | `etias.com` | Pre-authorization now required even for visa-free travelers |8081| Passport validity | — | Many countries require 6 months validity beyond your departure date. Check blank pages too (some need 2+) |8283| Vaccines | `cdc.gov/travel` | Yellow fever is mandatory (with certificate) for some countries if arriving from an endemic zone |8485| Onward ticket proof | — | Some countries (Thailand, Philippines, Indonesia, Costa Rica, Peru) won't let you board without proof you're leaving |8687| Safety advisories | `travel.state.gov/content/travel/en/traveladvisories` | |8889## Itinerary Pacing — The \#1 Mistake Is Overplanning9091### Hard limits9293- **Max 1 anchor activity per half-day.** One museum in the morning, one neighborhood in the afternoon. Hour-by-hour schedules fall apart by day 2.94- **Transit tax:** every change of location costs 30-60 min more than Google Maps says (finding the entrance, ticketing, getting lost once). Budget it.9596- **Day 1 after a long-haul flight is dead.** Plan a walk and an early dinner, nothing with a timed entry.97- **3-night minimum per city** for multi-city trips. 2 nights = 1 real day. Fewer cities, done well, beats a checklist.9899- **One unplanned afternoon per 3 days.** The best travel moments are unscheduled.100- **Cluster by geography** — plot everything on a map first, then group by neighborhood. Never cross the city twice in a day.101102#### Known closure patterns103104- Europe: many museums closed Mondays (Louvre, Prado) or Tuesdays (Italy). Always verify.105- Japan: many restaurants/shops closed one weekday (often Mon or Wed). Golden Week (late Apr-early May) = everything packed.106107- Middle East: Friday is the weekend day; expect closures.108- Siesta countries (Spain, Greece, parts of Italy): 2-5pm dead zone outside tourist cores.109110## Step 4: Build with These Standards111112### Flights113114Search for flights using `webSearch`with queries like`"Google Flights [origin] to [destination] [dates]"`,`"Skyscanner [origin] to [destination] [month]"`.115116Present options with **direct links** to booking/search pages:117118```text119120**Option 1: [Airline] — $XXX roundtrip**121122- Outbound: [date], [time] [origin] → [time] [dest] (Xh Xm, nonstop/1 stop)123- Return: [date], [time] [dest] → [time] [origin] (Xh Xm, nonstop/1 stop)124125- [Google Flights link](URL) | [Book direct with airline](URL)126127**Option 2: [Airline] — $XXX roundtrip**128129...130131```132133Include at least 3 options when possible: cheapest, best schedule, best airline. Note open-jaw options if doing a multi-city trip.134135#### Flight search tools — use multiple, they surface different fares136137| Tool | What it's best at |138139|------|-------------------|140141| Google Flights | Speed; calendar price grid; search up to 7 origin + 7 destination airports at once; price-history graph shows if "now" is cheap |142143| Skyscanner | "Everywhere" destination (cheapest places from your airport, sorted by price); "Whole month" date view; surfaces budget carriers Google misses |144145| Skiplagged | Hidden-city fares — flight A→C with layover at B is cheaper than A→B, so you get off at B. Savings up to 60%. **Constraints:** carry-on only (checked bags go to C), one-way only (skipping a leg cancels the rest), don't do it repeatedly on the same airline (they ban accounts) |146147| Going.com / Secret Flying | Error fares, mistake prices — time-sensitive |148149##### Booking rules150151- Find the fare on an aggregator → **book direct with the airline.** OTAs (Expedia etc.) are useless when flights get cancelled — airline agents will say "call Expedia"152- Domestic sweet spot: 1-3 months out. International: 2-6 months. Last-minute is almost always worse except on empty routes153154- Tuesday/Wednesday/Saturday departures are typically cheapest155- Open-jaw (fly into city A, out of city B) via multi-city search — often cheaper than round-trip + ground transport156157### Hotels / Accommodations158159Search using `webSearch`for hotels in the destination area with queries like`"best hotels [neighborhood] [city] [budget level]"`,`"[city] hotels [dates] site:booking.com"`,`"[city] airbnb [neighborhood]"`.160161Present options with **direct links**:162163```text164165**[Hotel Name]** — $XXX/night | [neighborhood] | [rating] stars166167- [Key feature 1], [key feature 2] (e.g., rooftop pool, walkable to old town, free breakfast)168- [Booking.com link](URL) | [Hotel website](URL)169170**[Hotel/Airbnb Name]** — $XXX/night | [neighborhood] | [rating]171172...173174```175176Include 3-5 options spanning the user's budget range. Note the neighborhood and why it's a good base. For multi-city trips, list accommodations per city.177178| Platform | Best for |179180|----------|----------|181182| Booking.com | Widest hotel inventory, free cancellation options, price match |183184| Airbnb | Apartments, longer stays, groups, kitchens |185186| Hostelworld | Budget/social travelers |187188| Hotel direct sites | Loyalty perks, best-rate guarantees |189190### Day-by-Day Itinerary191192Structure each day with anchor activities and restaurant recommendations with links:193194```text195196## Day X — [Neighborhood/Theme]197198**Anchor (AM):** [Activity] — book ahead? y/n — ~$XX — nearest metro: [station]199200**Lunch:** [Restaurant name](URL) — [cuisine, 1-line description] — ~$XX/person201202**Anchor (PM):** [Activity]203204**Dinner:** [Restaurant name](URL) — [cuisine, 1-line description] — ~$XX/person205206**Alt dinner:** [Restaurant name](URL) — [backup option]207208**Transit:** [A→B method, ~time, ~cost]209210**If it rains / you're tired:** [one swap]211212**Day est:** $XX213214```215216For restaurant links, search with `webSearch`for`"best [cuisine] restaurant [neighborhood] [city]"`or`"[city] [neighborhood] restaurants site:google.com/maps"`. Link to Google Maps, Yelp, or the restaurant's website.217218### Always Include from the Start2192201. **Links for every venue** — Every restaurant, activity, and accommodation must have:221222- A Google Maps link (`mapLink`)223- A website URL (`websiteLink`) — use the venue's official site when possible224225- These should be in the data model from day one, not added later2262271. **PDF/Excel export** — If building a website, always include export functionality. Users will want to take their itinerary offline while traveling. Use `jspdf` for PDF generation on the client side.2282. **Booking and availability context** — The app should connect to travel platforms for live data where possible, and fall back to deep links when direct integration isn't available:229230#### Target platforms and their capabilities231232- **Accommodations**: Booking.com, Airbnb, Expedia, Hotels.com — search availability by dates/location/group size, show prices, ratings, reviews, photos, amenities, cancellation policies233- **Restaurants**: OpenTable, TheFork, Resy — search availability by date/time/party size, show ratings, reviews, cuisine type, price tier, reservation slots234235- **Activities/Experiences**: GetYourGuide, Viator, Fever, Klook — search by destination/dates, show availability, prices, ratings, reviews, duration, cancellation policy236- **Transportation**: Trainline, Rome2Rio, FlixBus, local transit APIs — search routes, schedules, prices, duration between destinations237238- **Car Rental**: Rentalcars.com, AutoEurope — search by pickup/dropoff location and dates, show vehicle options, prices, insurance239240##### Integration approach (in priority order)2412421. **Replit integrations** — Check if a Replit integration exists for any of these platforms. If so, use it for direct API access (availability search, reviews, pricing). This is the preferred method.2432. **Direct APIs** — If no Replit integration exists but the platform offers a public or partner API (e.g., Booking.com Affiliate API, GetYourGuide Partner API), use it with appropriate API keys stored as secrets.2442453. **Web search enrichment** — Use web search to find current reviews, ratings, prices, and availability for venues. Parse and display relevant data.2464. **Deep links as fallback** — When no API access is available, generate deep links that pre-fill search parameters on the platform:247248- Booking.com: `https://www.booking.com/searchresults.html?ss={destination}&checkin={date}&checkout={date}&group_adults={n}&group_children={n}`249- Airbnb: `https://www.airbnb.com/s/{destination}/homes?checkin={date}&checkout={date}&adults={n}&children={n}&infants={n}`250251- OpenTable: `https://www.opentable.com/s?term={restaurant}&covers={n}&dateTime={datetime}`252- GetYourGuide: `https://www.getyourguide.com/s/?q={activity}&date_from={date}&date_to={date}`253254- Expedia: `https://www.expedia.com/Hotel-Search?destination={destination}&startDate={date}&endDate={date}&rooms=1&adults={n}`255256###### Data to surface from these platforms when available257258- Availability status (available / sold out / limited)259- Price range and specific pricing260261- User ratings and review count262- Photos263264- Cancellation/refund policy265- Key amenities or highlights266267- Booking confirmation status268269**Important:** Always check for new Replit integrations before falling back to deep links. The integration landscape evolves — what isn't available today may be available tomorrow.2702711. **Persistent state** — Selection state (which items the user picks) should survive page refresh. Use localStorage at minimum, or a lightweight backend for sharing.2722. **Mobile-first design** — Trip planners are most useful on phones while traveling. Design mobile-first with responsive breakpoints. Consider PWA features for offline access.2732743. **Collaborative features** — For group trips, consider:275276- Shareable links277- Voting/favoriting on options278279- Comments on activities280- At minimum, make the plan easy to share (PDF export, copy link)281282### Web App — Map + Itinerary283284**Always build a web app** that combines two views the user can switch between:2852861. **Map view** — all locations plotted on an interactive map with color-coded markers by type (airports, hotels, activities, restaurants). Each marker has a popup with name, time, and links. Connect same-day stops with route lines so the user can see the flow.2872. **Itinerary view** — a beautiful, card-based day-by-day layout. Each day is a card with the day number, neighborhood/theme, and a timeline of activities, meals, and transit. Include photos or icons for each stop, estimated costs, and direct links to book or learn more.288289Use the **Nominatim API** (OpenStreetMap) for geocoding addresses to lat/lng — no API key required.290291The user should be able to toggle between map and itinerary views. Clicking a day in the itinerary should highlight that day's markers on the map.292293### AI-Powered Recommendations294295Use AI integrations to generate smarter, personalized content rather than relying solely on hardcoded data:296297- **Destination research** — Use an AI model to research destinations based on the user's preferences (travel style, group composition, interests) and generate tailored restaurant, activity, and accommodation suggestions.298- **Seasonality awareness** — Factor in the time of year when recommending activities. Suggest outdoor markets and harvest festivals in fall, ski resorts in winter, beaches and hiking in summer, cherry blossoms in spring. Flag activities that may be closed or less enjoyable in the chosen season.299300- **Personalization** — Adjust recommendations based on group composition. A trip with babies should emphasize stroller-friendly paths, early dinner reservations, and nap-friendly schedules. A trip with adventurous adults should prioritize hikes, wine tours, and late-night dining.301- **Local events** — Research festivals, concerts, exhibitions, and seasonal markets happening during the travel dates and suggest them as bonus activities.302303### Real-Time Data Integration304305Where possible, enrich the planner with live information:306307- **Weather forecasts** — Pull weather data for the travel dates and destination. Show expected conditions on each day card. Use this to inform rain plan recommendations.308- **Exchange rates** — For international trips, show current exchange rates and convert budget estimates to the traveler's home currency.309310- **Event calendars** — Check for local holidays, festivals, and closures that affect the itinerary.311- **Venue hours and closures** — Verify opening hours and seasonal closures. Flag restaurants closed on specific days (e.g., many Italian restaurants close Mondays). Alert if a suggested venue is likely to be closed on the planned visit day.312313- **Implementation** — Use web search or external APIs to fetch this data. Cache results to avoid repeated lookups. Display weather/events as supplementary info on day cards, not as blocking requirements.314315### Transportation Planning316317Include travel logistics between stops:318319- **Driving/transit times** — Show estimated travel time between each day's activities. This helps users judge whether a day plan is realistic. Use Google Maps distance estimates or similar.320- **Optimal routing** — If a day has multiple stops, suggest the best order to minimize driving. Group nearby activities together.321322- **Transfer days** — For multi-region trips, explicitly plan transfer days with:323- Departure and arrival times324325- Recommended routes (scenic vs. fastest)326- Luggage logistics (hotel checkout times, car rental pickups/dropoffs)327328- Suggested stops along the way (rest stops, scenic viewpoints, lunch spots)329- **Transport modes** — Note whether each leg is best done by car, train, bus, ferry, cable car, or walking. Include ticket booking links where applicable.330331- **Data model** — Add transport-related fields to the day itinerary:332333```typescript334335interface TransportLeg {336337from: string;338339to: string;340341mode: 'car' | 'train' | 'bus' | 'ferry' | 'cable-car' | 'walking' | 'flight';342343durationMinutes: number;344345distance?: string;346347notes?: string;348349bookingLink?: string;350351}352353interface DayItinerary {354355// ...existing fields...356357transport?: TransportLeg[];358359}360361```362363### Packing List Generator364365Based on trip parameters, generate a suggested packing list:366367- **Weather-based** — Pull expected weather for the destinations and dates. Suggest layers for variable weather, rain gear if rain is likely, sun protection for warm destinations.368- **Activity-based** — Add items based on planned activities (hiking boots for mountain trails, swimsuit for lake/beach, smart casual for fine dining, comfortable shoes for city walking).369370- **Baby/child-specific** — If traveling with babies or young children, suggest: portable high chair, stroller rain cover, baby carrier for trails, snacks, entertainment for transit, travel crib if not provided by accommodation.371- **Destination-specific** — Note cultural requirements (modest dress for religious sites, specific adapter types for power outlets, local SIM card recommendations).372373- **Duration-based** — Scale quantities to trip length. Suggest laundry considerations for trips over a week.374- **Categorize the list** — Group items by: Clothing, Toiletries, Electronics, Documents, Baby/Kids, Activity Gear, Miscellaneous.375376### Cost Estimation and Budget Tracking377378Go beyond static price estimates:379380- **Currency conversion** — For international trips, detect the traveler's home currency and show prices in both local and home currency. Use current exchange rates.381- **Dynamic pricing** — Where possible, link to actual pricing sources rather than static estimates. Note that prices vary by season and should be verified.382383- **Budget categories** — Break costs down by: Accommodation, Dining, Activities, Transportation, Shopping/Souvenirs, Miscellaneous.384- **Daily budget view** — Show estimated spend per day alongside the itinerary, so users can see which days are expensive and where to cut back.385386- **Running total** — Show cumulative spend as the user assigns restaurants and activities to days, so they can track against their overall budget.387- **Group cost splitting** — For group trips, show per-person costs alongside total costs. Account for different pricing (e.g., children free, adult tickets).388389#### Budget estimation reference (per person)390391| Category | Budget | Mid | High | Notes |392393|----------|--------|-----|------|-------|394395| Sleep /night | $25-50 | $80-180 | $250+ | Hostels/guesthouses → 3-star → boutique |396397| Food /day | $15-30 | $40-80 | $120+ | Street + one sit-down → restaurants → tasting menus |398399| Local transit /day | $5-15 | $15-30 | $50+ | Metro pass → occasional taxi → car+driver |400401| Activities /day | $0-20 | $30-60 | $100+ | Free walking tours → paid entries → private guides |402403Southeast Asia / Central America / Eastern Europe: use the low end. Western Europe / Japan / Australia: mid-to-high. Switzerland / Norway / Iceland: add 30% to whatever you estimated.404405**Always add:** intercity transport (trains/flights between cities — often the hidden budget killer), travel insurance (~4-8% of trip cost), SIM/eSIM (~$20-40), visa fees, 10-15% buffer.406407### Budget Summary408409| Category | Est. Total |410411|----------|-----------|412413| Flights | $XXX |414415| Accommodation (X nights) | $XXX |416417| Food | $XXX |418419| Activities/Entries | $XXX |420421| Local Transport | $XXX |422423| **Trip Total**|**$X,XXX** |424425### Trip Templates426427Save and reuse trip structures:428429- **Save as template** — Allow completed trip plans to be saved as reusable templates. Strip personal details but keep the structure, venue recommendations, and day flow.430- **Template library** — Maintain a collection of proven itineraries that can serve as starting points. Tag templates by destination, duration, travel style, and group type.431432- **Customizable templates** — When loading a template, let users adjust dates, swap venues, and modify the pace while keeping the overall structure.433- **Implementation** — Store templates as JSON files with the full itinerary structure. Include metadata (destination, duration, style, best season, group type) for search and filtering.434435### Multi-Region Trip Logic436437Handle trips that span multiple destinations or regions:438439- **Region segmentation** — Clearly separate the itinerary into region blocks (e.g., "Lake Garda — Days 1-7" and "Dolomites — Days 8-14"). Use visual badges and color coding to distinguish regions.440- **Transfer planning** — Automatically identify transfer days between regions. Suggest departure times, scenic routes, and midway lunch stops.441442- **Region-specific recommendations** — Tailor restaurant and activity suggestions to each region. Don't suggest a Lake Garda restaurant for a Dolomites day.443- **Luggage logistics** — Note when hotel changes require packing up. Suggest leaving heavy luggage at a storage point if doing a day trip before checking into the next region's accommodation.444445- **Suggested day allocation** — Based on the number of attractions and the pace preference, suggest how many days to allocate to each region. Flag if a region is over-packed or under-utilized.446447### Data Architecture448449Structure venue data with these fields from the start:450451```typescript452453interface BookingInfo {454455platform: string;456457deepLink: string;458459rating?: number;460461reviewCount?: number;462463price?: string;464465availability?: 'available' | 'limited' | 'sold-out' | 'unknown';466467cancellationPolicy?: string;468469lastChecked?: string;470471}472473interface Restaurant {474475id: string;476477name: string;478479city: string;480481region: string;482483cuisine: string;484485priceRange: string;486487description: string;488489mustTry: string;490491familyFriendly: boolean;492493mapLink: string;494495websiteLink?: string;496497bookingInfo?: BookingInfo[];498499michelinStatus?: string;500501closedOn?: string[];502503suggestedMeal: 'lunch' | 'dinner' | 'either';504505suggestedDays?: number[];506507}508509interface Activity {510511id: string;512513name: string;514515city: string;516517region: string;518519category: string;520521duration: string;522523priceRange: string;524525description: string;526527highlights: string[];528529familyFriendly: boolean;530531strollerAccessible: boolean;532533mapLink: string;534535websiteLink?: string;536537bookingInfo?: BookingInfo[];538539seasonalAvailability?: string[];540541suggestedDays?: number[];542543}544545interface Accommodation {546547id: string;548549name: string;550551region: string;552553stars: number;554555priceRange: string;556557features: string[];558559familyFriendly: boolean;560561babyFriendly: boolean;562563mapLink: string;564565websiteLink: string;566567bookingInfo?: BookingInfo[];568569checkInTime?: string;570571checkOutTime?: string;572573why: string;574575}576577```578579### Feature Checklist580581For a full-featured web-based travel planner, include:582583- [ ] Day-by-day itinerary (timeline view)584- [ ] Board/Kanban view for visual overview585586- [ ] Restaurant catalog with filters and "Add to Day" picker587- [ ] Activity catalog with category filters and "Add to Day" picker588589- [ ] Selection system (context/state) for assigning items to days590- [ ] "Your Picks" section on each day showing assigned restaurants/activities591592- [ ] Interactive map with color-coded markers593- [ ] Accommodation recommendations594595- [ ] Budget breakdown with per-day and per-person views596- [ ] PDF export of full itinerary (including picks, alternatives, rain plans)597598- [ ] Map, website, and booking links on every venue card599- [ ] Dining and activity alternatives per day600601- [ ] Rain/bad weather backup plans602- [ ] Region badges on day cards603604- [ ] Transportation time estimates between stops605- [ ] Packing list generator606607- [ ] Weather forecast integration608- [ ] Currency conversion for international trips609610- [ ] Persistent state (localStorage or backend)611- [ ] Mobile-responsive design612613### Design Defaults614615For travel planners, warm and inviting palettes work well:616617- Use destination-inspired colors (e.g., terracotta/olive/amber for Italy, blue/white for Greece, red/gold for Japan, sage/slate for Scandinavia)618- Serif headings (Playfair Display, Cormorant) + clean sans-serif body (DM Sans, Inter)619620- Subtle animations for expanding sections (Framer Motion)621- Card-based layouts for restaurants and activities622623- Cream/warm backgrounds rather than pure white624- Region-specific accent colors for multi-destination trips625626### PDF Export Implementation627628When generating PDFs with jspdf:629630- Paint page backgrounds only on new pages (in `addPage` callback), never re-paint over existing content in loops631- Use a `checkPageBreak` helper that handles both page breaks and background painting632633- Include: header with trip title/dates, day sections with activities, selected picks, alternatives, rain plans, page numbers634- Style consistently with the web app's color palette635636- Include packing list as a final section if generated637- Add a budget summary page at the end638639## Useful Lookups (webSearch)640641- `"[city] 3 day itinerary reddit"` — real traveler pacing, not SEO content642- `"rome2rio [city A] to [city B]"` — compares train/bus/flight/ferry with rough prices643644- `"numbeo cost of living [city]"` — meal/taxi/beer price baselines645- `"seat61 [country]"` — train travel bible, especially Europe/Asia646647- `"[attraction] skip the line"` — whether advance booking is actually necessary648649## Common Pitfalls to Avoid6506511. Don't hardcode venues without links — always include mapLink and websiteLink6522. Don't skip export functionality — users always want to take plans offline6536543. Don't forget group composition affects recommendations — babies need stroller access, elderly need less walking6554. Don't build desktop-first — travelers use their phones6566575. Don't lose selection state on refresh — persist with localStorage or backend6586. Don't try to build booking into the app — link to booking platforms instead6596607. Don't ignore travel times — a day with 4 activities spread across a region may not be realistic6618. Don't recommend venues without checking seasonal availability — a summer beach activity shouldn't appear in a winter itinerary6626639. Don't show prices only in local currency — international travelers need conversion66410. Don't treat multi-region trips as a flat list — segment by region with clear transfer days66566611. Don't forget packing needs change with activities — hiking gear, swimming gear, and fine dining outfits are all different66712. Don't search for flights without knowing the origin city668669## Limitations670671- Can't see live prices/availability — user must verify before booking672- Visa rules change — always confirm on official government sites673674- Can't book anything