k1nq/TREK

mirror of https://github.com/mauriceboe/TREK.git synced 2026-06-19 13:21:46 +00:00

Files

T

jubnl c1b9d11173 docs: add full wiki with 74 pages, assets, and CI workflow

Adds the complete TREK documentation wiki covering installation,
trip planning, admin panel, MCP/AI integration, addons, and operations.

Also fixes encrypt-at-rest gaps: mapbox_access_token, Synology
credentials, per-user webhook/ntfy tokens, and photo passphrases
are now rotated by migrate-encryption.ts and stored encrypted via
settingsService.

2026-04-20 10:11:53 +02:00

3.2 KiB

Raw Blame History

Journey Journal

Journey is a photo-first travel journal. Each journey is linked to one or more of your trips and contains per-day entries with text, photos, mood, and weather.

Admin: enable Journey in Admin-Addons.

What Journey is

Journey lets you write a narrative account of your travels alongside your trip plan. Entries are tied to specific days and can include prose, photos, a mood rating, weather conditions, and verdict cards. Completed journeys can be shared publicly with a read-only link.

Accessing Journey

When the admin has enabled the Journey addon, a Journey entry appears in the main navigation. The Journey list page shows all your journals as cards with cover images, entry counts, photo counts, and place counts.

Creating a journey

From the Journey list, click Create journey. Give it a title and optional subtitle, then select one or more existing trips to link. Linking a trip imports the trip's places as location anchors for your entries. You can link additional trips later from the journal settings.

Journal entries

Each entry corresponds to a day in your journey. The entry editor provides:

Title — a short heading for the day.
Story — free-form text that supports Markdown formatting.
Mood — choose one of four values:

ID Label Color

amazing Amazing Pink

good Good Amber

neutral Neutral Grey

rough Rough Violet
Weather — choose one of six values: Sunny, Partly cloudy, Cloudy, Rainy, Stormy, Cold.
Photos — attach photos to the entry. The first photo becomes the card thumbnail in list views.
Pros / Cons — optional verdict cards. Add items to a Pros list (thumbs-up) or a Cons list (thumbs-down) to summarise what you loved or what could have been better. These are stored in the pros_cons.pros and pros_cons.cons arrays on the entry.
Tags — free-form labels (e.g. "hidden gem", "best meal").
Location — pin the entry to a map location.
Time — optionally record a time of day for the entry.

ID	Label	Color
`amazing`	Amazing	Pink
`good`	Good	Amber
`neutral`	Neutral	Grey
`rough`	Rough	Violet

Mobile timeline

On mobile, entries are displayed in a horizontal scrolling timeline of card thumbnails. Tap a card to open the full entry view in a modal sheet. Each card shows the entry's first photo (or a placeholder pin), date, day number, mood icon, and weather icon.

Map view

The journey detail page includes a map on the right (desktop) or an integrated map-timeline (mobile) showing all entry locations alongside the places from linked trips.

You can share a journey with a read-only public link. When creating the link you can independently toggle which sections are visible to visitors: Timeline (entries and stories), Gallery (photos), and Map. Visitors can only see the sections you have enabled, and no TREK account is required. See Public-Share-Links for details on the separate journey share token mechanism.

3.2 KiB Raw Blame History