Sidequest

Tell it how you travel. Get a trip you can actually take.

Sidequest is a travel planner that asks the right questions once, finds the places worth going, lets you choose what's in, and then builds a realistic day-by-day trip — with real maps, real travel times, weather, food, bookings and a plan for every day you're away.

Open the live app →  ·  Help me choose where to go  ·  Run it locally

---

Contents

• Why Sidequest
• The journey at a glance
• Features
• How to use it
• Under the hood
• APIs and data sources
• Run it locally
• Configuration
• Project structure
• Deploying
• Privacy
• Contact

---

✦ Why Sidequest

Most trip planners rank places by popularity and leave you to fix the plan: make it less rushed, add food, check the weather, what about that place nearby? Sidequest is built the other way round.

Instead of…	Sidequest…
A chat that invents an itinerary	Finds real places, lets you choose, then plans deterministically — the AI proposes, it never optimises
Popularity rankings	Ranks by personal fit: your interests, pace, budget, party, season and how far you'll go
"About 20 minutes" guesses	Measured travel times from routing services, and says so when a leg couldn't be measured
A list of attractions	Bases to sleep in, meals, rest, backups for bad weather, and a reason for everything it left out
A plan that ends at the PDF	A trip hub: Today mode, bookings, packing, calendar feed, offline copy, share link

Two rules run through everything: unknown is never treated as false (missing evidence lowers confidence, it doesn't delete your plans), and nothing is made up — prices, opening hours and availability are only shown when a source says so.

---

✦ The journey at a glance

flowchart LR
    A([Home]) --> B{Know where<br/>you're going?}
    B -- Yes --> C[Set up the trip<br/>destination · dates · who]
    B -- Not yet --> D[Help me choose<br/>a few questions → 3 places]
    D --> C
    C --> E[Short interview<br/>pace · interests · transport]
    E --> F[Discovery scan<br/>real places, mapped]
    F --> G[Discovery Board<br/>pick what's in]
    G --> H[Build<br/>deterministic planner]
    H --> I[Trip hub<br/>days · map · plan · book · prepare]
    I --> J[Today mode<br/>on the road]

---

✦ Features

For when you know when and what for, but not where.

• Say it your way. Type "somewhere outdoors this summer — hiking, wildlife, lakes and swimming" and Sidequest reads the season, interests, length, budget, who's going and where you're starting from. It never asks again for something you already said.
• Only the questions that matter. Each next question is the one most likely to change your shortlist ("If it could only be brilliant at one thing…", "Warm sea or mountain lakes?"). It stops when another answer wouldn't change much — usually two to five taps. Skip anything, or jump to results.
• A live world map shows the places taking the lead as you answer.
• Three different answers, argued for. Each pick says why it fits you, three highlights, best months, trip length, difficulty, costs, getting there and around, where you'd stay, the catch, and what hasn't been checked.
• Real places only. A catalog of 234 multi-day destinations — national parks, mountain ranges, coasts, island groups — across 24 parts of the world. Famous places get no bonus unless you ask for classics; little-known ones get none unless you ask for something unusual.
• Weather checked against twenty years of climate records for the places on screen.
• Nudge it: warmer, cheaper, less crowded, closer, more wildlife, more unusual, easier logistics, "more like this one", or "something completely different".
• Plan this trip turns a pick into an ordinary trip with everything you said carried over.

• Type a destination the way you'd say it — "the Canadian Rockies", "Lisbon and the Azores", "rural Japan" — and Sidequest works out what kind of place it is (a city, a region, a country, several parts) and frames the map to match.
• Dates can be exact, a month, a season or flexible; Sidequest can suggest the best window from climate data.
• A short, adaptive interview: pace, interests and how often you want them, budget, food, who's travelling (including children, older travellers, diets and mobility), transport and how much driving is too much. Free-text notes are read into answers you can see and correct.
• Not in the mood? Plan with smart defaults and adjust later.

以上为 README 的开头部分。其余内容请阅读原文。 查看完整 README ↗