About · Specification
What roamgap is
The product brief in plain language. The Markdown twin is the AI-readable form; the full normative specification is served verbatim at llms-full.txt.
In one line
roamgap is a smart holiday optimizer. Given a country and a PTO budget, it returns the calendar trips that maximise continuous time off per PTO day spent.
The core insight
A Tuesday public holiday plus the weekends around it can give a 5-day break for just 2 days of PTO. The optimizer surfaces these opportunities automatically, ranked by efficiency.
The tools
- Annual planner (/year, the primary, home-page mode) — enter your whole-year PTO budget and a max trip length, and get five alternative year plans to pick from.
- Plan a year for two (/overlap) — the same idea for two or more people across different countries: the breaks everyone can share, ranked by the least total leave and optimised against each country's public holidays.
- Solo trips (/solo) — collect the breaks you like into an itinerary.
- Group trips (/groups) — plan with a whole crew; everyone drops their own availability and the engine finds the shared window.
A reference calendarshows any country's weekends and public holidays for a year, with no optimization.
What's free
The core optimizer is free and complete — the annual planner's five plans, both budget modes, the full filters, the reference calendar, and regional (state/province) accuracy wherever we have the data. We don't throttle results or paywall basic correctness. A free account adds cross-device saved searches, calendar export, and email alerts. Free-tier searches persist only in your browser session; we say so plainly rather than hiding it.
Principles
- Honest about limits — session-only storage and historical-data uncertainty are surfaced, not buried.
- AI-discoverable — every page has a Markdown twin, and the API publishes JSON Schema and OpenAPI so agents can call it directly.
- Privacy-respecting — analytics only after consent; see the privacy policy.