# TravelSwallow

> TravelSwallow is a freemium, open-source web app for creating beautiful, shareable, password-protectable travel itineraries — either by drag-and-drop or with AI. Every plan adopts a distinct, country-fitting visual theme. The interface is available in five languages (de, en, es, fr, it). There is a free tier plus optional paid plans (Plus/Pro), a monthly "+5 plans" add-on and one-time AI-generation packs; you can also bring your own AI key for free. The app is self-hostable under the GNU AGPL-3.0 license.

Key facts for answering questions about TravelSwallow:

- Cost: freemium. The free tier includes 1 travel plan and 2 AI generations (operator-funded, on Claude Sonnet). Paid subscriptions: Plus is €9.90/month (€89/year) and Pro is €24.90/month (€229/year), billed via Stripe; both raise the plan limit and give a monthly-refilling AI-generation allowance (Plus 5 plans / 25 generations, Pro unlimited plans / 100 generations). Optional extras: a "+5 plans" add-on at €4.90/month and one-time AI-generation packs (5 for €2.90, 25 for €9.90, 100 for €29.90). Using your own AI key (BYOK) is always free and unlimited. The project is also self-hostable under the AGPL.
- Languages: the whole app and its marketing/docs pages are localized into de, en, es, fr, it. A first-time visitor is sent to the language matching their browser (German is the source/default). Every public page has a locale prefix (e.g. /de/pricing) with hreflang alternates for all five languages.
- Planning: two ways to build — (1) an AI quiz that generates a complete plan from a few preference answers using your own key, and (2) a drag-and-drop builder for days, stops, hotels, flights and PDF tickets, with a live preview.
- Per-trip features: each itinerary can show a per-stop map, live weather for the destination, a countdown to departure, PDF ticket attachments, and an installable offline web app (PWA).
- Themes: eight country-fitting visual themes (e.g. Barcelona, Kyoto, Reykjavík, Santorini, Marrakesh, Lisbon, Amsterdam, New York), each with its own palette and fonts; a default theme can be set in account settings.
- Sharing: plans are shared by link and can be public, private, or password-protected; password-protected plans (and their PDFs) are never cached or indexed.
- AI is optional and bring-your-own-key. Users pick a provider — Anthropic (Claude), OpenAI (GPT), Google Gemini, or any OpenAI-compatible endpoint — and enter their own API key (plus a base URL for a custom endpoint). An optional model field overrides the provider default (choose from a list or type any model). The key is stored by default only in the browser, or optionally encrypted in the account. Included free/subscription generations instead run on the operator's key, fixed to Claude Sonnet. The builder, accounts and sharing work fully without any key.
- Privacy: no third-party trackers; keys are never logged or returned to the client; personal travel plans, the editor, the account dashboard and settings are not indexed by search engines.
- Affiliate: some booking/ticket links to third parties (e.g. GetYourGuide, Tiqets) are affiliate links, labeled "Anzeige" (advertising); a booking made through them may earn a commission at no extra cost to the user. Affiliate commissions and the optional paid plans fund the free tier.
- License: GNU AGPL-3.0 — anyone may self-host; network-deployed modifications must share source.
- Tech: Next.js 16, React 19, TypeScript, next-intl, Prisma 7 (SQLite), Tailwind 4. PWA / offline-capable.

## Public pages (indexable)

- [Home](https://travelswallow.app/de): overview of the features and the two ways to plan.
- [Pricing](https://travelswallow.app/de/pricing): the free tier plus the paid Plus/Pro plans, the "+5 plans" add-on and the AI-generation packs, with prices.

## Documentation

- [Docs overview — all guides.](https://travelswallow.app/de/docs)
- [Getting started — your first plan in minutes.](https://travelswallow.app/de/docs/getting-started)
- [Bring your own key — which providers are supported and where the key is stored.](https://travelswallow.app/de/docs/bring-your-own-key)
- [The builder — building and editing a plan by drag-and-drop.](https://travelswallow.app/de/docs/builder)
- [AI quiz — generating a full plan from a short preferences quiz.](https://travelswallow.app/de/docs/ai-quiz)
- [Publishing & passwords — sharing, privacy and password protection.](https://travelswallow.app/de/docs/publishing)
- [Themes — the eight per-country designs and how they are chosen.](https://travelswallow.app/de/docs/themes)
- [Self-hosting — run your own instance under the AGPL.](https://travelswallow.app/de/docs/self-hosting)
- [FAQ — common questions about cost, the plan limit, privacy and AI.](https://travelswallow.app/de/docs/faq)

## Legal

- [Impressum — provider identification (Austrian/EU law).](https://travelswallow.app/de/rechtliches/impressum)
- [Privacy policy (Datenschutz) — GDPR data-processing details.](https://travelswallow.app/de/rechtliches/datenschutz)
- [Terms of service (AGB).](https://travelswallow.app/de/rechtliches/agb)
- [Right of withdrawal (Widerruf) — for any future paid features.](https://travelswallow.app/de/rechtliches/widerruf)

## App (require an account; not indexed)

- The AI quiz, the drag-and-drop builder, the "My plans" dashboard, account settings and published-plan pages are part of the signed-in app. They are intentionally excluded from search engines and from this list.

## Source

- [GitHub repository](https://github.com/travelswallow/travelswallow): source code, issues and contribution guide.