TREK

<div align="center"> <picture> <source media="(prefers-color-scheme: dark)" srcset="docs/logo-trek-light.svg" /> <source media="(prefers-color-scheme: light)" srcset="docs/logo-trek-dark.svg" /> <img src="docs/logo-trek-dark.svg" alt="TREK" height="96" /> </picture> <br /> <picture> <source media="(prefers-color-scheme: dark)" srcset="docs/subtitle-light.png" /> <source media="(prefers-color-scheme: light)" srcset="docs/subtitle-dark.png" /> <img src="docs/subtitle-dark.png" alt="your trip. your plan." height="28" /> </picture>

A self-hosted, real-time collaborative travel planner — with maps, budgets, packing lists, a journal, and AI built in.

<br />

<a href="https://demo.liketrek.com"><img alt="Demo" src="https://img.shields.io/badge/Demo-try-111827?style=for-the-badge" /></a>   <a href="https://hub.docker.com/r/mauriceboe/trek"><img alt="Docker" src="https://img.shields.io/badge/Docker-ready-2496ED?style=for-the-badge" /></a>   <a href="https://sonarcloud.io/project/overview?id=liketrek_TREK"><img alt="Sonar Quality Gate" src="https://img.shields.io/sonar/quality_gate/liketrek_TREK?server=https%3A%2F%2Fsonarcloud.io&style=for-the-badge" /></a>   <img alt="GitHub Actions Workflow Status" src="https://img.shields.io/github/actions/workflow/status/liketrek/TREK/test.yml?branch=main&style=for-the-badge">   <a href="https://discord.gg/NhZBDSd4qW"><img alt="Discord" src="https://img.shields.io/badge/Discord-join-5865F2?style=for-the-badge" /></a>   <a href="https://kanban.pakulat.org/shared/I4wxF6inOOMB0C6hH6kQm3efyNxFjwyI"><img alt="Roadmap" src="https://img.shields.io/badge/Roadmap-view-0EA5E9?style=for-the-badge" /></a>   <a href="https://ko-fi.com/mauriceboe"><img alt="Ko-fi" src="https://img.shields.io/badge/Ko--fi-support-FF5E5B?style=for-the-badge" /></a>   <a href="https://www.buymeacoffee.com/mauriceboe"><img alt="BMAC" src="https://img.shields.io/badge/BMAC-support-FFDD00?style=for-the-badge" /></a> <br /> <a href="LICENSE"><img alt="License" src="https://img.shields.io/badge/license-AGPL_v3-6B7280?style=flat-square" /></a> <a href="https://github.com/liketrek/TREK/releases"><img alt="Latest Release" src="https://img.shields.io/github/v/release/liketrek/trek?include_prereleases&style=flat-square&color=6B7280" /></a> <a href="https://hub.docker.com/r/mauriceboe/trek"><img alt="Docker Pulls" src="https://img.shields.io/docker/pulls/mauriceboe/trek?style=flat-square&color=6B7280" /></a> <a href="https://github.com/liketrek/TREK"><img alt="Stars" src="https://img.shields.io/github/stars/liketrek/trek?style=flat-square&color=6B7280" /></a>

</div>

---

<div align="center"> <img src="https://github.com/mauriceboe/trek-media/releases/download/readme-assets/TREK2.webp" alt="TREK, a tour of the app" width="100%" /> </div> <br />

What you get

<picture> <source media="(max-width: 700px)" srcset="docs/tiles/grid-mobile.svg" /> <source media="(prefers-color-scheme: dark)" srcset="docs/tiles/grid-desktop-dark.svg" /> <img src="docs/tiles/grid-desktop.svg" alt="Plan, track, share" width="100%" /> </picture> <details> <summary><b>See all features</b></summary> <br />

Most of what follows is an addon an admin switches on or off. Lists, Costs, Documents, Collab, Tours, Vacay and Atlas ship on; Journey, Collections, MCP, the AI assistant, AI Parsing, Road trip, Dawarich and AirTrail ship off and are marked below.

<table> <tr> <td width="50%" valign="top">

🧭 Planning

• Day plans: drag places, notes and bookings between days with undo, or drop a map marker straight onto a day
• Maps: Leaflet, Mapbox GL or MapLibre GL (OpenFreeMap, no token) with clustering, photo markers, route lines and a whole-trip route overview
• Places: search the TREK Places index and OpenStreetMap with no key, or Google Places and Amap with one. Descriptions, hours and photos from Wikipedia, Wikidata and Wikimedia Commons, plus a rating and a custom image per place
• Explore: nearby places by category for the map view, from the TREK Places index with Overpass as fallback
• Routes: auto-sort a day (nearest neighbour then 2-opt, locked stops and hotels stay put), a travel mode per leg over OSRM or Valhalla, then open the day in Google Maps or CoMaps and a place in seven navigation apps
• Public transport: door-to-door itineraries over Transitous, or Google where Transitous has no data
• Import and export: Google Maps and Naver Maps lists, Google Maps directions links, GPX, KML and KMZ in; GPX and an ICS feed per trip or across all trips out
• Weather: 16-day forecast from Open-Meteo, no key, and the archive for dates beyond it
• Trip dates: move a trip and its days re-date themselves, with the bookings along or re-anchored. Trips also copy and archive
• Road trip (off by default): drives with stops, day windows and arrival times that recompute, route alternatives, hazards and EV charging with range

</td> <td width="50%" valign="top">

🥾 Tours

• Seven tour types: hike, city walk, run, bike (touring, road, gravel, MTB), paddle (kayak, canoe, SUP), horse ride, and ski and winter (alpine, cross-country, touring, snowshoe, winter hike)
• Routing: legs routed over Valhalla with shaping points, hand-drawn legs, route variants, round hikes of a wished length and trip places as stops, all with undo
• Hikes: routed within a maximum SAC grade (T1 to T6), the trail grades along the way, and via ferratas on the map
• Terrain: elevation profile, ascent and descent, and a 3D terrain map with grade colouring and a flyover, no token needed. Topo, hiking, cycling and satellite bases with sea marks and ski pistes as overlays
• Multi-day tours: one route cut into stages and spread across the trip's days
• Along the way: viewpoints, huts, water, food and more within a corridor of the route, inserted as a stop with the detour it adds
• Ski, paddle and city walks: a piste router by difficulty and lift type; a water router with portages, locks and a wind forecast; city walks with stays, opening hours and transit between stops
• Plan against reality: link a recorded GPX to a planned day and compare distance, ascent and time. Import trails from a wanderer instance, save tours to a collection and take them into another trip

</td> </tr> <tr> <td width="50%" valign="top">

🧳 Bookings and money

• Reservations: 18 booking types with status, confirmation code, travellers and attached files
• Flights and trains: several legs with stopovers and endpoint timezones, against 4,045 bundled airports so local times resolve without a key
• Accommodation: a stay spans a range of nights with a check-in window
• Booking import: EML, PDF, PKPass, HTML, TXT and photos of confirmations, through KItinerary or an AI model, with a review step before anything is saved. Prices become linked costs
• AirTrail (off by default): import flights from a self-hosted AirTrail instance and keep them in sync
• Costs: split in integer cents with equal or custom shares, several payers, settle-up suggestions, a per-person summary, a settlement log and CSV export. A receipt photo can fill in an expense
• Currencies: one per expense with the rate frozen at entry, from Frankfurter with no key
• Packing lists and to-dos: categories, templates, assignees and visibility tiers; bags with weights as an admin switch; to-dos with due dates, priorities and reminders
• Files: attach to a trip, place, day or booking, 50 MB each and 500 MB for video, with trash and restore
• PDF export: cover, place photos, day notes, bookings and costs, with an optional page break per day

</td> <td width="50%" valign="top">

👥 Collaboration

• Real-time sync (WebSocket): edits land live for everyone who has the trip open
• Members: add by email or username, hand over ownership, or add guests who have no login at all
• Permissions: an admin maps each of 17 trip actions to admin, trip owner, trip member or everybody
• Invites: one reusable link per trip with an optional expiry, and admin signup invites that drop a new account straight into a trip
• Public share: a read-only trip page without an account, with switches for map, bookings, packing, costs and chat
• Collab: group chat with replies, reactions and link previews, shared notes, links, polls and a What's Next list, each one its own switch
• Notifications: an inbox grouped by day with answers right from the notification, and a per-user matrix of events against in-app, email, webhook, ntfy, Web Push and plugin channels

</td> </tr> <tr> <td width="50%" valign="top">

📔 Journey and TREK Studio

• Journey (off by default): dated entries with story, mood, weather and tags, photos and video from uploads, Immich or Synology Photos, map views, co-authors, drafts and a public share link
• Linked journal: a trip can show one journal as its own, with the members picked on the trip as viewers or editors
• Recorded days (with Dawarich): keep a day's recorded route and turn its stays into entries
• TREK Studio: turn a journal into a printable photo book. 34 print-licensed typefaces, 17 themes, 108 designed pages in twelve styles, 160 recolourable stickers, text effects, layers and a Travel tab with route maps, country stamps and trip figures
• Auto layout: lays the whole book on the designed pages in the style of its theme, every photo in a frame, or rebuilds one spread
• Print and share: PDF export as pages or spreads with crop marks, several people editing at once, and design files to move a spread into another book

</td> <td width="50%" valign="top">

🗺️ Atlas, Vacay and Collections

• Atlas: countries and regions visited on geoBoundaries outlines, a bucket list, travel stats, and a tour activities tab with planned against recorded totals
• Vacay: leave calendar with half days, public holidays from date.nager.at, school holidays for 16 European countries, company holidays, carry-over between years, and joint or read-only sharing
• Collections (off by default): a place library outside any trip with lists, labels, ratings, a status per place, cover images, GPX and file export, copy into a trip, and sharing by invite
• Dawarich (off by default): link a Dawarich instance for recorded tracks, suggested stays and countries for the Atlas

</td> </tr> <tr> <td width="50%" valign="top">

🤖 AI assistant and MCP

• AI assistant (off by default): a chat that plans with you in a trip, across all your trips, in a journal and in Studio, and works with tours, costs, bookings, packing, Vacay and the Atlas
• Your own model: an API key for Anthropic, OpenAI, Gemini or OpenRouter, a ChatGPT plan, or any OpenAI-compatible endpoint, set for the instance or per user
• You stay in charge: reads run at once, every change waits as a card to apply or discard and can be undone for 15 minutes. Nothing leaves before you agree to the provider, and a file's text only with your consent
• Attachments: drop a booking confirmation, a GPX file or a photo into the chat, and the assistant offers what to do with it
• MCP server (off by default): OAuth 2.1 with mandatory PKCE and dynamic client registration, 410 tools, 30 resources and 4 prompts, 35 scopes in 17 groups ticked on the consent screen, and every call in the audit log
• Addon-aware: twelve addon gates decide which tools a session sees, and flipping one re-registers live sessions

</td> <td width="50%" valign="top">

🧩 Plugins

• Third-party plugins: install from the TREK registry or sideload a zip, with their own pages under /plugins/<id>
• Sandboxed: one child process per plugin, 66 grantable permissions, an admin-edited outbound host allowlist, memory and call caps
• Trust: registry downloads are pinned by