Trip Planning

Creating a Trip

1. On the Dashboard, click the + button
2. Enter trip name, description, start/end dates, and currency
3. Drag & drop a cover image directly onto the upload area, or click to upload, or paste from clipboard
4. Add members — invite other users during trip creation via the member dropdown
5. Dates can be entered manually by double-clicking the date picker fields (supports DD.MM.YYYY, YYYY-MM-DD)
6. Click Create — TREK auto-generates day entries based on your dates (up to 90 days)

Dashboard

• Grid / List toggle — switch between card grid and compact list view (saved in localStorage)
• Currency converter widget — 50 currencies, toggleable
• Timezone clock widget — toggleable
• Trip cards show cover image, dates, member avatars, and progress

Adding Places

In the trip planner:

1. Click + Add Place or use the map to add locations
2. Fill in name, address, category, and time
3. If Google Maps API is configured, you can search for places and auto-fill details (ratings, opening hours, photos)
4. Without Google API, OpenStreetMap search (Nominatim) works out of the box
5. Right-click on the map to add a place with auto reverse geocoding

Place Details

Each place can have:

• Category — Accommodation, Restaurant, Sight, Shopping, Transport, Activity, Bar/Cafe, Beach, Nature, Other (customizable by admin)
• Start time & End time — When to visit
• Duration — How long the visit takes
• Notes — Personal notes with text
• Description — Longer text description (toggleable in Settings)
• Website & Phone — Contact information
• Tags — Custom labels with colors for filtering
• Price — Cost with currency
• Photos — From OSM/Wikimedia Commons enrichment or Google Places

Importing Places

• GPX file import — Upload .gpx files to auto-create places from waypoints. Supports <wpt>, <rtept>, <trkpt>, CDATA names, and any lat/lon attribute order
• Google Maps URL — Paste any Google Maps URL into the search bar (short URLs, full place URLs, embedded coordinates). TREK resolves the URL and extracts the location
• OSM Enrichment — When a place is created from the map, TREK auto-fetches opening hours, website, phone, and a photo from OpenStreetMap/Wikimedia Commons (no Google API required)

Day Planning

• Drag & drop places between days to organize your schedule
• Reorder places within a day using drag & drop or arrow buttons
• Day notes — Add timestamped notes with custom icons (e.g. flight times, reminders)
• Unassigned places stay in the place list until you assign them to a day
• Timed places auto-sort chronologically when a time is added
• Chronological enforcement — Moving a timed place out of order triggers a confirmation popup
• Participant assignment — Assign trip members to specific places on a day

Transport Bookings in Timeline

Flight, train, bus, car, and cruise bookings appear directly in the day plan timeline as compact cards:

• Shows transport icon, time, and key booking details (airline, flight number, airports, etc.)
• Click to open the full reservation detail modal
• Places can be dragged and positioned between transport entries
• Persistent positioning stored in the database

Accommodations

• Multi-day accommodations — Assign a hotel/accommodation to one or multiple days
• Check-in/check-out times and confirmation numbers
• Day badges — Green badge for check-in day, red for check-out
• Multiple hotels per day supported
• Hotel reservations automatically create accommodation entries (bidirectional sync)

Map View

• All places show as markers on the interactive map with category-colored icons
• Click a marker to see place details
• Category filter — Multi-select dropdown to filter map pins by category
• Tag filter — Filter places by tags
• Route visualization — Lines between places on the same day
• Route travel times — Walking + driving time badges on each route segment (OSRM, free). Toggle in Settings → Display
• Route optimization — Auto-sort places by shortest route
• Export to Google Maps — Open the day's route in Google Maps for navigation
• Live GPS location — Blue dot showing your current position with accuracy circle (toggle button bottom-right)
• Cluster markers — Places cluster when zoomed out, with count badges
• Right-click to add — Right-click anywhere on the map to add a place with auto-filled address

Reservations / Bookings

Create bookings in the Bookings tab with type-specific fields:

Type	Special Fields
Flight	Airline, flight number, departure/arrival airports
Train	Train number, platform, seat
Bus	Bus number, platform, seat
Car Rental	Pick-up/drop-off location
Cruise	Cruise line, cabin
Accommodation	Check-in/out dates and times, auto-links to day accommodations
Restaurant	Party size
Activity	Duration, provider
Other	General purpose

All types share: confirmation number, status (pending/confirmed/cancelled), notes, linked files, cost, and URL.

ICS Calendar Export

Export your trip as an .ics calendar file:

• Click the calendar icon in the trip planner navbar
• Downloads an ICS file with events for each day (places with times become calendar entries)
• Import into Google Calendar, Apple Calendar, Outlook, or any calendar app

Sharing Trips

1. Click the Share button in the trip planner navbar
2. Enter a username or email to invite — members can view and edit in real-time
3. For read-only public links, see Public Share Links

Cover Images

Upload a cover image for each trip — shown on the dashboard cards and shared pages. Supports JPG, PNG, WebP up to 20 MB. Can be set during trip creation or editing.

Settings

User-configurable display options:

Setting	Options
Dark mode	Light, Dark, Auto (follows system)
Language	English, German, Spanish, French, Russian, Chinese, Dutch, Arabic, Portuguese (BR), Czech, Hungarian, Italian, Polish
Temperature	Celsius / Fahrenheit
Time format	12h / 24h
Show place description	On / Off
Blur booking codes	On / Off — blurs confirmation codes, hover to reveal