Getting Started

Navigating Trailkeep

A quick map of the dashboard layout — where things live and how to get to them.

📸

Screenshot coming soon

Trailkeep dashboard: sticky header (logo, preferences, user menu), planner toolbar (Start, Plan, Trip, Pack, Share), and main content area below.

The header

The dashboard header runs across the top of the screen. It contains controls that are used less frequently but matter when you need them:

ElementWhat it does
Theme toggleSwitch between Light, Dark, and System theme
Preferences (⚙)Display toggles — controls what columns and fields are visible in the planners
User menu (your avatar)Access settings, import/export CSV, help, and log out

Dashboard navigation

The dashboard navigation has two levels:

  • Start — your daily-use cockpit. Tap Go to start a trip, check in each day, and finish when you're back. When a trip is active this becomes the primary command surface, showing return-by monitoring, today's progress, the check-in timeline, and the Check-in Timer.
  • Plan — the planning tools, with a secondary switch between:
    • Trip — multi-day itineraries, waypoints, GPX routes, safety
    • Pack — gear lists, gear vault, weight tracking

Start is where you use the plan on trail; Plan is where you build it.

Connection status

When you are offline or changes are syncing, a compact connectivity strip appears directly under the Start / Plan tabs with tab-specific guidance (for example, View only — Reconnect to edit packs and use the vault on Pack, or 2 changes saved on device · Tap for details when edits are queued). After reconnecting, it briefly shows Back online — Your changes are synced. Tap the strip when pending or sync paused to see what is waiting. See Offline and mobile for the full list of states.

The small dot on your avatar (top right) is a secondary always-visible indicator:

  • Green — connected and in sync
  • Amber (pulsing) — syncing offline changes to the server
  • Red — offline

User menu

Click your avatar (top right) to open the user menu.

📸

Screenshot coming soon

User dropdown open showing: Settings, expandable Import and Export sections, Help, Send feedback, Logout. The avatar has a green connection dot in the bottom-right corner.

ItemWhat it does
SettingsOpens the account settings panel as an overlay — you stay on the dashboard
ImportExpands to show CSV file (Trailkeep or LighterPack CSV) and LighterPack URL (paste a share link)
ExportExpands to show CSV file — export gear lists or trips
HelpOpens these docs in a new tab
Send feedbackSend feedback, report a bug, or ask a question
LogoutLogs you out on this device and redirects to the homepage

Logout only ends your session on this device. If you are logged in on other devices, those sessions remain active until their tokens expire.

Preferences

The settings icon (⚙) in the header opens the Preferences panel — a set of toggles that control what detail is shown in the dashboard. Changes take effect immediately without a page reload.

Preferences sync across devices for your account.

There are three groups:

GroupToggles
GeneralDescription, Prices
Pack PlannerWorn items, Consumable items, Checklist mode
Trip PlannerWater sources, Resupply points, GPX mode
📸

Screenshot coming soon

Preferences panel open showing three groups of toggles: General (Description, Prices), Pack Planner (Worn items, Consumable items, Checklist mode), Trip Planner (Water sources, Resupply points, GPX mode).

Each preference is explained near the feature it affects. Quick reference:

  • Description — adds a description field to lists and trips with basic formatting (bold, italic, lists, links; single line breaks preserved; 5,000 character maximum)
  • Prices — adds a cost field to gear items and waypoints
  • Worn items — shows a worn toggle on item rows; worn items are excluded from base weight (on by default)
  • Consumable items — shows a consumable toggle on item rows; consumables are excluded from base weight (on by default)
  • Checklist mode — adds a checkbox to each item row for packing verification; checks are private and never shown on shared lists
  • Water sources — shows a water source button on waypoint rows (on by default)
  • Resupply points — shows a resupply button on waypoint rows (on by default)
  • GPX mode — enables the full GPX workflow in the Trip Planner: upload button, route map, and export (on by default)

The settings window

Click your avatar → Settings to open the full account settings panel. It opens as an overlay — you do not leave the dashboard. See Account settings for what each tab contains.

Planner toolbar

The planner toolbar sits below the header and is the main navigation control for the dashboard.

📸

Screenshot coming soon

Planner toolbar showing Start tab button, Plan tab button (active/highlighted), Trip | Pack buttons, and Share icon button.

The toolbar has the Start / Plan primary tabs, Trip / Pack buttons when Plan is active, and the Share button on the right.

Gear Vault

The Gear Vault is an icon-only control in the Pack list header (same style as collaborative editing on Trip), next to Add and the list picker. The gear icon turns blue when the panel is open. It is not in the global toolbar — only Pack content shows it (including the empty state when you have no lists yet).

Offline: the vault icon is disabled without signal. Pack lists remain view-only offline; open the vault while you have a connection. See Offline and mobile.

On desktop (≥1024px), the vault opens as a sticky sidebar beside your list. On screens below 1024px, it opens as a full-screen overlay — tap the backdrop or the X in the panel header to close it.

Start tab

Switches to the Start cockpit — quick start, planned-trip arm (Go), daily check-in, and return-by monitoring while a trip is active.

Plan tab

Opens the planning area. Use the Trip / Pack buttons beside it to move between planners:

  • Trip — trips, itineraries, waypoints, GPX routes, and safety features
  • Pack — gear lists, item weights, and the Gear Vault

If you leave Plan for Start and come back in the same browser tab, Plan reopens on whichever section you used last (Trip or Pack).

Share control

Copies the public link for the active planner — no dialog:

  • On Pack — share your current gear list (/gear-list/…)
  • On Trip — share your current trip (/trip/…); a gear list linked to the trip appears on that shared trip page when set

The link is created automatically when the Share control first loads. Tap Share (mobile) or the URL chip (desktop) to copy. To remove a gear list from the web, delete the list — there is no revoke button.

See Sharing a list and Sharing a trip.

The dashboard remembers which tab was open within your current session. Opening a fresh browser tab or window always starts on Start. Plan remembers your last Trip or Pack section for the rest of that tab session.