k1nq/TREK

mirror of https://github.com/mauriceboe/TREK.git synced 2026-10-18 21:16:47 +00:00

Files

T

Maurice af9710c618 docs(wiki): the pictures that were missing, and the follow-ups of the rewrite

The wiki pictures of the trip are taken again with the fixtures the help
guides use, so the Bookings tab shows a booking of every kind, Files has
documents and What's Next has something ahead. New pictures: the map's
hover card, the Subscribe to calendar dialog, the PDF preview, the To-Do
view, and the Transports tab's own timeline and booking detail. Day
selection in the screenshot run clicks the day's number, now that the
middle of a day header is the booked night.

Home, Real-Time Collaboration, Road Trip, Map Features and the bookings
page are brought in line with the rewritten pages, and sixteen assets no
page uses any more (mostly old GIFs, 22 MB) are removed.

2026-09-28 12:19:49 +02:00

6.7 KiB

Raw Blame History

TREK Wiki

TREK is a self-hosted, real-time collaborative travel planner licensed under AGPL-3.0.

Features

Planning

Drag & Drop Planner: organize places into day plans with reordering and cross-day moves
Interactive Map: Leaflet map with photo markers, clustering, route visualization, and customizable tile sources
Place Search: TREK's own place index and OpenStreetMap, asked together, with no API key and no quota; Google or Amap answer only where both come up empty (see TREK Places API)
Day Notes: notes between a day's stops, each with a title, Markdown text, an icon and a colour
Route Optimization: auto-optimize place order and hand the day to Google Maps or CoMaps
Weather Forecasts: 16-day forecasts via Open-Meteo (no API key required), historical climate averages as fallback

Travel Management

Reservations & Bookings: hotels, restaurants, tickets and every other booking with its confirmation code, travelers, costs and files, shown as cards, as a list or on a timeline; flights, trains and cars have their own Transports tab
Budget Tracking: an expense ledger with who paid and itemised splits, settle-up, receipts, a table view with per person and per day figures, multi-currency support (see Currencies)
Packing Lists: category-based checklists with user assignment, templates, and progress tracking
Document Manager: attach documents, tickets, and PDFs to trips, places, or reservations (up to 50 MB per file)
Document Sync (admin-enabled): keep a trip's documents in step with a self-hosted Paperless-ngx, Papra, Nextcloud, OpenCloud or Synology NAS, in both directions, under one connection the trip owner sets up for every member (see Document Sync)
PDF Export: export complete trip plans as PDF with cover page, images, and notes

Collaboration

Real-Time Sync: WebSocket-based live sync; changes appear instantly for all connected users
Multi-User: invite members with role-based access
Invite Links: registration links with configurable max uses (1 to 5, or unlimited) and expiry
OIDC SSO: sign in with Google, Apple, Authentik, Keycloak, or any OIDC provider
Two-Factor Authentication: TOTP-based 2FA with QR code setup
Passkeys (admin-enabled): passwordless WebAuthn sign-in with Touch ID, Windows Hello, Android screen lock, or a hardware key; owning one also satisfies the require-2FA policy (see Passkeys)
Public Share Links: share a read-only view of any trip

Addons (admin-toggleable)

Lists: packing lists and to-dos with templates, member assignments, optional bag tracking
Costs: expense tracker with category breakdown, splits, multi-currency
Documents: file manager for trips, places, and reservations
Collab: group chat, shared notes, polls, day-by-day attendance
Road trip: plan a trip as one continuous drive, with search along the route, driving limits, daily travel times and avoidance of toll roads, motorways and ferries (see Road Trip)
Vacay: personal vacation day planner with calendar view, public holidays, and carry-over tracking
Atlas: interactive world map, bucket list, travel stats, continent breakdown
Collections: a personal place library that saves places across trips into named lists, copies them into any trip, and shares them with per-member roles (see Collections)
Journey: magazine-style travel journal with entries, photos (via Immich/Synology Photos), maps, and moods
Naver List Import: import places from shared Naver Maps lists
MCP: expose TREK to AI assistants via the Model Context Protocol (OAuth 2.1)
AirTrail: sync flights from your self-hosted AirTrail instance into trips
Dawarich: read the stays and routes your self-hosted Dawarich instance recorded, offered as suggestions you confirm; nothing is written back (see Dawarich)
AI Parsing: LLM fallback that extracts bookings from confirmation files KDE Itinerary cannot read (see AI-Booking-Import)

Dashboard widgets (currency converter and timezone clock) are per-user preferences, not an admin-toggleable addon; see Dashboard-Widgets.

The full addon table, with type and per-addon notes, lives in Addons-Overview.

Plugins

Sandboxed Plugin Runtime: third-party plugins run in a forked child process with permission-gated RPC, install-time manifest and signature checks, and an egress allowlist (see Plugins)
Plugin SDK: build and publish plugins with the trek-plugin-sdk npm package, with dev server, preflight, signing and submit (see Plugin-Development)

AI / MCP Integration

MCP Server: built-in Model Context Protocol server with OAuth 2.1 authentication
150+ Tools: create trips, plan itineraries, manage budgets, send messages, and more
30 Resources: read-only trek:// URIs for trips, days, places, budget, packing, journeys, and more
35 OAuth Scopes: granular permissions across 17 permission groups
Pre-built Prompts: trip-summary, packing-list, and budget-overview context loaders

Help

Help Center: the ? in the navbar opens guides for the screen you are on, with a picture of every step and search across guides and the wiki, in every language TREK speaks (see Help Center)
In-App Help: the whole wiki, bundled with your install and read inside TREK at /help (see In-App Help)

Admin

User management, invite links, packing templates, global categories
Addon management, API key storage, scheduled auto-backups
System notices for onboarding and announcements, including a release notes notice every user sees once after each update (see Admin-GitHub-Releases)

Admin: Most configuration lives in the Admin Panel. On first boot TREK seeds an admin account automatically: credentials come from ADMIN_EMAIL / ADMIN_PASSWORD if set, otherwise a random password is printed to the container log.

Get Started


Quick Start	Install in minutes with a single Docker command
My Trips Dashboard	Start planning your first trip
Help Center	The `?` in the navbar: guides for the screen you are on
Admin Panel	Configure your instance
MCP / AI Integration	Connect Claude, Cursor, or any MCP client
Contributing	Guidelines for submitting pull requests
Development Environment	Set up a local dev environment

6.7 KiB Raw Blame History