✈ Roammingo
User Guide

What's New — Your Agent Just Leveled Up

Eight new capabilities that make this feel less like a search box and more like a professional travel agent on retainer.

📅 Booking deadlines

Popular attractions sell out weeks ahead, restaurants open reservations on a schedule, and e-visas need lead time. The agent now generates a booking calendar for every trip: to-do items with due dates, sorted by urgency. Overdue items turn red, deadlines within a week turn amber, and the To-do header shows an overdue badge even when collapsed.

🛂 Passport guardrail

Most countries require six months of passport validity beyond your return date. Tell the agent your passport expiry once — it remembers, checks it against every international trip, and warns you before it becomes a problem at the airport.

⚡ Energy pacing

Every day on the board now carries an energy meter (● ● ● ○ ○). The agent paces trips like a pro: never more than two packed days in a row, a deliberate recovery day on long trips, and a light arrival day after a red-eye. Hover the dots to see the pacing rationale.

☔ Plan B — the shadow itinerary

Outdoor-heavy days get a pre-built wet-weather backup. Look for the ☔ Plan B badge on a day's header — one tap shows the alternates, another swaps them in. The original plan is kept as the new Plan B, so it's fully reversible.

🔴 Today mode

Once your trip starts, the board pivots from planner to companion: a LIVE strip shows which trip day you're on, what's next on today's schedule, tonight's hotel, and the weather — and the board jumps straight to today. Before the trip, you'll see a days-to-go countdown instead.

🔄 Repair, don't regenerate

When plans change — a missed flight, a closed museum, a lost day — the agent fixes only the affected days and keeps everything you've locked or confirmed. The board shows exactly what changed ("2 added · 1 moved") and flashes the updated cards, instead of silently rebuilding your whole trip.

🧠 Trip memory

After you return, the agent asks a quick three-question debrief — highlight, what you'd skip, pace check — and remembers the answers for every future trip. Your Markdown export now doubles as a trip record: checklist state, deadlines, energy pacing, and Plan Bs included.

🧭 Off the beaten path

Flip the compass toggle in the sidebar and the agent actively steers away from the tourist crush: equally-good alternative destinations, neighborhoods where locals live, and marquee sights timed for off-peak hours. Contrarian picks are labeled so you always know the trade-off.

🌅 Overnight Concierge

Your agent now works the night shift. Every night it quietly re-checks each upcoming trip — booking deadlines coming due, price watches that hit your target or dropped hard, and rain rolling in on a day that has a Plan B ready. If (and only if) something genuinely needs you, you wake up to a short morning briefing: a 🌅 message at the top of your chat, and an email if you're signed in with email alerts on. No news means no briefing — it never writes just to say hi.

📉 Price watches — the pricing engine

Say "watch this route" (or name a target: "alert me if Denver to Venice drops under $900") and the app re-checks the price every few hours in the background — even while you're away. Your watches live in the sidebar with the latest price, trend arrow, and best price seen. When a price hits your target or drops ~10%, you get an alert the moment you open the app. Ask "should I book now?" and the agent scores today's price against the watch's own history: great · good · typical · high.

Getting Started

Works without an account. Sign up to save your trips permanently, unlock higher limits, and collaborate with others.

1. Open the app in your browser. Your session is created automatically — your trip data is saved so you can pick up where you left off.

2. Sign in (optional but recommended) — click Sign in in the sidebar to create a free account with email or Google. Your trips, preferences, and itineraries are then tied to your account, not just your browser.

3. Type your destination in the chat box at the bottom. Be as vague or specific as you like — "I want to go somewhere warm in January" works just as well as "Flights from JFK to Bali on March 15".

4. The agent will ask follow-up questions if it needs more info — number of travelers, budget, departure city, dates, etc.

5. Watch the Trip Board (🗺 button, top right) fill in as the agent builds your itinerary.

6. Keep chatting to refine, change dates, swap hotels, or add activities.

Quick-start examples you can click right in the app:

Creating an Account

A free account ties your trips, preferences, and workspaces to you — not just your browser. Sign in on any device and pick up where you left off.

🔑 How to sign in

1. Click Sign in in the bottom-left sidebar panel.

2. Choose Continue with Google for one-click sign-in, or enter your email to receive a magic link / set a password.

3. You're in. Your avatar and plan badge appear in the sidebar.

👤 Your profile panel

Once signed in, the sidebar shows:

• Your name and email from your account
• Plan badge — Free / Pro / Team
• Usage bar — how many chat turns you've used this month vs. your plan limit
• Upgrade button — if you're on the Free plan and want more

🔒 Your data is private

All trips, preferences, and itineraries are scoped to your user ID. Other users can never see your data unless you explicitly share it. There are two ways to share:

• Groups — join a group to share your saved trip history with other group members (see Groups).
• Share link — generate a public read-only link to a specific itinerary (see Export & Share).

🛡️ Your privacy controls

Open your Account page — click your name (or the Account button) at the bottom of the sidebar — to control your data:

• Export data — download a full copy of everything we hold about you as a JSON file, anytime.
• Delete my account — permanently erase your account and all associated data (trips, chats, preferences, price alerts). This can't be undone.
• Dietary & accessibility personalization — an optional, off-by-default toggle. Turn it on to let the agent use your dietary/accessibility info to tailor recommendations; turn it off anytime and that data is no longer used.
• Cookies & analytics — on your first visit we ask before loading any product analytics. Reject is just as easy as Accept, and we honor your browser's Global Privacy Control signal automatically.
• Email alerts — every alert email has a one-click unsubscribe link.

Read the full Privacy Policy, Terms, and Cookie Notice.

Plans & Usage Limits

Start free. Upgrade when you need more searches or collaboration features.

📊 Checking your usage

Your current month's usage is shown in the sidebar under your avatar. The bar fills as you use chat turns. It resets on the 1st of each month.

Talking to the Agent

Plain English, plain questions. The agent understands natural language — no special commands required.

📝 How to phrase requests

You can be completely natural. Here are real examples of things the agent handles well:

⌨️ Keyboard shortcuts

Press Enter to send a message.
Press Shift + Enter to add a line break inside your message.

🔄 Message queue

If the agent is still thinking and you type another message, it's automatically queued — you'll see a toast notification. Your messages are never lost.

Searching Flights

Flight results come from Google Flights via SerpAPI — real prices, real airlines, real departure times. Carbon emission data is included where available.

🔍 What you can search for

✈ Booking a flight

When the agent finds a flight you like, say "Book it" or "Book the Delta flight". A confirmation modal will pop up showing all the details. You must click Confirm Booking before any action is taken — nothing is booked without your explicit approval.

Finding Hotels

Hotels are searched by city, dates, star rating, and budget. The agent automatically adds hotels to your itinerary.

Finding the Best Prices

Two powerful tools let you find the cheapest time to fly — by date or by month — with a visual price calendar.

📅 Cheapest date finder

Ask: "Find the cheapest dates to fly from New York to Tokyo around March 15"

The agent searches ±7 days around your target date and shows a colour-coded price calendar:

• 🟢 Green = cheapest dates
• 🟡 Yellow = mid-range
• 🔴 Red = most expensive

You can click any date in the calendar to instantly search flights for that day.

📊 Best month finder

Ask: "When is the cheapest month to fly from London to Bali?"

The agent analyses 12 months of pricing and shows a bar chart with:

• Average price per person each month
• Season rating (Peak 🔴 / Shoulder 🟡 / Off-peak 🟢)
• The single best-value month highlighted with a ★ Best badge
• How much you save vs. the most expensive month

Click any month bar to search flights for that period.

The Trip Board

A visual day-by-day itinerary that updates live as you chat. Click the 🗺 Trip Board button in the top-right to open it.

🖱️ Drag and drop

Cards on the board are fully draggable — on desktop and mobile. Drag a hotel, activity, or flight card to a different day to reorder your trip. Changes are saved automatically.

📄 What each card shows

• Colour-coded left border: ✈ blue=flight, 🏨 teal=hotel, 🗺 orange=activity, 🍽 gold=restaurant, 🚗 grey=transfer
• Time — departure or activity start time
• Price — individual item cost in your chosen currency
• Status badge — Confirmed / Suggested / Alternative
• Notes — any details the agent added (e.g. "Window seat requested")

🔒 Locking cards

Hover over any card to see action buttons. Click 🔒 Lock to lock a card in place — it won't move when you drag other items. Click again to unlock.

⚡ Conflict detection

The board automatically detects scheduling issues and shows them in a banner:

• 🔴 Overlap — two events at the same time
• 🟡 Tight gap — less than 20 minutes between events
• 🔵 Free time — a 3+ hour gap with nothing planned (click "Ask agent →" to fill it)

📄 Week-by-week navigation

For trips longer than 7 days, the board shows one week at a time with Prev / Next buttons to keep it fast and readable.

↔ Alternatives

Hover any card and click ↔ Alternative to ask the agent to suggest 2–3 swaps for that specific item.

⚡ Energy meter NEW

Each day header shows an intensity meter — ●●○○○ restful through ●●●●● packed. The agent paces your trip deliberately (recovery days after big days, light arrivals after red-eyes) and explains its reasoning in a note under the day header. Hover the dots for the rationale.

☔ Plan B badge NEW

Weather-dependent days carry a ☔ Plan B badge — a pre-built indoor backup for that day. Click it to preview the alternates and Swap it in with one tap. The original day is kept as the new Plan B, so you can always swap back.

🔴 Today mode & countdown NEW

Before departure, the board header shows a 🛫 days-to-go countdown. Once the trip starts, a LIVE strip appears: current trip day, the next timed item on today's schedule, tonight's hotel, and today's weather — and the board jumps straight to today's cards.

🔄 Change highlights NEW

When the agent updates an existing plan, you'll see a summary toast ("Board updated: 2 added · 1 moved") and the changed cards flash briefly — no more guessing what moved. Everything you've locked stays put, and an ✓ Auto-saved timestamp in the board header confirms your changes are safe.

Budget Tracking & Per-Person Breakdown

Tell the agent your total budget and number of travelers. The board shows the total cost, per-person cost, and a breakdown by category — all in one place.

👥 Travelers selector

Use the − / + stepper in the budget panel (bottom of the Trip Board) to adjust the number of travelers at any time. All per-person amounts update instantly — no need to re-ask the agent.

🔢 How budget tracking works

1. Tell the agent your budget: "Plan a trip to Bali for 4 people, total budget $6,000"

2. As it searches flights and hotels, it tracks the running total in the board's budget bar.

3. If a result would bust the budget, the agent warns you and suggests cheaper alternatives.

4. The bar turns amber at 70% and red at 90% of budget.

5. Category chips show both total and per-person amounts for flights, hotels, activities, and food.

Multi-Destination Trips

Planning a Europe interrail or an Asian city-hop? The agent handles multi-stop itineraries automatically.

The Trip Board shows each city as a section. Flights between cities appear automatically as cards on the departure day. You can ask the agent to spend more or fewer days in any city at any time.

🚗 Ground transport

For nearby cities (like Paris → Brussels, or Rome → Naples), the agent can suggest trains or bus routes as an alternative to flying. Just ask: "How do I get from Paris to Amsterdam?"

Currency Conversion

Convert any amount between any two currencies using up-to-date exchange rates.

You can also set your preferred currency in preferences (e.g. "Remember I want prices in Euros") and all future trip costs will be displayed in EUR.

Weather & Seasons

Get weather forecasts for your trip dates and learn the best times of year to visit any destination.

📆 Trip forecast

When you plan a trip, weather is automatically fetched for each day and shown on the board card:

☀️ 24/16°C · ⛅ 21/14°C · 🌧 18/12°C · ☀️ 25/15°C

🌍 Season badges

Each destination shows a season rating for your travel dates:

Ask the agent "Is June a good time to visit Santorini?" for a full breakdown including crowd levels, weather, and typical prices.

Groups — Shared Trip Feed

Create a group, invite friends or family, and everyone's saved trips appear in a shared feed. Great for travel clubs, family holidays, or keeping tabs on what trips your friends are planning. Groups are available on all plans.

🏗 Creating a group

1. In the sidebar, find the Groups section (visible after signing in).

2. Click the ＋ button next to "Groups".

3. Give your group a name — e.g. "Family Vacations" or "Work Trips 2025".

4. Click Create. You're the group owner.

✉️ Inviting members

1. Click your group in the sidebar to open the group panel.

2. Click + Invite and enter the email address of the person you want to add.

3. Click Send Invite. The invite is stored against their email address.

4. When they next log in, a 🔔 pending invite notification appears in their sidebar. They click Join to accept.

🗺 Viewing group trips

Once members have joined, open the group from the sidebar. The Group Trips panel shows all saved trips from every joined member, sorted by most recently updated. Anyone in the group can view all trips — but cannot edit or delete another member's trips.

🔑 Owner controls

• Remove a member by clicking ✕ next to their name
• Delete the group entirely (removes all shared access)
• Only the owner can send invites

🛡 Invite limits

To prevent spam, group invites are rate-limited:

• 20 invites per day (total across all your groups)
• 3 invites per day to the same email address

If you hit a limit, try again the following day. The counter resets every 24 hours.

Collaborative Workspaces

Plan a group trip together. Create a workspace, invite your travel companions, and everyone edits the same itinerary in real time. Available on Pro and Team plans.

🏗 Creating a workspace

1. Open the Workspaces panel in the sidebar (appears after signing in).

2. Click + New Workspace and give it a name (e.g. "Italy Trip — Summer 2025").

3. Optionally link it to your current planning session so invited members can see the itinerary right away.

4. Click Create. You're the owner.

✉️ Inviting members

1. Open the workspace and click Invite member.

2. Enter your travel companion's email address and choose their role:

   Role	Can view	Can chat & edit	Can manage members
   Editor	✓	✓	—
   Viewer	✓	—	—

3. Click Send invite. Your companion receives an email with a link to join.

✈ How workspace planning works

Everyone in the workspace shares the same chat session and Trip Board. When one member updates the itinerary, others see it reflected the next time they load the page. The AI agent responds to whoever sends the most recent message — great for back-and-forth group planning.

🔑 Owner controls

• Change a member's role at any time from Editor ↔ Viewer
• Remove a member by clicking the ✕ next to their name
• Delete the workspace entirely (removes access for all members)

Exporting & Sharing Your Itinerary

Once your itinerary is built, click the ⬇ Export button (top-right, next to the Trip Board toggle).

Saving Your Preferences

Teach the agent your travel style once and it remembers forever — across all your future trips.

💬 Just say it in chat

Use phrases like "Remember…" or "Always…" and the agent saves it for you:

🧭 Off the beaten path toggle NEW

Click the 🧭 Off the beaten path button in the sidebar to flip contrarian mode on. The agent then leads with less-crowded alternatives, local neighborhoods, and off-peak timing for marquee sights — with each contrarian pick labeled so you know the trade-off. Click again to return to balanced recommendations.

🛂 Passport expiry NEW

Tell the agent when your passport expires ("my passport expires March 2027") and it checks the 6-month validity rule against every international trip you plan — warning you long before it becomes an airport problem.

📋 What can be saved

Tips & Tricks

Get the most out of your travel agent with these power-user moves.

1️⃣ Start broad, then refine

2️⃣ Use the deal hunter first

3️⃣ Lock flights and hotels, flex activities

4️⃣ Import itineraries from friends

5️⃣ Ask for alternatives by the card

6️⃣ Use your travel history

7️⃣ Reset vs. New Session

🔢 Quick reference — useful phrases