mirror of
https://github.com/mauriceboe/TREK.git
synced 2026-10-18 21:16:47 +00:00
Maurice
7da0080557
* docs(wiki): correct the install and operations pages for 4.0.0 Quick Start passed docker an empty ENCRYPTION_KEY: an assignment prefix is not expanded on the same command line, so the server silently generated its own key instead of taking the one the page told you to set. The tag examples pinned to the 3.x line, the documented tmpfs size did not match the shipped compose file, and several .env values were described as reaching the container when compose never interpolates them. * docs(wiki): match the MCP reference to the registered surface The scope table was missing the whole Collections group and the totals said 27 scopes across 13 groups where the code registers 29 across 14. The Cloudflare link on the setup page pointed at an anchor on its own page instead of the heading on Troubleshooting. * docs(wiki): correct the plugin and admin pages Three links to Plugin-Development carried a .md suffix, which does not resolve on the wiki. The admin pages described tabs, permissions and storage behaviour that had moved on. * docs(wiki): bring the feature pages back in line with the app Costs still documented the old panel, where categories could be added, renamed, reordered and deleted; they are fixed now and the panel is a day-grouped ledger with settlements. Trip sharing, journeys, maps, packing, reservations and the account pages had all drifted in the same way. * docs(wiki): cover the pages the first pass did not reach The MCP catalog listed 168 of the 201 registered tools; the settlement tools and rate_place were missing here and the Collections family from the addon page. Several resource rows claimed a trips:* scope where the handler asks for trips:read. * docs(wiki): tighten the corrections a review picked apart The audit-log resource is the row id, not the credential id; an admin password reset does not bump password_version the way the page implied; and a few of the new paragraphs described behaviour more confidently than the code supports. * docs(wiki): fix what a last read-through caught Costs shows every figure in your display currency, not the trip's, and an expense with no payer still counts against the members it is split between. Studio's cutoff is a 1024px viewport rather than phones alone, and the Integrations tab is gated on the providers an admin has configured. * docs(wiki): the last few the review caught A passkey satisfies the MFA policy everywhere except the WebSocket handshake, which still asks for TOTP, so a passkey-only account under that policy gets no live updates. Mobile optimizes a day from two places, not three. The ctx.db row carried an unescaped pipe that split the table, and the Backups table linked with a wiki link whose pipe did the same.
100 lines
5.2 KiB
Markdown
100 lines
5.2 KiB
Markdown
# Appearance Settings
|
|
|
|
Tune how TREK looks — colour mode, accent scheme, readability, and which dashboard widgets you see.
|
|
|
|
|
|
|
|
## Where to find it
|
|
|
|
Open **Settings** and select the **Appearance** tab.
|
|
|
|
Changes preview instantly and are saved to your account a moment later, so they follow you to every browser you sign in with. A **Reset to defaults** button at the bottom of the tab restores the colour scheme, the readability settings, the dashboard widgets and the mobile layout in one click. Your **Color mode** (Light / Dark / Auto) is a separate setting and is left as it is.
|
|
|
|
> These are personal settings — no permission and no admin toggle gate them.
|
|
|
|
## Theme
|
|
|
|
### Color mode
|
|
|
|
Three segmented buttons: **Light**, **Dark**, and **Auto**. **Auto** follows your operating system's light/dark preference.
|
|
|
|
### Color scheme
|
|
|
|
A grid of accent schemes, each with a colour dot that previews in your current mode:
|
|
|
|
- **Default** — TREK's monochrome look.
|
|
- **High contrast** — raises text and border contrast.
|
|
- **Indigo**, **Teal**, **Rose**, **Amber**, **Violet** — coloured accents.
|
|
- **Custom** — pick your own accent (below).
|
|
|
|
### Custom accent
|
|
|
|
Choosing **Custom** reveals a **Custom accent** picker:
|
|
|
|
1. Click one of the ten preset swatches to set light and dark to the same colour, or
|
|
2. Use the **Light** and **Dark** colour inputs to pick a different accent for each mode.
|
|
|
|
Next to the pickers, a live contrast badge evaluates the accent you are currently seeing against white and shows the ratio:
|
|
|
|
- **Good contrast (n.n:1)** — the ratio meets WCAG AA for normal text (4.5:1 or better).
|
|
- **Low contrast (n.n:1)** — below 4.5:1; white text on that accent will be hard to read.
|
|
|
|
The badge is advisory. TREK will still let you apply a low-contrast accent.
|
|
|
|
## Readability
|
|
|
|
This whole section carries an **Experimental** badge.
|
|
|
|
- **Transparency** — *Glassy translucent surfaces. Turn off for solid, higher-contrast backgrounds.*
|
|
- **Reduce motion** — *Minimize animations and transitions.*
|
|
- **Density** — **Comfortable** or **Compact**. *Compact tightens spacing and padding for a denser layout that fits more on screen.*
|
|
|
|
### Text size
|
|
|
|
Text scaling works on four axes plus one master control. Every slider runs from **80%** to **160%** in 5% steps, and shows its current percentage on the right.
|
|
|
|
- **Everything** — a global scale applied on top of the per-tier values.
|
|
- **Large** — *Headings, big numbers*
|
|
- **Medium** — *Sub-headings*
|
|
- **Normal** — *Place names, descriptions*
|
|
- **Small** — *Addresses, labels*
|
|
|
|
Each of the four rows renders a live sample in that tier ("Large heading", "Medium subtitle", "Normal body text", "Small caption / address"), so you can see the effect while dragging.
|
|
|
|
## Dashboard widgets
|
|
|
|
*Show or hide dashboard widgets independently on desktop and mobile.* This does not detect your current device — it sets two independent layouts, and the dashboard picks the one matching the viewport it is rendered at. Both layouts are stored on your account, so a change made on your laptop also changes what your phone shows.
|
|
|
|
### Desktop
|
|
|
|
- **Below the hero** — **Atlas / countries**, **Trips total**, **Days traveled**, **Distance flown**.
|
|
- **Right sidebar** — a master toggle (*The whole right column. Turn off and the dashboard centers.*) with four widgets nested under it: **Currency**, **Collections**, **Timezones**, **Upcoming reservations**. Turning the master off greys the nested toggles out; their individual states are remembered for when you turn it back on.
|
|
|
|
### Mobile
|
|
|
|
- **Below the hero** — **Trips total**, **Days traveled**.
|
|
- **Bottom of page** — **Currency**, **Collections**, **Timezones**, **Upcoming reservations**.
|
|
|
|
Hiding a widget here only affects your own dashboard. Widgets that depend on an addon (for example **Collections**) also need that addon enabled by an admin — see [Dashboard-Widgets](Dashboard-Widgets) and [Admin-Addons](Admin-Addons).
|
|
|
|
## On a phone
|
|
|
|
Opened on a phone, the Appearance screen carries an extra **Mobile** card that the desktop tab does not have:
|
|
|
|
- **Bottom navbar** — which items sit in the bottom bar, in which order, and which are demoted under **More**. **Dashboard** is pinned first and cannot be moved; two more items fit next to it, and a counter above the list shows how full the bar is. Leaving both lists untouched keeps TREK's automatic split.
|
|
- **Dashboard order** — reorder how the trip list and the inline widgets stack on the phone dashboard. The featured trip always stays on top. A block whose widget is switched off under **Dashboard widgets** keeps its place in the list and is marked **Hidden**.
|
|
|
|
Both are stored on your account alongside the rest of the appearance settings, and both are cleared by **Reset to defaults**.
|
|
|
|
## Permissions
|
|
|
|
None. Every setting on this tab applies only to your own account.
|
|
|
|
## See also
|
|
|
|
- [Display-Settings](Display-Settings)
|
|
- [User-Settings](User-Settings)
|
|
- [Dashboard-Widgets](Dashboard-Widgets)
|
|
- [My-Trips-Dashboard](My-Trips-Dashboard)
|
|
- [Map-Settings](Map-Settings)
|