touch: beta_58 — beta_57 upgrade-bug repair (#229/#230), retry opt-in, Hungarian (#227), lock wallpaper (#228), P4 backups (#231)

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

.github/workflows/release.yml

@@ -62,7 +62,6 @@ jobs:
           [ -z "$TAG" ] && TAG="${GITHUB_REF_NAME}"
           echo "tag=$TAG" >> "$GITHUB_OUTPUT"
           echo "Building release: $TAG"
-
       - name: Build both touch boards (tag embedded; Wi-Fi placeholder, no baked creds)
         env:
           TAG: ${{ steps.v.outputs.tag }}
@@ -70,7 +69,6 @@ jobs:
           unset WIFI_SSID WIFI_PWD
           export PLATFORMIO_BUILD_FLAGS="-DFIRMWARE_RELEASE_TAG='\"${TAG}\"' -DFIRMWARE_VERSION='\"wadamesh ${TAG}\"'"
           for e in $ENVS; do pio run -t mergebin -e "$e"; done
-
       - name: Collect bins
         env:
           TAG: ${{ steps.v.outputs.tag }}
@@ -86,7 +84,6 @@ jobs:
             cp ".pio/build/$e/firmware-merged.bin" "dist/$n-merged.bin"
           done
           ls -la dist
-
       - name: Web-flasher metadata (version.json + manifests, roll with release)
         env:
           TAG: ${{ steps.v.outputs.tag }}
@@ -103,7 +100,6 @@ jobs:
             gh release create "$TAG" dist/* --title "wadamesh $TAG" \
               --notes "Touch firmware **$TAG** for the LilyGo T-Deck and Heltec V4 + TFT. Built by CI from \`$GITHUB_SHA\`."
           fi
-
       - name: Publish to wadamesh.com (VPS) — skipped until VPS secrets are set
         if: env.HAS_VPS == 'true'
         env:

.gitignore

@@ -28,6 +28,8 @@ scripts/build/wifi_secrets.h
 # Local working notes + agent config (contain ops/infra details — never publish)
 CLAUDE.md
 .claude/
+/dev-docs/
+/crash-dumps/
 
 # Custom timestamped build outputs
 /builds/

DEVICES.md

@@ -0,0 +1,51 @@
+# Supported devices
+
+Current hardware support, install paths and maturity. "Stable" means the board
+ships on the stable release channel; "Beta" means it is new and lives on the
+test channel until the next stable promote. Install links:
+[flasher.wadamesh.com](https://flasher.wadamesh.com) (browser, Chrome/Edge over
+USB) and the [GitHub releases](https://github.com/ALLFATHER-BV/wadamesh/releases).
+
+| Device | MCU / radio | Display and input | Install | Channel | Status |
+|---|---|---|---|---|---|
+| LilyGo T-Deck / T-Deck Plus | ESP32-S3, SX1262 | 2.8" 320x240 touch, QWERTY, trackball | Web flasher (standalone) or Launcher app image | Stable | Fully supported, reference device |
+| Heltec V4 + TFT | ESP32-S3, SX1262 | 2.4" 240x320 touch (CHSC6x) | Web flasher | Stable | Fully supported; Expansion Kit sensors, V4.3 high-gain RX toggle |
+| Tanmatsu | ESP32-P4 + ESP32-C6, SX1262 | 4" 800x480, 69-key keyboard (no touch) | Tanmatsu app store on the device (runs under the badge.team launcher, not web-flashable) | Store tracks the test channel | Fully supported; LoRa + Wi-Fi + Bluetooth simultaneously, standalone and companion in one |
+| Elecrow ThinkNode M9 | ESP32-S3, LR1110 | 2.4" 240x320 (no touch), I2C QWERTY + d-pad | Web flasher | Beta (new in beta_38) | Hardware-complete community port by ded (#138): GPS, microSD, buzzer, lock screen, d-pad navigation |
+| RAK WisMesh Tap V2 (RAK3312) | ESP32-S3, SX1262 | Touch display (LovyanGFX, 30+ fps) | Web flasher | Beta (new in beta_38) | Early community port by Ethac.chen (#136); core mesh, chat and map working |
+
+## Feature notes per board
+
+- **T-Deck**: the everything device: touch, physical keyboard, trackball cursor
+  or d-pad navigation, microSD (deep 5000-message chat history, map tile packs,
+  data storage), GPS on the Plus, notification sounds through the I2S speaker.
+- **Heltec V4 + TFT**: touch UI with the on-screen keyboard; the optional
+  Expansion Kit adds environment sensors (home-screen chart) and a piezo
+  buzzer. V4.3 boards get the switchable high-gain receive LNA toggle.
+- **Tanmatsu**: keyboard-driven UI (no touchscreen) with the coloured function
+  keys mapped to tabs, ALT accent picker, UI scaling (Normal/Large/Huge),
+  microSD for all persistent data. Ships through the Tanmatsu launcher store,
+  updates arrive as store updates.
+- **ThinkNode M9**: keyboard plus d-pad navigation (no touch), same feature set
+  as the other boards where the hardware allows. New in beta_38; expect rough
+  edges and report them.
+- **RAK WisMesh Tap V2**: newest port, touch-driven. The browser-flash path is
+  fresh; if the flasher cannot open the serial port, put the board in download
+  mode manually and retry, and please report it.
+
+## Requested boards
+
+Open hardware requests, roughly in demand order. Ports are welcome, see
+[CONTRIBUTING.md](CONTRIBUTING.md); the M9 and Tap V2 both started as community
+PRs.
+
+- LilyGo T-Deck Pro Max: [#62](https://github.com/ALLFATHER-BV/wadamesh/issues/62)
+- LilyGo T-pager: [#60](https://github.com/ALLFATHER-BV/wadamesh/issues/60)
+- SenseCAP Indicator D1L: [#14](https://github.com/ALLFATHER-BV/wadamesh/issues/14)
+
+## Channels
+
+- **Stable**: the tested default. The flasher installs it unless you pick Beta.
+- **Beta**: new features and fixes earlier; on-device opt-in via Settings,
+  About, "Get test builds (beta)". New boards debut here and move to Stable
+  with the next promote.

NOTICE

@@ -51,14 +51,32 @@ ed25519 (bundled in lib/ed25519)
 AsyncElegantOTA (vendored in arch/esp32/AsyncElegantOTA)
     Copyright (c) Ayush Sharma — MIT License
 
-TFT_eSPI (Heltec V4 display backend)
+TFT_eSPI (T-LoRa Pager display backend)
     Copyright (c) Bodmer — MIT / FreeBSD License — https://github.com/Bodmer/TFT_eSPI
 
-Adafruit GFX / ST7735_ST7789 (T-Deck display backend)
+Adafruit GFX / ST7735_ST7789 (T-Deck / Heltec V4 display backend)
     Copyright (c) Adafruit Industries — BSD License
 
 chsc6x (Heltec V4 CHSC6x cap-touch driver)
     Quency-D — https://github.com/Quency-D/chsc6x
 
+SensorLib (T-LoRa Pager XL9555/BQ27220/AW9364 drivers)
+    Copyright (c) Lewis He — MIT License — https://github.com/lewisxhe/SensorLib
+
+ES8311 register sequence and clock-divider coefficients (T-LoRa Pager audio
+codec driver, variants/lilygo_tlora_pager/Es8311Codec.cpp; T-Display P4 audio
+driver, variants/tdisplay_p4/P4Audio.cpp)
+    Copyright (c) 2023-2026 Espressif Systems (Shanghai) CO LTD
+    Apache License 2.0 — https://github.com/espressif/esp-adf-libs and
+    https://github.com/espressif/esp-bsp (components/es8311)
+    wadamesh's drivers are original code (not copies of esp_codec_dev's
+    plugin/HAL architecture) but their ES8311 register addresses, startup/
+    power sequences, and MCLK clock-divider coefficients are derived from
+    Espressif's public es8311.c/es8311_reg.h; P4Audio.cpp additionally
+    re-bases the esp-bsp init flow onto Arduino Wire.
+
+LovyanGFX (RAK WisMesh Tap V2 display backend)
+    Copyright (c) lovyan03 — FreeBSD License — https://github.com/lovyan03/LovyanGFX
+
 This list is not exhaustive and is expanded as dependencies are vendored or
 added.

README.md

@@ -17,8 +17,14 @@ MeshCore fork via PlatformIO `lib_deps`.
 
 ## Boards
 
-- LilyGo T-Deck / T-Deck Plus — env `LilyGo_TDeck_companion_radio_touch`
-- Heltec V4 + TFT + CHSC6x touch — env `heltec_v4_tft_companion_radio_usb_tcp_touch`
+See **[DEVICES.md](DEVICES.md)** for the full support matrix, install paths and
+per-board status.
+
+- LilyGo T-Deck / T-Deck Plus — env `LilyGo_TDeck_companion_radio_touch` (stable)
+- Heltec V4 + TFT + CHSC6x touch — env `heltec_v4_tft_companion_radio_usb_tcp_touch` (stable)
+- Tanmatsu (ESP32-P4) — built from `tanmatsu/` (ESP-IDF), ships via the Tanmatsu app store
+- Elecrow ThinkNode M9 — env `ThinkNode_M9_companion_radio_touch` (beta)
+- RAK WisMesh Tap V2 (RAK3312) — env `rak_tap_v2_companion_radio_touch` (beta)
 
 ## Architecture
 

RELEASE_CHANNELS.md

@@ -0,0 +1,94 @@
+# WadaMesh release channels — Stable + Test
+
+Goal: ship **test** builds to the community fast, let them shake out, then **promote**
+a proven test build to **stable**. What ships to stable is exactly what was tested
+(promote the binary, don't rebuild).
+
+## Two concepts, kept separate
+
+- **Branches** = where code lives.
+- **Channels** = what a device / the flasher pulls (Stable vs Beta).
+
+## Branches
+
+- **`main`** — active line. All work lands here; every *test* release is cut from `main`. (Unchanged from today.)
+- **`stable`** — promoted line. Moves only when a test build is blessed. Starts at the **beta_20** commit.
+- Promote = `git branch -f stable <blessed beta commit>` + push, then run the stable-promotion publish.
+
+## Versioning / tags
+
+- **Test builds:** `beta_N` (immutable, incrementing), marked **GitHub pre-release**. Also mirrored to a rolling **`beta-latest`** pre-release (overwritten each time) for the Launcher beta sync.
+- **Stable:** the blessed `beta_N`, marked **GitHub Latest**. Keep the `beta_N` id for now; friendly `vX.Y` names are an optional later polish (would need a rebuild-with-tag per promotion).
+- First stable = **beta_20**.
+
+## Distribution matrix
+
+| Target | Stable | Test / Beta |
+|---|---|---|
+| GitHub release | blessed `beta_N`, marked **Latest** | every `beta_N`, **pre-release** + rolling `beta-latest` |
+| VPS archive | `releases/TOUCH/<beta_N>/` (only blessed lands here) | `releases/BETA/<beta_N>/` |
+| VPS channel feed | `stable/` (version.json + bins) | `beta/` (version.json + bins) |
+| Flasher (flasher.wadamesh.com) | default | "Beta / testing" toggle |
+| On-device update check | stable feed (legacy firmware reads `releases/TOUCH`) | beta feed (Phase 2 setting) |
+| LauncherHub (bmorcelli, T-Deck) | existing entry (follows GitHub Latest) | new "WadaMesh (Beta)" entry (Phase 3) |
+| Tanmatsu app-store | promote on stable only | (skipped for tests) |
+
+## The linchpin: keeping field devices on stable
+
+Legacy firmware's update check scans `releases/TOUCH/` for the highest `beta_N`. So:
+
+- **Test builds archive under `releases/BETA/`** — invisible to legacy firmware.
+- **Promotion copies the blessed build into `releases/TOUCH/`** — legacy devices then see it and show "update available," landing everyone on stable.
+
+Net effect: existing devices quietly settle on **stable (beta_20)** and stop chasing
+every beta; beta testers opt in via the flasher Beta toggle (or, later, the on-device
+Beta channel).
+
+## Two workflows
+
+### Cut a TEST release (fast, frequent) — from `main`
+1. `beta_N` = next number.
+2. Build both touch envs with the tag embedded.
+3. GitHub: create `beta_N` release **`--prerelease`** with the 7 assets; also refresh the rolling `beta-latest` pre-release.
+4. VPS: rsync to `releases/BETA/<beta_N>/` + refresh the `beta/` feed.
+5. Flasher Beta toggle now serves it. Skip LauncherHub / Tanmatsu / site. (~minutes)
+
+### Promote to STABLE (deliberate, when proven)
+1. `git branch -f stable <beta_N commit>` + push.
+2. GitHub: mark that `beta_N` release **Latest** (clear pre-release).
+3. VPS: copy `releases/BETA/<beta_N>/` → `releases/TOUCH/<beta_N>/`; refresh `stable/` + `latest/` (flasher stable) feeds.
+4. Full fan-out: LauncherHub follows automatically; push the Tanmatsu store; bump the site "what's new."
+
+## Phases
+
+### Phase 1 — channel split, no firmware change (do now)
+- [ ] Create + push `stable` branch at beta_20.
+- [ ] VPS: stand up `stable/`, `beta/`, `releases/BETA/`; point `latest/` (flasher stable) at beta_20; freeze `releases/TOUCH/` at beta_20.
+- [ ] GitHub: ensure beta_20 is **Latest**; future betas → `--prerelease`.
+- [ ] Flasher: Stable (default) / Beta toggle + the beta manifest.
+- [ ] `release.sh` / `gen-flasher-meta.py`: add `--channel beta|stable` producing the right feed/assets + the rolling `beta-latest`.
+- [ ] Rewrite the `wadamesh-release` skill into the two-workflow form.
+
+### Phase 2 — on-device channel selector (ships in a beta, then promoted)
+- [ ] Settings → **Update channel: Stable / Beta**, default Stable (persisted).
+- [ ] `verchkFetchLatest` reads the `stable/` or `beta/` feed per the setting.
+- [ ] Beta devices get the new-beta banner automatically; stable devices never see betas.
+
+### Phase 3 — LauncherHub beta listing (PR to bmorcelli, when wanted)
+- [ ] Rolling `beta-latest` already produced in Phase 1.
+- [ ] PR `bmorcelli/M5Stack-json-fw`: add a `wadamesh_beta.py` (mirror `bruce_beta.py`, track `beta-latest`) + a `t-deck.json` (Beta) entry.
+- [ ] Result: T-Deck Launcher shows **WadaMesh** + **WadaMesh (Beta)**, both auto-synced.
+- Until then: T-Deck Launcher beta testers side-load the beta `.bin` manually (it is a T-Deck-only gap; V4 uses the flasher).
+
+## Where current work lands
+
+- The uncommitted post-beta_20 work (auto-advert GUI, message-flash, docs, RAM pass)
+  plus the hardened **MQTT-privacy** branch → commit to `main` → cut as **beta_21**,
+  the first TEST release in this model. Community tests it; promote when proven.
+- This is exactly the model that handles PR #71: land the reviewed/hardened pieces on
+  `main`, ship as a beta, promote later.
+
+## Decisions
+
+- **Locked:** `main` + `stable`; keep `beta_N` ids with a Stable/Beta channel label; Phase 1 now, Phase 2 in beta_21, Phase 3 as a fast-follow.
+- **Open (reversible):** whether stable later gets friendly `vX.Y` names (needs a rebuild-with-tag per promotion).

TLORA_PAGER_PORT.md

@@ -0,0 +1,996 @@
+# T-LoRa Pager port — working tracker
+
+Goal: run the **full** wadamesh UI + functionality on the **LilyGo T-LoRa Pager**
+(ESP32-S3, **LR1121** radio variant first), kept as **one codebase** with the
+existing boards so a UI change ships everywhere at once. This file is the running
+plan/status — update it as we go.
+
+Status: **M7's UI portion DONE — boot logo, full LVGL UI, QWERTY
+keyboard nav and rotary encoder all VERIFIED WORKING on real hardware
+(2026-07-07)**, after root-causing the intermittent black screen to the ST7796
+panel's hardware-reset line floating: it's wired to **XL9555 channel 6**, which
+both the LilyGoLib doc's channel table and the canonical arduino-esp32 pins
+header omit (full war story: `TLORA_PAGER_M7_HW_DEBUG_LOG.md`, session 2 —
+including why session 1's radio/display "SPI race" theory was disproven from
+TFT_eSPI source). Hardware-comms gates split out to **Milestone 7b**: radio
+vs. a live mesh node is now **DONE** (adverts/DMs confirmed reliable both
+directions as of 2026-07-11, after the TX-power fix — risk 10; still watch
+upstream LR1121 ACK issue #1376 for anything beyond basic reliability), **SD
+storage is DONE** (mount/browse/read/write/delete/insert-remove all
+hardware-verified — risk 1h), and USB companion device-profile frame
+remains untested — see ⑦b for the current breakdown. **Milestone 8
+(on-device UI pass) is now active**: fixing weird UI/keyboard behaviors found
+by manual testing on the device, human supplying photos/repro steps.
+Notification sound (ES8311 codec + NS4150B amp) landed in **Milestone 8b** —
+hardware-verified 2026-07-08 (commit `e682fbc`). **M8 is still active**
+(on-device UI pass); besides the nav-coverage/222-px audit that's its actual
+stated scope (still not started, see risk 8 — this is the single biggest
+remaining item), several concrete bugs surfaced and got fixed this
+milestone: the radio-settings blur-autosave lag (risk 12), the encoder not
+scrolling open dropdowns (fixed 2026-07-08, commit `4bbfcb5`), the keyboard
+backlight never being wired up (risk 9, fixed 2026-07-10), and microSD file
+manager + WAV-picker support (risk 1h, fixed 2026-07-10, scoped — DataStore
+SD routing/chat-history/tiles/wallpaper/backup remain deferred). An
+unread-message LED notification was investigated and explicitly decided
+against (risk 13) — this board has no onboard LED at all. Risk 11
+(keyboard/encoder-driven scroll not repainting) was **ACCEPTED as
+workaround-final 2026-07-13** — the Alt+turn free-scroll gesture is the
+permanent, intended fix for this hardware, root cause not being pursued
+further absent new evidence (see risk 11). **Milestone 10 (SX1262-variant
+env) is DONE and hardware-verified** (2026-07-13, `tlora_pager_sx1262_
+companion_radio_touch` — see worklist ⑩): a real SX1262 unit completed
+setup and confirmed bidirectional live-mesh messaging (public, a custom `#`
+channel, and DM). A cluster of keyboard/encoder input-ergonomics fixes
+landed 2026-07-08 through 2026-07-14 — Enter/Backspace chat-bubble parity,
+the Shift/Caps rework, the accent-variant and @-mention popups both made
+encoder-navigable, WASD map panning + Q/E slider nudging, the Fn+Shift
+chord's conditional Caps-Lock-vs-Home-jump behavior, and app-drawer tiles'
+focus highlight matching their touch-press accent tint — all hardware-
+verified; see the dated paragraphs below and the UI-changes inventory table
+for specifics. **M8's own stated scope (the 222-px vertical-layout audit +
+full focus-nav-coverage pass) still has not been started** — everything
+landed in M8 so far has been reactive bug-fixing from user-reported issues,
+not the systematic audit itself (risk 8) — this remains the single biggest
+open item in the port.
+
+**M8 session 2026-07-07 findings** (radio + nav, all committed:
+`b3c6388`/`df7f9bc`):
+- **TX power was silently capped at a conservative 10dBm with no way to raise
+  it** — unlike the T-Deck (boots straight at 22dBm). Found while
+  investigating a real-mesh DM test: adverts/DMs sent FROM the pager were
+  unreliable while inbound reception was fine (the far node's own TX was
+  unaffected) — classic asymmetric-range signature. Fixed to
+  `LORA_TX_POWER=22`, confirmed as this chip's real sub-GHz HP-PA ceiling via
+  RadioLib's `LR1120::checkOutputPower()` (LR1121 inherits it: HP PA
+  auto-selects above 14dBm, valid range -9..22 below 1GHz) and trail-mate's
+  own `TRAIL_MATE_LORA_TX_POWER_MAX_DBM=22` for this exact board. Existing
+  saved prefs on an already-flashed device do NOT pick up a new compiled
+  default — only a fresh/factory-reset device does; raise it manually in
+  Settings → Radio & Mesh to test on a unit that predates this fix.
+- **Risk 1g (RX-boosted-gain never applied for LR1121) fixed** — see risk
+  entry below.
+- **Encoder direction was inverted** — confirmed on hardware, not a
+  guess: turning the way a user expects to move forward/down moved
+  focus/scroll backward/up. Fixed in `PagerEncoder.cpp`'s
+  `pagerEncoderReadDelta()` (negated once at the source, so every consumer
+  inherits the fix) rather than in UI code.
+- **Found a real, still-partially-open rendering bug**: keyboard/encoder-
+  driven `lv_obj_scroll_to_view(f, LV_ANIM_OFF)` (in `navFocusCb`) does NOT
+  reliably repaint the newly-scrolled region on this board — confirmed via
+  hardware logging that focus and DEFOCUSED save side-effects (blur-to-save
+  toasts) correctly reach fields far down a settings page, but the glass
+  keeps showing the OLD scroll position throughout. Small new overlays
+  (the toast itself) still paint fine, since those are fresh objects, not a
+  repaint of already-rendered scrolled content. Touch-drag scrolling on the
+  other boards never surfaced this because LVGL's drag/animation handler
+  re-invalidates every animation tick, papering over the same gap that a
+  single one-shot `LV_ANIM_OFF` scroll doesn't cover. **Root cause NOT fixed
+  yet** — an attempted fix (force `lv_obj_invalidate()` on the scrolled
+  ancestor after `scroll_to_view`) made things WORSE (very slow, ~5 presses
+  per visible update) without actually fixing the viewport scroll, and was
+  reverted. **Workaround shipped instead**: holding the pager's orange Alt
+  key + turning the encoder now free-scrolls the page via
+  `navScrollFocused()`'s ANIMATED `lv_obj_scroll_by` (which DOES repaint
+  correctly, consistent with the animation-tick theory above), then snaps
+  focus to whatever's nearest the top of the now-visible viewport
+  (`navRefocusFirstVisible()`). This also fixed a pre-existing bug where
+  Alt+turn always jumped main tabs even from inside a settings sheet/chat —
+  now scoped to the main-tab level only (`navOnMainPage()`). Plain
+  NEXT/PREV-driven `scroll_to_view` on a tall settings page is still broken;
+  picking that apart further (why does one-shot `LV_ANIM_OFF` fail to
+  invalidate on THIS board specifically?) is unscheduled follow-up — likely
+  worth checking whether `lv_timer_handler()`'s own per-pass duration
+  (`[STALL] ui:lvgl`, separately observed at 400ms–1.6s on this board during
+  this investigation) is a contributing/related factor, not just the
+  scroll-invalidate call itself.
+
+**M8 session 2026-07-08, chat-bubble Enter/Backspace ergonomics (commits
+`facbe49`/`bf5c682`):** a focused non-composer widget (e.g. a Settings row)
+didn't activate on Enter in one specific case — fixed. Also added, matching
+Tanmatsu's identical no-touch gestures: Enter on a focused chat message
+bubble opens the same Ack/Mention/Copy/Info/Block action menu a touch
+long-press opens elsewhere (`navEnterBubble()`, shared code — bubbles are
+the focusable leaves inside a chat's `msgs` container, identified by
+parent); Backspace jumps straight to the newest message when the "scroll to
+bottom" button is showing (this board has no touch to tap that floating
+button). The rotary encoder's own short click did NOT get the bubble-menu
+behavior in this pass — that gap wasn't closed until 2026-07-14 (below).
+
+**M8 session 2026-07-13, Shift/Caps rework + accent-popup keyboard nav
+(commits `79df528`/`43f040e`), hardware-verified:** (1) The Shift/Caps key
+(`kCapsPos`, renamed `kShiftPos`) changed from trail-mate's original
+bare-press-toggle-Caps-Lock to conventional semantics — held alone it's a
+momentary Shift (uppercases while held, releases back to normal); held Alt
+(Fn) then a Shift press chords into a Caps Lock toggle. New `s_shift_held`
+static, same pattern as `s_backspace_held`/`s_space_held`. One documented
+edge case: Alt+Shift+O or Alt+Shift+L all three held phantom-ghosts a stray
+'q'/'a' (Alt and Shift share row2; col8 is 'o'/'l' on rows 0/1 — a
+diode-less-matrix 3-key rectangle, no software fix possible, harmless since
+it's not the intended hold-Alt-tap-Shift gesture). (2) The accent-variant
+popup (issue #22 — shows accented options when typing a vowel or
+`n c s y t z l r`) was completely unreachable on this no-touch board — its
+cells are `NAV_SKIP_FLAG`, excluded from the nav group by design (touch
+boards pick them by tap). Added a pager-only parallel nav path: Fn(Alt)+
+Space arms it, the rotary encoder walks the highlighted variant, the
+encoder's own click confirms (synthesizes `LV_EVENT_CLICKED` on the
+highlighted cell via `accentNavConfirm()`, reusing `accentBoxCellCb` rather
+than duplicating its logic), Backspace cancels without deleting the base
+letter. See worklist ⑤ for the full writeup, including the 2026-07-14
+follow-up that changed what the Alt+Shift chord actually *does*.
+
+**Same session, Milestone 10 (SX1262-variant env) — DONE, hardware-verified
+(commit `4b0c2e9`):** a real SX1262 unit completed setup and confirmed
+bidirectional live-mesh messaging (public, a custom `#` channel, and DM).
+Full writeup, including the `target.h` missing-include bug found and fixed,
+is in worklist ⑩ and `TLORA_PAGER_PORT_MILESTONES.md`'s Milestone 10.
+
+**Same session, WASD map panning + Q/E slider nudge (commit `9881bb0`),
+hardware-verified:** the Map tab's pan/drag needed a no-touch equivalent —
+W/A/S/D now pan north/west/south/east while the Map tab is active, reusing
+`mapNudge()` (previously Tanmatsu's Ctrl+Arrow-only helper, widened to
+`defined(HAS_TANMATSU) || defined(TLORA_PAGER)`). This freed up D from the
+existing slider-nudge binding (added 2026-07-08 for Control Center
+brightness / Settings sliders / the map zoom bar, since none of those can
+be dragged without touch or a trackball), which moved from D/F to Q/E so
+the two gestures never collide (e.g. the map zoom slider focused while
+WASD-panning).
+
+**M8 session 2026-07-14, four more hardware-verified fixes:**
+1. **Encoder short click now opens the message action menu too** (commit
+   `c4c28d4`) — the 2026-07-08 fix above only wired this into keyboard
+   Enter; the encoder's short click still sent a plain `LV_KEY_ENTER` a
+   bubble doesn't react to. `updatePagerEncoder()`'s short-click branch now
+   calls `navEnterBubble()` first, mirroring `handleHwKey()` exactly.
+2. **Fn+Shift's effect now depends on UI state** (commit `b16206b`) — the
+   chord used to toggle Caps Lock unconditionally, even with no text field
+   focused to see the change reflected in, which was reported as surprising
+   and purposeless outside of typing. `PagerKeyboard.cpp` no longer decides
+   the effect (it has no UI visibility) — it only reports the chord via
+   `pagerKeyboardConsumeAltShiftChord()`; `UITask.cpp`'s new
+   `updatePagerAltShiftChord()` toggles Caps Lock ONLY while a text field is
+   actually being edited (same "ta" derivation `handleHwKey()`'s TLORA_PAGER
+   branch already uses to tell a bound-but-unfocused field apart from one
+   actually being edited), and jumps straight to Home (`navGoToMainTab`)
+   everywhere else.
+3. **@-mention contact picker made encoder-navigable** (commit `57802eb`) —
+   the same unreachable-without-touch problem the accent box had, fixed the
+   same way (`mentionNavRestyle()`/`mentionNavConfirm()` mirror
+   `accentNavRestyle()`/`accentNavConfirm()` almost exactly), with one
+   deliberate difference: it grabs the encoder the INSTANT the list appears
+   rather than requiring an explicit Fn+Space arm, since — unlike the accent
+   box, which pops up after nearly every letter typed and must not steal
+   focus from ongoing typing — the mention list only shows once the user
+   has deliberately typed "@partial" looking for someone to pick, so there's
+   no ongoing typing to protect.
+4. **App-drawer tiles' keyboard/encoder focus highlight normalized to their
+   own accent tint** (commit `6073b6f`) — tiles previously fell through to
+   `navFocusCb`'s generic white reverse-video fill when focused via
+   keyboard/encoder nav (a solid white block over a small rounded icon chip
+   read as a glitch), instead of the accent-tinted `LV_STATE_PRESSED` look
+   they already show on a touch press. New `NAV_ACCENTFOCUS_FLAG`
+   (`LV_OBJ_FLAG_USER_3`) lets `navFocusCb` special-case flagged objects
+   (mirrors the existing switch/slider special-case) to use that same
+   accent tint for both states, on every board — not just the pager.
+
+All three envs build green — Milestone ⑥ (UITask wiring)
+landed; the pager is a first-class, non-touch UI target. Board JSON verified
+(`boards/lilygo-t-lora-pager.json`). Milestones ①–⑥ (variant skeleton, LR1121
+radio glue, ST7796 display + AW9364 backlight, platformio.ini env, TCA8418
+keyboard + rotary encoder drivers, UITask wiring) landed.
+`[env:tlora_pager_lr1121_companion_radio_touch]` compiles clean: **RAM 23.8%
+(78088/327680 B), Flash 66.4% (2696465/4063232 B)** — both still comfortably
+lower than the two shipping boards (Heltec V4/T-Deck: RAM 25.3%, Flash 73.5%,
+unchanged — confirmed byte-identical to pre-M6, zero regression). M1–M5's
+build-blocking fixes (variant/pins split, radio-wrapper include paths, the
+minimal display-typedef addition) are recorded in Decisions ②/⑧ and worklist
+③/⑤ below; M6's own findings follow.
+
+**M6 findings** — the UI-inventory table + worklist ⑥ below have full detail;
+the highlights:
+- **Two capability flags I initially set were premature and had to be walked
+  back**: `CAP_SD`/`CAP_FILESYSTEM` looked right from the hardware table (the
+  pager does have a microSD slot), but the actual mount code
+  (`fmSdTryMount()`, `#include <SD.h>`) is still hardcoded to
+  `HAS_TDECK_GT911` specifically — `device_caps.h`'s own `CAP_SD` flag was
+  never actually wired to it. Turning it on for the pager just produced
+  `SD`/`CARD_NONE`/`fmSdTryMount` "not declared" errors, not real SD support.
+  Set back to 0 — a real mount needs its own pager-specific wiring (CS 21, a
+  non-T-Deck shared-SPI helper), unscheduled follow-up, not this milestone.
+- **`navMaybeRebuild()` — the function that actually populates the LVGL focus
+  group every screen — was unreachable for the pager** in my first pass: it's
+  only called under `#if defined(HAS_TANMATSU) ... #elif CAP_TRACKBALL ...`,
+  neither of which the pager matches. Without a fix here the KEYPAD indev
+  would have an eternally-empty focus group — nothing focusable, navigation
+  completely dead, despite the indev registration itself being correct. Added
+  a `#elif defined(TLORA_PAGER)` arm.
+- **A self-inflicted `#elif` scoping mistake**: `handleHwKey()` (and several
+  helpers it calls) live inside a large, multiply "paused and reopened"
+  `#if defined(HAS_TDECK_KEYBOARD)` region. Widening the wrong reopen point
+  first orphaned ~50 lines of genuinely T-Deck-specific code (keyboard
+  backlight-mode timer, notify-flash, spacebar-lock countdown) into what was
+  meant to be the pager's own simpler branch. Fixed by tracing each reopen's
+  actual `#endif` (nesting depth, not just grep hits) before touching it, and
+  keeping the T-Deck-only pieces under their own unwidened, more specific gate.
+- **`isDismissKey()`'s T-Deck logic doesn't transfer**: it treats the letters
+  p/q/a as "dismiss popup" because the T-Deck's sparse keyboard has no
+  dedicated Esc key. The pager's full QWERTY types those letters constantly —
+  reusing that mapping would eat normal typing. Returns `false` for the pager
+  instead; the rotary encoder's long-press already covers ESC.
+**Execution playbook: `TLORA_PAGER_PORT_MILESTONES.md`** — the worklist below,
+broken into agent-executable milestones with gates and per-file instructions.
+
+---
+
+## Why this port is cheaper than it looks
+
+The scary part — "the device has no touchscreen" — is **already solved in this
+codebase**. UITask carries a complete non-touch navigation layer built for the
+Tanmatsu (keypad-only) and the T-Deck trackball D-pad mode:
+
+- **Focus-group nav**: `s_nav_group` (`lv_group_t`), amber focus ring + scroll-into-view
+  (`navFocusCb`), per-screen group rebuild (`navMaybeRebuild`), 2-D directional focus
+  (`navMoveDir`), tab-bar handling (`navOnTabBar`/`navSwitchTab`) — `UITask.cpp` ~2138–3128.
+- **A KEYPAD indev + key FIFO**: `navFifoPush/Pop` feeds `LV_KEY_UP/DOWN/LEFT/RIGHT/
+  NEXT/PREV/ENTER/ESC` into `tanmatsuKeypadRead` (`UITask.cpp` ~3000). The Tanmatsu
+  registers ONLY this indev (no pointer) — `UITask.cpp` ~35706–35717. **That branch is
+  the pager's template.**
+- **Physical-keyboard routing**: `handleHwKey()` (`UITask.cpp` ~27990) routes keys
+  into the focused textarea (edit mode) or into nav (navigate mode, `s_nav_ta_editing`
+  flag), with the on-screen LVGL keyboard suppressed — exactly how the T-Deck works
+  today. The pager's QWERTY plugs into this unchanged.
+- **Rotary encoder**: no `LV_INDEV_TYPE_ENCODER` needed — encoder ticks map to
+  `navFifoPush(LV_KEY_NEXT/PREV)` (focus walk), press → `ENTER`, long-press → `ESC`.
+  Reuses everything above.
+
+So the genuinely NEW work is: the **480×222 ST7796 display driver + layout pass**,
+the **TCA8418 keyboard driver** (raw matrix → chars, unlike the T-Deck's C3 which
+resolves ASCII for us), the **rotary driver**, the **LR1121 radio glue**, and a
+**board class** whose battery/power goes through I²C chips (fuel gauge + IO
+expander) instead of an ADC pin.
+
+## Hardware / platform facts
+
+Confirmed from the LilyGo product page, CNX-Software (2025-08-12), Meshtastic docs,
+and cross-checked against three working/authoritative sources: upstream
+`meshcore-dev/MeshCore`'s pager target (see caveat under Decision ②), the official
+[LilyGoLib hardware page](https://github.com/Xinyuan-LilyGO/LilyGoLib/blob/master/docs/hardware/lilygo-t-lora-pager.md),
+and `~/dev/trail-mate` (local project with a running LR1121 pager build — pin map
+below is from its `variants/lilygo_tlora_pager/pins_arduino.h`, which is
+byte-identical on every pin/channel to the canonical
+[`espressif/arduino-esp32` pins_arduino.h](https://github.com/espressif/arduino-esp32/blob/master/variants/lilygo_tlora_pager/pins_arduino.h)
+for this board). **Caveat**: the LilyGoLib page's own "Pins Map" table has
+internal inconsistencies for the XL9555 channel assignments (e.g. it lists
+keyboard-enable at ch10 and SD-detect/enable at ch12/ch14, which contradicts
+its own "PowerManage Channel" table on the same page *and* the canonical
+arduino-esp32 header). We treat the arduino-esp32 header + trail-mate (which
+agree with each other and with the "PowerManage Channel" table) as ground
+truth — that's what our own `TLoraPagerBoard.cpp` already uses.
+
+| | |
+|---|---|
+| SoC | ESP32-**S3** @ 240 MHz, 16 MB flash (QIO), **8 MB QSPI PSRAM** (`memory_type: qio_qspi`) |
+| Display | 2.33" IPS **ST7796U**, 480×222 (221 PPI, 262K colors, 450 cd/m²), **480×222 landscape**, SPI, **no touch**. CS 38, DC 37, backlight 42 (AW9364 16-level stepped driver). **Hardware reset is XL9555 ch6, NOT unwired** — `TFT_RST=-1` only because it isn't an ESP GPIO; `TLoraPagerBoard::begin()` owns the reset pulse (LOW→50ms→HIGH, vendor sequence). Leaving ch6 floating = intermittent black screen, clean boot log (M7 root cause) |
+| Shared SPI bus | **SCK 35, MOSI 34, MISO 33** — display + LoRa + SD + ST25R3916 NFC all on it (like the T-Deck's 40/41/38 — solved pattern, CS discipline + SPI transactions) |
+| Radio | **LR1121** (sub-GHz 830–945 MHz + 2.4 GHz; we use sub-GHz only). CS 36, RST 47, BUSY 48, IRQ/DIO1 14. **Also sold with SX1262** (the LilyGoLib page documents the SX1262 retail SKU as primary) — same board/pins, different defines (cheap 2nd env later) |
+| Keyboard | Physical QWERTY via **TCA8418** I²C matrix controller (addr `0x34`), INT 6, backlight 46. Raw matrix events — keymap/shift/sym handled on our side |
+| Encoder | Rotary A 40, B 41, **press 7** |
+| Buttons | **BOOT = GPIO0** (usable as user button + sleep wake — matches both existing boards' `PIN_USER_BTN=0`). Physical power key is PMU QON, not a GPIO — can only wake the device (1s hold), never programmable |
+| Power | **BQ25896** charger PMU (addr `0x6B`) + **BQ27220 fuel gauge** (addr `0x55`, battery % / mV over I²C — NOT an ADC divider). Battery: 3.7 V / 1500 mAh (5.55 Wh). DeepSleep ≈530 µA, LightSleep ≈2.26 mA, Power-off ≈26 µA |
+| IO expander | **XL9555** (addr `0x20`): DRV_EN ch0, AMP_EN ch1, KB_RST ch2, LORA_EN ch3, GPS_EN ch4, NFC_EN ch5, **DISP_RST ch6 — the ST7796 panel's hardware reset** (missing from BOTH the LilyGoLib doc's channel table and arduino-esp32 master's pins header; confirmed from LilyGoLib's `LilyGo_LoRa_Pager.cpp` begin(), which pulses it LOW→50ms→HIGH before display init — leaving it floating was M7's intermittent-black-screen root cause, see `TLORA_PAGER_M7_HW_DEBUG_LOG.md` session 2), GPS_RST ch7, KB_EN ch8, GPIO_EN ch9, SD_DET ch10, SD_PULLEN ch11, SD_EN ch12 |
+| GPS | u-blox **MIA-M10Q**: TX 12, RX 4, PPS 13 |
+| I²C bus | SDA 3, SCL 2 — shared by TCA8418 (`0x34`), XL9555 (`0x20`), BQ25896 (`0x6B`), BQ27220 (`0x55`), PCF85063 RTC (`0x51`), BHI260AP IMU (`0x28`), DRV2605 haptics (`0x5A`), ES8311 codec (`0x18`) |
+| SD | microSD on the shared SPI bus, CS 21, card-detect via expander (ch10), max 32 GB, **FAT32 only** |
+| Audio | ES8311 codec (I²C `0x18`; I2S MCLK 10, SCK/BCK 11, WS 18, SDOUT 45, SDIN 17 — confirmed against arduino-esp32's canonical `variants/lilygo_tlora_pager/pins_arduino.h`, matching LilyGoLib's own `codec.setPins(I2S_MCLK, I2S_SCK, I2S_WS, I2S_SDOUT, I2S_SDIN)` call in `LilyGo_LoRa_Pager.cpp`) driving an **NS4150B** 3 W Class-D amp (enabled via expander AMP_EN ch1, toggled at runtime around playback — not the boot-time permanently-on drive; see Decision below) |
+| Misc | PCF85063A RTC (INT 1), BHI260AP IMU (INT 8), ST25R3916 NFC (unused — CS 39, INT 5, powered via expander NFC_EN ch5), USB VID/PID `0x303A:0x82D4` |
+
+## Board JSON — VERIFIED ✅ (landed as `boards/lilygo-t-lora-pager.json`)
+
+The JSON (Meshtastic-lineage; byte-identical to trail-mate's copy) is **correct for
+the LR1121 unit but radio-agnostic**: it describes only the S3 module (flash/PSRAM/
+USB id/CDC-on-boot), which every radio variant of the pager shares. The radio is
+selected by our build flags (`RADIO_CLASS`/`WRAPPER_CLASS` + pins), same as the
+existing boards. Notes:
+
+- `partitions: app3M_fat9M_16MB.csv` is just the default — we override with our own
+  OTA+tiles+spiffs csv via `board_build.partitions` (see worklist ①).
+- `variant: lilygo_tlora_pager` + `variants_dir: variants` → needs
+  `variants/lilygo_tlora_pager/pins_arduino.h` (write our own; don't copy
+  trail-mate's — it brands `USB_PRODUCT "TRAIL MATE"`).
+- `-DARDUINO_USB_MODE=1` (HW-CDC) is in the JSON's extra_flags. The T-Deck ships
+  MODE=1 fine; the Heltec V4 regressed on it (large companion frames dropped —
+  see the note in `platformio.ini`). **Verify the device-profile frame over USB
+  companion early** (worklist ⑦); if it drops bytes, switch to TinyUSB CDC like
+  the V4.
+
+## Decisions (architecture)
+
+1. **Normal PlatformIO env, T-Deck model** — NOT the Tanmatsu IDF-subproject route.
+   The pager is a plain ESP32-S3 Arduino target; it slots into `platformio.ini`
+   next to the existing two envs and into `release.sh`'s env list later.
+2. **LR1121 wrappers vendored in the variant dir — zero core-fork churn for
+   bring-up.** The core fork (`core-v1.16.5`) only has `CustomLR1110*`.
+   **Re-verified 2026-07-06: upstream `meshcore-dev/MeshCore`'s `main` branch does
+   NOT currently have `CustomLR1121*` or a `variants/lilygo_tlora_pager/` dir**
+   (checked `src/helpers/radiolib/` — only `CustomLR1110{,Wrapper}.h` exists there
+   too; issue [meshcore-dev/MeshCore#861](https://github.com/meshcore-dev/MeshCore/issues/861)
+   "Support for LR1121" is still open). Earlier research that assumed an
+   upstream crib source was wrong or looked at a branch/fork that no longer
+   exists — **re-check upstream at Milestone ② time**, but plan for having to
+   author `CustomLR1121{,Wrapper}.h` ourselves by adapting the core fork's own
+   `CustomLR1110{,Wrapper}.h` pair (same RadioLib `LR11x0` family — swap the
+   base type from `LR1110` to `LR1121`), cross-checked against trail-mate's
+   `initLoRa()` (which drives RadioLib's stock `LR1121` class directly, no
+   custom wrapper) for the RF-switch table / `setTCXO` sequence. Since
+   `CustomLR1121{,Wrapper}.h` only subclass RadioLib's `LR1121` and the core's
+   `RadioLibWrapper` (both on the include path), they can live in
+   `variants/lilygo_tlora_pager/` for now and move into the fork at the next
+   `core-*` tag. Precedent: the Tanmatsu keeps its whole radio bridge in its
+   variant dir.
+   **Found at Milestone ④'s first real compile**: `CustomLR1121Wrapper.h`'s
+   bare quoted `#include "RadioLibWrappers.h"`/`"LR11x0Reset.h"` (copied
+   verbatim from `CustomLR1110Wrapper.h`'s shape) don't resolve — those work
+   in the core fork only because the file sits in the *same*
+   `src/helpers/radiolib/` directory as its targets (quote-include searches
+   the including file's own directory first); ours lives in the variant dir
+   instead. Fixed to angle-bracket `<helpers/radiolib/...>` includes, matching
+   `target.h`'s already-correct pattern for the same headers.
+3. **LR1121 init is explicit** (no `std_init`): RF-switch table on **DIO5/DIO6**
+   (`STBY {L,L} / RX {L,H} / TX {H,L} / TX_HP {H,L}`) + **`setTCXO(3.0f)`** —
+   confirmed in both trail-mate (`boards/tlora_pager/src/tlora_pager_board.cpp`,
+   `initLoRa()`) and upstream. Sync word / preamble / CR come from the same
+   NodePrefs plumbing as the other boards so it interoperates with the mesh.
+4. **Display = new `ST7796LCDDisplay` app-side** (in `src/helpers/ui/`), implementing
+   the core's `DisplayDriver` interface (`begin/width/height/startFrame/endFrame/
+   setDisplayRotation/writePixelsRGB565`) — that's all the LVGL flush path uses.
+   TFT_eSPI has `ST7796_DRIVER` (`USER_SETUP_LOADED` + `-D` pin set).
+   **Correction, landed with Milestone ③**: "the Heltec V4 already builds on
+   TFT_eSPI, so mirror that wiring" was wrong — `ST7789LCDDisplay` (Heltec
+   V4's *and* T-Deck's display class, same file) is actually Adafruit_GFX/
+   Adafruit_ST7789-based; Heltec V4's TFT_eSPI lib_dep/`-D` flags are
+   vestigial (nothing else in the repo `#include`s `TFT_eSPI.h`). This makes
+   `ST7796LCDDisplay` the first real TFT_eSPI consumer in this codebase —
+   every method call was verified directly against the pinned
+   `bodmer/TFT_eSPI @ ^2.5.43` source, not cribbed from the sibling class.
+   **Also found and mitigated**: this panel's 222px glass is narrower than
+   the ST7796 controller's 320px GRAM, requiring a 49px column/row offset
+   that TFT_eSPI only applies automatically when `-D CGRAM_OFFSET=1` is set —
+   missing from this decision's original flag list; a `#error` guard in
+   `ST7796LCDDisplay.cpp` now catches the omission at M4 compile time (see
+   worklist ③ for the full writeup). Backlight is the AW9364 (stepped pulse
+   dimming), not a plain GPIO PWM — wrapped in `ST7796LCDDisplay` itself using
+   `lewisxhe/SensorLib`'s `AW9364LedDriver` directly (a maintained library,
+   already an M1-established dependency) rather than a hand-rolled driver.
+5. **Input = the Tanmatsu registration branch** (KEYPAD indev + `s_nav_group` only,
+   no pointer indev), gated by a new device cap. Rotary → nav FIFO; TCA8418 →
+   `handleHwKey()`. New pollable drivers in `src/helpers/input/` following the
+   existing style (begin/poll/read API, no LVGL inside the driver).
+6. **Battery/power via libraries, not hand-rolled** (CONTRIBUTING rule): lewisxhe
+   **SensorLib** covers BQ27220 (`GaugeBQ27220`), XL9555 (`ExtensionIOXL9555`),
+   PCF85063, DRV2605; **XPowersLib** covers the BQ25896. `TLoraPagerBoard :
+   public ESP32Board` overrides `getBattMilliVolts()` (gauge query),
+   `getManufacturerName()`, power-rail bring-up in `begin()` (expander), and sleep.
+7. **One codebase**: all pager-specific UI behavior rides existing/new `CAP_*`
+   flags in `src/ui-touch/device_caps.h` — no forked screens.
+8. **`variants/lilygo_tlora_pager/` app glue and the board's Arduino "variant"
+   pin map had to split into two directories** — found only by actually
+   compiling in Milestone ④, not anticipated by any earlier decision.
+   PlatformIO's arduino-esp32 build script (`platformio-build.py`) always
+   compiles every source file under `board_build.variants_dir/<board.variant>/`
+   as a separate `FrameworkArduinoVariant` library, in a build context with
+   none of our app's `lib_deps` include paths. T-Deck/Heltec V4 never hit this
+   because their board JSONs point `"variant"` at a variant the *framework*
+   already bundles (`esp32s3`, `heltec_v4`) — completely separate from our own
+   `variants/lilygo_tdeck/`/`variants/heltec_v4/` app-glue directories, zero
+   collision. The pager has no framework-bundled variant, so its board JSON
+   was forced to set `"variants_dir": "variants"`, pointing PlatformIO's
+   variant resolution at the exact same directory we'd used for
+   `TLoraPagerBoard.*`/`target.*`/`CustomLR1121*` — so the framework tried to
+   compile those too, and failed on missing `Wire.h`/`RadioLib.h`. Fixed by
+   moving `pins_arduino.h` alone into a new `variants/lilygo_tlora_pager_pins/`
+   folder and pointing the board JSON's `"variant"` there instead; our own
+   `TLoraPagerBoard.*`/`target.*`/`CustomLR1121*` stay in
+   `variants/lilygo_tlora_pager/`, reached only via our own
+   `build_src_filter`, exactly once. Confirmed safe against
+   `get_partition_table_csv()`'s similar `variants_dir`-based fallback logic
+   (moot here since `board_build.partitions` is set to a full explicit path,
+   which that function returns verbatim once its variant-relative lookup
+   attempts fail).
+
+9. **Notification sound: hand-rolled ES8311 driver, not a vendored codec HAL.**
+   `espressif/esp_codec_dev`'s ES8311 device (Apache-2.0, ~4.5k lines across
+   its generic multi-codec plugin architecture) is more than this
+   single-chip, playback-only board needs, and defaults to the *new*
+   `driver/i2s_std.h` API where this codebase's existing T-Deck sound code
+   uses the legacy `driver/i2s.h` (which already supports MCLK via
+   `i2s_pin_config_t.mck_io_num`, so no new API family was needed). Wrote
+   `variants/lilygo_tlora_pager/Es8311Codec.{h,cpp}` instead — ~200 lines,
+   DAC-only, register sequence and MCLK clock-divider coefficients derived
+   from Espressif's public `es8311.c`/`es8311_reg.h` (see `NOTICE`), fixed to
+   a 256x-sample-rate MCLK ratio covering the standard 8k-48k rates
+   `wavParse()` already accepts. Matches this port's own precedent (T-Deck's
+   sound code is similarly hand-rolled, ~200 lines) and the milestone rule
+   against introducing new abstraction layers.
+10. **AMP_EN toggled around playback, not left permanently on.** The
+    boot-time `TLoraPagerBoard::begin()` drive of every expander rail
+    (including AMP_EN) exists for bus-integrity reasons specific to the boot
+    window (unpowered chips clamping the shared I²C bus) — unrelated to
+    audio and left untouched.
+    `TLoraPagerBoard::setAmpEnabled()` is the runtime toggle the sound code
+    brackets each chime/WAV with (amp off at idle), matching both the
+    vendor's own `codec.setPaPinCallback()` pattern and this port's existing
+    on-demand-resource philosophy (T-Deck installs/uninstalls its I2S driver
+    per chime for the same reason). Cost is one extra I²C write per
+    chime start/end on a bus already used for every other rail toggle.
+
+## Worklist (ordered, each step ends build-green for ALL envs)
+
+- [x] ⓪ Research + board JSON verification; land `boards/lilygo-t-lora-pager.json` + this tracker.
+- [x] ① **Variant skeleton**: `variants/lilygo_tlora_pager/{pins_arduino.h, TLoraPagerBoard.h/.cpp}` + `partitions_tlora_pager_touch.csv` (T-Deck's OTA/tiles/spiffs/coredump layout, byte-identical offsets). Board class (`TLoraPagerBoard : public ESP32Board`): `begin()` re-inits Wire on SDA3/SCL2, probes the XL9555 expander (addr 0x20) and enables LORA_EN/GPS_EN/KB_EN/KB_RST/SD_EN rails, probes the BQ27220 gauge, handles the deep-sleep RX-packet wake reason (mirrors `TDeckBoard.cpp`). `getBattMilliVolts()` reads the gauge (`refresh()` + `getVoltage()`), falling back to 3700 mV if the probe/refresh fails. `getManufacturerName()` → "LilyGo T-LoRa Pager". `enterDeepSleep()` mirrors `TDeckBoard.h`. BQ25896 charger deliberately left as a TODO (gauge alone covers the UI). `target.{h,cpp}` deferred to ② — nothing references the new files yet, so both shipping envs build unchanged (verified green).
+- [x] ② **Radio**: `variants/lilygo_tlora_pager/{CustomLR1121.h, CustomLR1121Wrapper.h, target.h, target.cpp}`.
+  `CustomLR1121{,Wrapper}.h` authored by adapting the core fork's own
+  `CustomLR1110{,Wrapper}.h` (LR1110/LR1121 share RadioLib's `LR11x0` base —
+  confirmed by reading RadioLib 7.6.0 source directly: same protected
+  `freqMHz`/`spreadingFactor` members, same `getIrqStatus()`/`getRssiInst()`
+  inherited from `LRxxxx`/`LR11x0`), since upstream has nothing to crib (see
+  Decision ②). `radio_init()` in `target.cpp`: `spi.begin(...)` →
+  `radio.begin(LORA_FREQ, LORA_BW, LORA_SF, cr, ..._SYNC_WORD_PRIVATE,
+  LORA_TX_POWER, 8, 3.0f)` → `setRfSwitchTable(DIO5/DIO6)` → `setCRC(1)`.
+  **Three deliberate deviations from trail-mate, found by reading RadioLib's
+  actual source rather than copying its call sequence — see Decision ② for
+  the full reasoning:**
+  1. No explicit `radio.reset()` before `begin()` — RadioLib's
+     `LR11x0::modSetup()`→`findChip()` already resets the chip internally
+     (with retries); trail-mate's explicit reset is redundant, not wrong.
+  2. No second `radio.setTCXO(3.0f)` call after `begin()` — trail-mate only
+     needs that because its `initLoRa()` calls the *zero-arg* `begin()`
+     (default `tcxoVoltage=1.6V`) and fixes it up after. Our `begin()` passes
+     `3.0f` as the 8th arg directly, which `LR11x0::modSetup()` already
+     applies internally — a second call would be a no-op.
+  3. Added `radio.setCRC(1)` after `begin()` (LR11x0's `begin()` defaults to a
+     2-byte CRC) to match the 1-byte CRC every other MeshCore radio wrapper
+     uses for wire-protocol interop (`CustomSX1262::std_init()` makes the
+     identical override) — trail-mate never needed this since its app isn't
+     interoperating with MeshCore's own framing.
+  Also **not** calling `rtc_clock.begin(Wire)` in `radio_init()` — see the new
+  Risk item below (RTC address collision). `RfSwitchMode_t`/`OpMode_t`/DIO5-6
+  constants verified to exist with the expected shape directly in the pinned
+  `jgromes/RadioLib @ ^7.6.0` source (not just trusted from trail-mate).
+  Env defines for M4 to use: `RADIO_CLASS=CustomLR1121`,
+  `WRAPPER_CLASS=CustomLR1121Wrapper`, `P_LORA_NSS=36 / _RESET=47 / _BUSY=48 /
+  _DIO_1=14`, SPI 35/34/33, **`PIN_GPS_RX=12` / `PIN_GPS_TX=4`** (see the GPS
+  risk item below — these are swapped relative to trail-mate's raw
+  `GPS_RX`/`GPS_TX` macro values, on purpose), `GPS_BAUD_RATE=38400`. Keep the
+  standard `RADIOLIB_EXCLUDE_*` set (LR11X0 stays IN; can also exclude SX126X
+  here).
+- [x] ③ **Display**: `src/helpers/ui/ST7796LCDDisplay.{h,cpp}` on TFT_eSPI
+  (`ST7796_DRIVER`, `TFT_WIDTH=222`, `TFT_HEIGHT=480`, MADCTL rotation for
+  landscape). This is the **first real TFT_eSPI consumer in this codebase** —
+  `ST7789LCDDisplay` (the sibling this was "modeled on") turned out to be
+  Adafruit_GFX/Adafruit_ST7789-based for both Heltec V4 and T-Deck; the
+  Heltec V4 env's TFT_eSPI lib_dep/`-D` flags are vestigial (nothing
+  `#include`s `TFT_eSPI.h` anywhere else in the repo). Only the
+  `DisplayDriver`-satisfying shape was mirrored, not any API calls — every
+  TFT_eSPI method used (`init`, `setRotation`, `setAttribute`/`CP437_SWITCH`,
+  `textWidth`, `pushColors`, `writecommand`/`TFT_DISPOFF`, `fillScreen`,
+  `fillRect`/`drawRect`/`drawPixel`, `setAddrWindow`/`startWrite`/`endWrite`)
+  was verified directly against the pinned `bodmer/TFT_eSPI @ ^2.5.43` source
+  in `.pio/libdeps/*/TFT_eSPI/TFT_eSPI.h`, not assumed.
+  **Found and fixed a real correctness bug in the same pass**: this panel's
+  222px glass is narrower than the ST7796 controller's 320px GRAM (trail-mate
+  applies explicit 49px column/row offsets — confirmed the source of the
+  magic number: `320 - 222 = 98`, halved/centered = 49px each side). TFT_eSPI's
+  own `ST7796_Rotation.h` already has this exact fix (`colstart=49`/
+  `rowstart=49` depending on rotation, applied automatically inside every
+  `setAddrWindow()` call) — but only when `CGRAM_OFFSET` is `#define`d.
+  Unlike `ST7789_Defines.h` (which self-defines it), `ST7796_Defines.h` does
+  not, and it was **missing from this milestone's own drafted M4 flag list**.
+  Without it the build compiles clean but every frame renders shifted/cropped
+  by 49px with no error — added a `#error` guard in the new `.cpp` that fires
+  the moment M4 compiles this file without the flag, with the fix spelled out
+  in the message. **M4 must add `-D CGRAM_OFFSET=1`.**
+  Backlight: AW9364 stepped pulse-dimmer, wrapped directly in
+  `ST7796LCDDisplay` (no separate `Aw9364Backlight.{h,cpp}` — `ST7789LCDDisplay`
+  turned out to have no brightness hook to mirror at all; brightness on the
+  other two boards is a `UITask.cpp`-owned free function doing raw LEDC PWM
+  on `PIN_TFT_LEDA_CTL`, which the AW9364's pulse protocol can't use).
+  Consumes `lewisxhe/SensorLib`'s `AW9364LedDriver` directly (header-only,
+  already vendored via the M1-established SensorLib dependency) rather than
+  hand-rolling the pulse timing the milestone doc originally suggested.
+  Exposes `setBrightness(uint8_t pct)`/`getBrightness()` (0-100, matching the
+  Settings UI's existing convention) so Milestone 6 can wire it in with one
+  line. **M6 needs a new branch ahead of `UITask.cpp`'s existing
+  `PIN_TFT_LEDA_CTL` PWM branch** — once M4 defines that macro for the pager,
+  the existing LEDC-PWM code would also compile and fight the AW9364's pulse
+  protocol (a duty cycle is not a valid input to this chip). `NOTICE` updated:
+  added a `SensorLib` entry (missing since M1) and corrected the `TFT_eSPI`/
+  `Adafruit GFX` lines' backend descriptions (both were wrong about which
+  boards use which library). `DISPLAY_CLASS=ST7796LCDDisplay`. Gate: both
+  shipping envs build unchanged (neither's `build_src_filter` references
+  `helpers/ui/*.cpp` yet, so the new TU isn't even parsed by either compiler
+  today) — full compiler verification of the new code waits for M4.
+- [x] ④ **Env**: `[env:tlora_pager_lr1121_companion_radio_touch]` in
+  `platformio.ini`, cloned from the T-Deck env with board/radio/display/GPS/
+  input deltas (see Decisions ①-④, ⑥-⑧ for exact values and reasoning). Added
+  lib_deps: `bodmer/TFT_eSPI @ ^2.5.43`, `adafruit/Adafruit TCA8418 @ ^1.0.2`,
+  `lewisxhe/SensorLib @ 0.3.3` (exact version trail-mate proves works, not
+  guessed) — **dropped** `adafruit/Adafruit ST7735 and ST7789 Library` from
+  the cloned list (T-Deck/Heltec's Adafruit display backend; unused here,
+  TFT_eSPI replaces it). No `XPowersLib` (M1 left the BQ25896 charger out of
+  scope). `default_envs` left unchanged (still just the two shipping boards).
+  Also fixed two structural bugs found only by actually compiling (see
+  Decision ⑧) and added one forced, minimal `UITask.cpp` `#elif
+  defined(TLORA_PAGER)` arm (display-class typedef only — see the Status
+  line). **Compile gate: all three envs build green** — verified.
+- [x] ⑤ **Input drivers**: `src/helpers/input/{PagerKeyboard,PagerEncoder}.{h,cpp}`.
+  Gated `HAS_PAGER_KEYBOARD`/`HAS_PAGER_ENCODER`, already reached by every
+  env's `+<helpers/input/*.cpp>` filter — no `platformio.ini` change needed
+  for compilation, only the pin flags (`KB_INT=6`, `KB_BACKLIGHT=46`,
+  `ROTARY_A=40`, `ROTARY_B=41`, `ROTARY_C=7`, matching the repo's
+  explicit-`-D`-alongside-`.cpp`-fallback convention).
+  **`PagerKeyboard`**: T-Deck's own keyboard driver turned out to be the
+  wrong shape to mirror directly — its C3 co-processor resolves ASCII itself
+  over I2C, so `TDeckKeyboard.cpp` never sees a raw matrix event. The
+  TCA8418 (Adafruit_TCA8418 lib, already an M4 dependency) reports raw
+  row/col events instead, so the keymap + shift/sym/alt state machine lives
+  in `PagerKeyboard.cpp` itself. Reused trail-mate's `LilyGoKeyboard` keymap
+  tables verbatim (same physical PCB) — `keymap[4][10]`/`symbol_map[4][10]`,
+  Alt as a hold-to-symbol-layer modifier (no separate physical Symbol key on
+  this hardware), Backspace special-cased to `'\b'` — UX choices trail-mate
+  already field-validated, reused rather than re-derived. **The Shift/Caps
+  key's behavior changed 2026-07-13** from trail-mate's original
+  press-to-toggle case lock to conventional keyboard semantics: held alone
+  it's a momentary Shift (uppercases whatever letters are typed while held,
+  releases back to normal); held Alt + a Shift press instead chords. `kCapsPos`
+  renamed `kShiftPos` to match. **Chord effect changed again 2026-07-14**:
+  `PagerKeyboard.cpp` no longer decides what Alt+Shift *does* (it has no UI
+  visibility) — it only reports the chord via
+  `pagerKeyboardConsumeAltShiftChord()`; `UITask.cpp`'s
+  `updatePagerAltShiftChord()` toggles persistent Caps Lock ONLY while a text
+  field is actually being edited (same "ta" derivation as `handleHwKey()`'s
+  TLORA_PAGER branch), and jumps straight Home (`navGoToMainTab`) everywhere
+  else — toggling Caps Lock with no field to see it change in was reported as
+  surprising/purposeless outside of typing.
+  See `PagerKeyboard.cpp`'s matrix-legend comment for the one documented
+  edge case (Alt+Shift+O or Alt+Shift+L all three held phantom-ghosts a
+  stray 'q'/'a' — a diode-less-matrix limitation, not a bug, and not the
+  intended gesture). Ring-buffer/SPSC/threading-contract shape
+  mirrors `TDeckKeyboard.cpp`'s (single poll context, UI-thread-safe
+  `readKey()`) even though the underlying hardware access differs completely.
+  Implemented as straightforward polling (`available()`/`getEvent()` drained
+  every `pagerKeyboardPoll()` call), not INT-pin-gated, despite the milestone
+  doc's "prefer INT-driven drain" suggestion — trail-mate's own INT handling
+  does extra `INT_STAT`/`GPIO_INT_STAT` register bookkeeping whose exact
+  clear-vs-latch semantics weren't independently verified, and an ISR-gated
+  poll that's wrong would present as "keyboard stops after first keypress" —
+  a regression only caught on hardware (M7). Polling is explicitly sanctioned
+  as a fallback by the milestone doc and carries no such risk; INT-driven
+  draining is a valid future optimization once verified on real hardware.
+  **`PagerEncoder`**: the milestone's "ISR edge-counting exactly like
+  `TDeckTrackball.cpp:27-47`" doesn't transfer literally — the T-Deck
+  trackball is 4 independent direction-pulse GPIOs (no direction logic
+  needed, each pin already means one direction), not a true A/B quadrature
+  pair, so it can't answer "which way did it turn." Implemented a standard
+  Gray-code quadrature transition table instead (both edges of both A and B
+  feed one ISR, table lookup yields +1/-1/0 per transition) — same
+  ISR-does-cheap-arithmetic-only shape and `noInterrupts()`-snapshot read
+  pattern as `TDeckTrackball.cpp`, just the right decode logic for a genuine
+  quadrature signal. Divides by `PAGER_ENCODER_STEPS_PER_DETENT` (default 4,
+  the common EC11-style ratio) to convert raw transitions to detents,
+  carrying the remainder forward across reads — **this divisor is an
+  unverified assumption, confirm on hardware in M7**.
+  **Gate:** all three envs build — verified.
+- [x] ⑥ **UITask wiring**: `device_caps.h` got its `TLORA_PAGER` cap block (no
+  touch, no rotate, no large-screen, GPS 1, OTA 1, lock-screen 1; `CAP_SD`/
+  `CAP_FILESYSTEM` corrected to 0 — see below) plus widened `CAP_KEYBOARD`/
+  `CAP_KEYPAD_NAV` derivations to recognize `HAS_PAGER_KEYBOARD`/
+  `TLORA_PAGER`. `UITask.cpp` changes, all pager-gated: KEYPAD indev
+  registered by widening the Tanmatsu branch's `#if` to
+  `defined(HAS_TANMATSU) || defined(TLORA_PAGER)` (~35706) — pager reuses
+  `tanmatsuKeypadRead`'s plumbing but not `bsp_input_get_queue`, which stays
+  Tanmatsu-only; forced `s_ui_rotation = LV_DISP_ROT_270` and a new
+  `hor_res=480/ver_res=222` branch (~35626); a new `updatePagerEncoder()`
+  (delta → `navPushTap(NEXT/PREV)`, click → ENTER, long-press ≥1000ms →
+  ESC); main-loop drain wired for both `pagerKeyboardPoll()`/
+  `pagerKeyboardReadKey()` → `handleHwKey()` and the encoder function above;
+  `applyBrightness()`/`touchScreenBacklight()` got pager-first branches
+  calling `display.setBrightness()` instead of falling into the
+  `PIN_TFT_LEDA_CTL` PWM branch (closes risk 1f — PWM would never have
+  worked on the AW9364's discrete-pulse interface). Draw buffer already
+  sized off `hor_res` so needed no separate edit. 222-px vertical audit
+  deferred to on-device measurement (M8) rather than guessed constants — see
+  risk 8 below. Final sizes: pager RAM 23.8% (78088/327680 B), Flash 66.4%
+  (2696465/4063232 B); Heltec V4/T-Deck unchanged at 25.3%/73.5% (byte-
+  identical to pre-M6, confirming the gate on every edit). Three corrections
+  vs. the milestone doc's assumptions, all found by compiling rather than
+  assumed — see risks 1h/1i/1j:
+  - `CAP_SD`/`CAP_FILESYSTEM` looked right from the hardware (real microSD
+    slot) but the actual mount code is hardcoded to `HAS_TDECK_GT911`, not
+    truly `CAP_SD`-generic — set back to 0, real support is unscheduled
+    follow-up.
+  - `navMaybeRebuild()` (populates the LVGL focus group every screen) wasn't
+    reachable on the pager's own cap combination — added a
+    `#elif defined(TLORA_PAGER)` arm; without it the KEYPAD indev would have
+    had a permanently empty focus group.
+  - Several T-Deck-keyboard-gated helpers (`handleHwKey`, `isDismissKey`,
+    `tabForKey`, `navMenubarKeysSync`) live inside multiply "paused and
+    reopened" `#if defined(HAS_TDECK_KEYBOARD)` regions; widened each
+    reopen's gate individually (tracing real nesting depth, not just grep
+    hits) rather than touching the whole file, and kept genuinely
+    T-Deck-only sub-logic (the p/q/a dismiss-key mapping, which would eat
+    normal QWERTY typing on the pager) under its own narrower, unwidened gate.
+- [x] ⑦ **Headless bring-up gate, UI portion** (needs hardware) — DONE
+  (2026-07-06/07 sessions, see `TLORA_PAGER_M7_HW_DEBUG_LOG.md`): flash +
+  serial recipes established; boot clean; SPIFFS mounts; display + boot logo +
+  full UI + keyboard nav + encoder verified on the glass (after 6 real bugs —
+  stale-NVS BLE bonds, screen-wake path, TFT_eSPI S3 SPI-port index, panel
+  INVON, two-SPI-hosts pin theft, and the floating XL9555-ch6 panel reset).
+- [~] ⑦b **Radio/USB/SD bring-up gates** (needs hardware + second mesh node) —
+  **radio joins the live mesh: DONE**, adverts/DMs confirmed reliable both
+  directions against a second node after the TX-power fix (risk 10,
+  retested 2026-07-11) — still watch upstream LR1121 ACK issue
+  meshcore-dev/MeshCore#1376 for anything beyond basic reliability. USB
+  companion link passing the large device-profile frame (see HW-CDC note
+  above): still untested. **SD storage: DONE** — real mount, browse,
+  read/write/delete, and insert/remove detection all confirmed on hardware
+  (risk 1h). (DataStore/NVS-level SD use — routing contacts/channels to the
+  card — is a separate, still-deferred feature, not part of this bring-up
+  gate.) Remove the temporary `[DISP]` register readback in
+  `ST7796LCDDisplay::begin()` once the USB piece passes.
+- [~] ⑧ **On-device UI pass** — ACTIVE: nav-coverage audit screen by screen (every interactive control reachable via focus group — the Tanmatsu work paved this), chat layout at 222 px, map pan via encoder/keys, fonts legibility at 480-wide, plus fixing any weird UI/keyboard behaviors surfaced by manual testing (human provides photos/repro steps).
+- [ ] ⑨ **Release pipeline**: add the env:binname pair to `release.sh` `ENVS`, flasher manifest (`deploy/flasher/manifest-tlora-pager.json`), OTA env name via `FIRMWARE_OTA_ENV`. Separate PR.
+- [x] ⑩ (Optional, cheap) `tlora_pager_sx1262_...` env for SX1262-variant owners — **DONE, hardware-verified 2026-07-13** (`tlora_pager_sx1262_companion_radio_touch`, all 4 envs green; see `TLORA_PAGER_PORT_MILESTONES.md`'s Milestone 10 for the full writeup, including the `target.h` missing-include bug found + fixed). Radio gate (M7 step 3) confirmed on real hardware: user sent + received messages on public, a custom `#` channel, and DM.
+
+## UI-changes inventory (what actually changes in `src/ui-touch/`)
+
+| Area | Change | Size | Status |
+|---|---|---|---|
+| Indev registration (~35706) | Widened the Tanmatsu keypad-only branch's gate to `\|\| defined(TLORA_PAGER)`; no pointer indev registered | small | done |
+| Input drain (main loop ~37350) | Pager branch: `pagerKeyboardPoll()`+`pagerKeyboardReadKey()`→`handleHwKey()`; `updatePagerEncoder()`→`navPushTap(NEXT/PREV/ENTER/ESC)` | small | done |
+| `handleHwKey()` (~27990) and its multiply-reopened `HAS_TDECK_KEYBOARD` regions | Widened each reopen's gate individually to admit `HAS_PAGER_KEYBOARD`; kept the T-Deck-only p/q/a dismiss mapping under its own narrower gate | small | done |
+| Resolution block (~35604–35650) | New branch: forced `LV_DISP_ROT_270`, `hor_res=480/ver_res=222` | small | done |
+| Draw buffer (~1399) | Sized off `hor_res`, no separate edit needed | trivial | done (no-op) |
+| Brightness (`applyBrightness`~28906, `touchScreenBacklight`~36511) | New pager-first branches calling `display.setBrightness()` instead of the PWM `PIN_TFT_LEDA_CTL` path | small | done |
+| `navMaybeRebuild()` reachability | Added `#elif defined(TLORA_PAGER)` arm — was unreachable, would've left focus group permanently empty | small | done (bug fix) |
+| Vertical budget | Audit `STATUSBAR_H`, `TABBAR_H`, `CHAT_KB_H`, modal/chat height helpers for 222 px | **the real work** | deferred to M8 on-device (risk 8) |
+| Focus-nav coverage | Screen-by-screen pass that every control is in `s_nav_group` | medium, on-device | deferred to M8 |
+| device_caps.h | New `CAP_*` block: no touch, hw keyboard, encoder, 480×222, GPS, OTA, lock-screen; SD/filesystem left 0 by design — real SD support added via widened individual call sites instead (see risk 1h) | trivial | done |
+| Keyboard backlight (`pagerKeyboardSetBacklight()`) | `updatePagerKbBacklight()` tick + Settings → Keyboard cycle row (off/on/auto) | small | done (risk 9) |
+| microSD (file manager + WAV picker) | `fmSdTryMount()`/`fmShowRoots()`/`fmIsAudio()` etc. widened to `\|\| defined(TLORA_PAGER)`; DataStore SD routing, chat-history cap, tile/wallpaper/backup SD use still deferred | medium | done, scoped (risk 1h) |
+| Chat bubble Enter/Backspace (`handleHwKey()` ~28808) | Enter on a focused bubble opens the Ack/Mention/Copy/Info/Block menu (`navEnterBubble()`); Backspace jumps to the newest message when the scroll-to-bottom button is showing | small | done |
+| Shift/Caps (`PagerKeyboard.cpp`) | Held Shift = momentary uppercase; held Alt+Shift = chord (see below for what it does) | small | done |
+| Accent-variant popup keyboard nav | Fn+Space arms it; encoder walks variants; encoder click/Enter confirms; Backspace cancels (`s_accentnav_active`/`accentNavRestyle()`/`accentNavConfirm()`) | medium | done |
+| @-mention picker keyboard nav | Auto-arms the instant the list appears (no Fn+Space needed); same encoder walk/confirm/cancel as the accent popup (`s_mentionnav_active`/`mentionNavRestyle()`/`mentionNavConfirm()`) | medium | done |
+| Encoder short click on a focused bubble | Mirrors keyboard Enter — opens the same action menu instead of a plain ENTER a bubble doesn't react to | small | done |
+| Fn+Shift chord effect | Toggles Caps Lock while editing a text field; jumps to Home (`navGoToMainTab`) everywhere else — `PagerKeyboard.cpp` only reports the chord, `UITask.cpp` decides the effect | small | done |
+| Map pan (WASD) + slider nudge (Q/E) | WASD pans the Map tab (`mapNudge()`, shared with Tanmatsu's Ctrl+Arrow); Q/E adjust a focused slider (moved off D/F to avoid colliding with WASD) | small | done |
+| App-drawer tile focus highlight | `NAV_ACCENTFOCUS_FLAG` makes `navFocusCb` use the tile's own accent tint instead of the generic white reverse-fill, on every board | small | done |
+| SX1262-variant env | `tlora_pager_sx1262_companion_radio_touch` — same board/pins, `CustomSX1262`/`CustomSX1262Wrapper` instead of the LR1121 classes | medium | done (worklist ⑩) |
+
+Everything else (map, chat, contacts, channels, settings, companion protocol,
+MQTT, OTA) is resolution-agnostic or already keyed off caps.
+
+## Risks / open questions
+
+1. **LR1121 ACK/TX reliability** — upstream issue meshcore-dev/MeshCore#1376 reports
+   ACK problems on the pager's LR1121 (confirmed still open). Track it; our wrapper
+   crib should include any upstream fix. Gate ⑦ tests this explicitly.
+1b. **No upstream `CustomLR1121` crib source exists yet** (re-verified
+   2026-07-06 — see Decision ②'s caveat). Milestone ② needs to author the
+   wrapper by adapting the core fork's `CustomLR1110{,Wrapper}.h`, not by
+   copying an upstream file. Re-check upstream first in case it lands before
+   we get there — would save the work.
+1c. **GPS `PIN_GPS_RX`/`PIN_GPS_TX` are named from the GPS module's
+   perspective in wadamesh's own core (`EnvironmentSensorManager.cpp` calls
+   `Serial1.setPins(PIN_GPS_TX, PIN_GPS_RX)`, and `HardwareSerial::setPins()`
+   takes `(rxPin, txPin)` — so `PIN_GPS_TX` supplies the ESP's own **RX** pin,
+   `PIN_GPS_RX` supplies the ESP's own **TX** pin). trail-mate's/the canonical
+   arduino-esp32 `GPS_RX=4`/`GPS_TX=12` macros are named the OPPOSITE way — its
+   own `Serial1.begin(baud, cfg, GPS_RX, GPS_TX)` call uses
+   `HardwareSerial::begin()`'s `(rxPin, txPin)` order directly, so there
+   `GPS_RX` IS the ESP's own RX pin. **Net result: wadamesh's `PIN_GPS_RX` must
+   be set to `12` and `PIN_GPS_TX` to `4`** for M4 — the raw trail-mate values
+   swapped, not copied verbatim. Verified by reading both projects' actual
+   `Serial1.setPins()`/`begin()` call sites and the ESP32 core's
+   `HardwareSerial::setPins()`/`begin()` signatures directly, not by trusting
+   either project's macro names at face value. Baud confirmed at 38400 (same
+   MIA-M10Q as T-Deck Plus).
+1d. **RTC auto-discovery would misread this board's real RTC.**
+   `AutoDiscoverRTCClock` (core, shared by all boards) only recognizes DS3231
+   (`0x68`), RV3028 (`0x52`), and PCF8563 (`0x51`) — its probe is a bare I2C ACK
+   check. This board's PCF85063A sits at that same `0x51` address but has a
+   different register layout (RTClib's `RTC_PCF8563` driver would misread its
+   registers), so calling `rtc_clock.begin(Wire)` would silently produce
+   garbage timestamps instead of a clean fallback. `target.cpp`'s `radio_init()`
+   deliberately skips that call — same time behavior as T-Deck/Heltec V4 (ESP32
+   software clock) rather than a false "RTC found" that's actually wrong. Real
+   PCF85063A support (SensorLib's `SensorPCF85063`) is unscheduled follow-up
+   work, not part of any milestone ①–⑩ yet.
+1e. **`-D CGRAM_OFFSET=1` must land in Milestone ④'s pager env flags.**
+   This panel's 222px glass is narrower than the ST7796 controller's 320px
+   GRAM; TFT_eSPI's `ST7796_Rotation.h` only applies the required 49px
+   column/row offset when this flag is set (unlike `ST7789_Defines.h`, which
+   self-defines it). Without it, the pager build compiles clean but every
+   frame renders shifted/cropped by 49px with no error. `ST7796LCDDisplay.cpp`
+   has a `#error` guard that will catch the omission the moment M4 compiles
+   this file — but the actual fix belongs in `platformio.ini`, and it's easy
+   to miss since the build "succeeds."
+1f. **M6 must add a pager branch to `UITask.cpp`'s brightness code ahead of
+   its existing `PIN_TFT_LEDA_CTL` PWM branch.** Milestone ③ reused that
+   macro name for the pager's AW9364 enable pin (naming consistency across
+   boards), but `UITask.cpp:~28868`'s `#if defined(PIN_TFT_LEDA_CTL) &&
+   (PIN_TFT_LEDA_CTL >= 0)` branch drives that pin with 20kHz LEDC PWM — which
+   the AW9364 does not accept (it needs discrete edge pulses per step, not a
+   duty cycle). Once M4 defines `PIN_TFT_LEDA_CTL=42` for the pager, that
+   existing branch will compile and run for it too unless M6 adds a
+   `#if defined(TLORA_PAGER)` branch first that calls
+   `display.setBrightness(pct)` instead (the hook `ST7796LCDDisplay` already
+   exposes for exactly this).
+1g. **RX-boosted-gain silently doesn't apply for the pager — RESOLVED
+   2026-07-07 (commit `b3c6388`).** Was deferred, not fixed, in Milestone ④
+   (matches M3's shared-file-edit precedent): with `-D USE_LR1121=1` defined
+   (not `USE_SX1262`/`USE_SX1268`), three call sites defaulted/applied this
+   radio setting only for the SX126x macros even though `CustomLR1121Wrapper`
+   already implements `setRxBoostedGainMode`/`getRxBoostedGainMode`:
+   `src/MyMesh.cpp` ~2540 (default pref value on first boot), ~2556 and ~3355
+   (actually calling `radio_driver.setRxBoostedGainMode(...)`), and
+   `src/DataStore.cpp` ~264 (default pref value). Fixed by adding
+   `|| defined(USE_LR1121)` to all three conditions — safe/additive, zero
+   behavior change for T-Deck/Heltec V4, verified by all-three-envs build.
+   (A fourth, core-lib-only gate still exists in `CommonCLI.cpp`'s
+   `radio.rxgain` companion CLI command, checking `USE_SX1262`/`USE_SX1268`/
+   `USE_LR1110` — left alone in this pass since it's core-lib, not app code;
+   now that the three UI/prefs call sites actually apply the setting, adding
+   `USE_LR1121` there too would be safe follow-up, just unscheduled.)
+2. **TCA8418 keymap** — raw matrix + our own shift/sym/alt state machine; the T-Deck
+   never needed this (its C3 resolves ASCII). Bounded: trail-mate's layout tables are
+   a working reference. Landed in M5 as `src/helpers/input/PagerKeyboard.cpp`,
+   polling-based (not INT-pin-gated — see worklist ⑤ for why).
+2a. **Encoder detent scaling — RESOLVED on hardware (2026-07-07).** The
+   assumed 4-transitions-per-detent (`PAGER_ENCODER_STEPS_PER_DETENT`)
+   matches this part: user drove the menus by encoder and reported it feels
+   right ("encoder is looking good"), no fractional/multiple stepping.
+   **Direction was also wrong, found and fixed later the same day**: unlike
+   scaling, the CW/CCW sign was never actually validated against physical
+   rotation — `kQuadTable`'s convention didn't match this part's wiring, so
+   turning the way a user expects to move forward/down moved focus and
+   page-scroll backward/up instead. Fixed by negating once in
+   `PagerEncoder.cpp`'s `pagerEncoderReadDelta()` (the driver, not UI code)
+   so every consumer inherits the corrected sense from one place.
+1h. **`CAP_SD`/`CAP_FILESYSTEM` are 0 for the pager despite real microSD
+   hardware — a latent gap in `device_caps.h`'s own abstraction, not a pager
+   bug.** **File manager browsing + WAV notification-sound picker RESOLVED
+   2026-07-10** (commits `8c7fb6a`/`1514e76`), scoped deliberately: `CAP_SD`
+   turned out to gate ~37 call sites (file manager, WAV picker, DataStore
+   contacts/channels routing, tile-cache SD fallback, wallpaper scanning,
+   settings backup, screenshots), so flipping the macro itself would have
+   silently turned on ~30 unvetted, T-Deck-only-tested features at once.
+   Instead `CAP_SD`/`CAP_FILESYSTEM` stay 0 by design, and only the ~7
+   specific call sites needed for browsing + WAV picking were widened with
+   `|| defined(TLORA_PAGER)` — see those commits for the full categorized
+   site list. Added `pagerSdCardPresent()` (XL9555 `PAGER_EXPAND_SD_DET`,
+   confirmed-inverted polarity) and a pager `sdSharedSPI()` (reuses
+   `TFT_eSPI::getSPIinstance()`, the same bus the radio already shares).
+   Format support is explicitly out of scope (no `f_mkfs`/`sd_diskio.h` pulled
+   in) — the pager's SD row is tap-to-open only. Hardware-verified: mount,
+   browse, read/write/delete, insert/remove detection, and picking a WAV from
+   SD as a notification sound all confirmed on real hardware. **Still not
+   done** (unscheduled follow-up, deliberately deferred): DataStore
+   contacts/channels routing to SD (`setSecondaryFS`, what Tanmatsu/T-Deck
+   do to dodge SPIFFS GC stalls), the `MAX_UI_MESSAGES_SD` chat-history cap
+   bump, map-tile SD fallback/offline tile packs, lock-screen wallpaper SD
+   scanning, and settings/telemetry backup export-import to SD.
+1i. **`navMaybeRebuild()` was unreachable for the pager in the first M6
+   pass.** It's only called under `#if defined(HAS_TANMATSU) ... #elif
+   CAP_TRACKBALL ...`, neither of which the pager's cap combination matches
+   (`CAP_TRACKBALL=0`, not `HAS_TANMATSU`). Left alone, the KEYPAD indev
+   would register successfully but its focus group would stay permanently
+   empty — total, silent navigation dead-end, easy to miss since the build
+   still succeeds. Fixed with a `#elif defined(TLORA_PAGER)` arm alongside
+   the existing branches.
+1j. **`isDismissKey()`'s T-Deck p/q/a mapping doesn't transfer to the
+   pager's full QWERTY** — that mapping exists only because the T-Deck's
+   sparse keyboard lacks a dedicated Esc key; reusing it verbatim for the
+   pager would make it impossible to type those three letters normally.
+   Returns `false` for the pager instead — its Esc equivalent is the rotary
+   encoder's long-press, handled separately in `updatePagerEncoder()`.
+3. **222-px chat screen** — tightest layout wadamesh has shipped (current min is
+   240). Mitigations: no on-screen keyboard (physical QWERTY), slimmer status/tab
+   bars, landscape chat already exists (320×240 path).
+4. **HW-CDC companion frames** (`ARDUINO_USB_MODE=1`) — known-regressed on the V4,
+   fine on the T-Deck. Test the big device-profile frame first thing on hardware.
+5. **Encoder-only ergonomics** on long lists (contacts @ 2000 max) — NEXT/PREV focus
+   walk may need page-jump keys from the QWERTY (cheap: map to `navMoveDir`).
+6. **Shared SPI contention** (display flush vs radio IRQ vs SD) — same topology the
+   T-Deck ships, so expected fine via SPI transactions + CS discipline; keep an eye
+   on SD-write + RX overlap during history flush. **Partially de-risked in M7:**
+   TFT_eSPI force-defines `SUPPORT_TRANSACTIONS` on ESP32 (its raw-register fast
+   path still takes the SPI HAL mutex), RadioLib does no SPI from ISRs, and mesh +
+   UI loops share one task — so there is NO radio/display race (disproven theory,
+   don't re-chase; see the debug log). CS discipline is now enforced at boot:
+   `TLoraPagerBoard::begin()` parks LORA_NSS/LORA_RST/SD_CS/NFC_CS OUTPUT-HIGH
+   before any bus traffic (LilyGoLib's `initShareSPIPins()` equivalent).
+7. **NVS-preserving flash chain** applies here too — 4-component flash, never the
+   merged image (wipes saved Wi-Fi creds).
+8. **222-px vertical layout not yet audited against real constants** —
+   `STATUSBAR_H`/`TABBAR_H`/`CHAT_KB_H` and the modal/chat height helpers were
+   deliberately left untouched in M6 rather than guessing slimmer values
+   desk-side; the 480×222 branch compiles and boots (verified by the wordmark
+   centering math already being generic), but whether every screen actually
+   fits without clipping/overlap at 222 px tall can only be judged on real
+   hardware. Do this first in M8, before the broader nav-coverage pass.
+9. **Keyboard backlight not wired to any timer/UI — RESOLVED 2026-07-10
+   (commit `c9033a3`).** `pagerKeyboardSetBacklight()` (M5) worked standalone
+   but nothing called it. Fixed with a new `updatePagerKbBacklight()` per-tick
+   apply step (simple on/off at full LEDC duty — no brightness curve, unlike
+   the T-Deck's dimmable slider) plus a "Keyboard backlight" cycle row
+   (off/on/auto) in Settings → Keyboard. Also fixed auto mode never actually
+   responding to input in the same commit: neither `handleHwKey()` nor
+   `updatePagerEncoder()` called `noteKbActivity()` (the keyboard-backlight
+   idle timer), only the separate `noteUserInput()` (screen idle timer) — both
+   now stamp it. Hardware-verified.
+10. **TX power default — RESOLVED 2026-07-07 (commit `b3c6388`).** Was
+   conservatively set to `LORA_TX_POWER=10` with no way to raise it (unlike
+   the T-Deck, which boots at its chip's real ceiling), following the same
+   "conservative default, tune on hardware later" note as risk 1g. Found via
+   a real DM test against a second mesh node: adverts/DMs sent FROM the
+   pager were unreliable while inbound reception was fine — the far node's
+   own TX power was unaffected, an asymmetric-range signature pointing
+   straight at the pager's own TX being too weak (10dBm is ~16x less power
+   than 22dBm). Fixed to `LORA_TX_POWER=22`, matching the T-Deck's pattern.
+   22dBm confirmed as a real, safe ceiling for this chip below 1GHz — not a
+   guess carried over from the sibling boards — via RadioLib's pinned
+   `LR1120::checkOutputPower()` source (LR1121 inherits it: the HP PA
+   auto-selects above 14dBm, valid range -9..22) and cross-checked against
+   trail-mate's own working `TRAIL_MATE_LORA_TX_POWER_MAX_DBM=22` for this
+   exact board. **Caveat**: a device already flashed before this fix keeps
+   its saved `tx_power_dbm=10` preference — the new compiled default only
+   applies to a fresh/factory-reset device; raise it manually in
+   Settings → Radio & Mesh on units that predate this commit.
+   **Retested against a second mesh node 2026-07-11: confirmed reliable**
+   (adverts/DMs both directions) — the fix holds, not just a theoretical
+   RadioLib-ceiling argument.
+11. **Keyboard/encoder-driven scroll-into-view doesn't repaint on this
+   board — ACCEPTED as workaround-final 2026-07-13, root cause not
+   pursued further.** User's call: the Alt+turn workaround (shipped
+   2026-07-07, commit `df7f9bc`) is the practical fix for this hardware —
+   a genuine root-cause attempt already made things measurably worse and
+   was reverted (see below), so further root-causing is not planned unless
+   new evidence surfaces. `navFocusCb`'s `lv_obj_scroll_to_view(f, LV_ANIM_OFF)` (the
+   call every board's keyboard/trackball nav relies on to bring a newly-
+   focused off-screen field into view) updates LVGL's internal scroll
+   model correctly on the pager — confirmed via hardware serial logging
+   that focus reaches fields far down a tall settings page (their
+   blur-to-save toasts fire in order) and `lv_obj_get_scroll_y()` genuinely
+   changes — but the glass never repaints to show the new scroll position.
+   A small new overlay (the toast itself) still paints fine, since that's a
+   fresh object, not a repaint of already-rendered scrolled content. This
+   never surfaced on the T-Deck/Heltec V4 because touch-drag scrolling
+   there never exercises this code path at all (gesture scrolling
+   re-invalidates every animation tick, which happens to paper over the
+   same underlying gap a single one-shot `LV_ANIM_OFF` call doesn't cover)
+   — so it's a latent bug in shared nav code, not something pager-specific
+   in origin, just the first board with no touch fallback to mask it.
+   **Attempted fix that made it WORSE, reverted**: forcing an extra
+   `lv_obj_invalidate()` on the scrolled ancestor right after
+   `scroll_to_view` — this made individual focus highlights eventually
+   repaint, but very slowly (~5 encoder presses per visible update), and
+   still never actually scrolled the viewport. Do not re-attempt this exact
+   fix without new evidence. **Workaround shipped instead** (not a fix):
+   holding the pager's orange Alt key + turning the encoder now
+   free-scrolls the whole page via `navScrollFocused()`'s **animated**
+   `lv_obj_scroll_by` (`LV_ANIM_ON`), which empirically DOES repaint
+   correctly — consistent with the animation-tick theory above — then
+   snaps focus to whatever's nearest the top of the now-visible viewport
+   (`navRefocusFirstVisible()`, new). Plain NEXT/PREV navigation into an
+   off-screen field on a tall settings page (Radio & Mesh, Profile, etc.)
+   is still broken without using the Alt+turn workaround, and that's
+   accepted — the Alt+turn gesture is the intended way to reach an
+   off-screen field on a tall settings page going forward, not a stopgap.
+   Root-causing the one-shot-invalidate failure (or checking whether the
+   same gap exists on the touch-less Tanmatsu) is NOT planned work unless
+   something forces it back open.
+12. **Radio & Mesh settings: blur auto-save re-ran a full flash write + live
+   radio SPI reconfigure on every field defocus — RESOLVED, pager-only fix
+   (2026-07-08).** User-reported "navigating feels laggy" on this screen
+   specifically, confirmed on hardware via a `uiCp("ui:nav")` diagnostic
+   checkpoint (added, measured zero contribution, then removed — the nav
+   focus-group rebuild was NOT the cause, ruling out risk 11's "maybe it's a
+   slow render pipeline" theory for THIS symptom). Root cause:
+   `saveRadioParamsCb` (`UITask.cpp`) is wired to `LV_EVENT_DEFOCUSED` on
+   every textarea in `buildRadioSettings()` (freq/bw/sf/cr/tx/airtime/region)
+   and unconditionally called `the_mesh.savePrefs()` +
+   `the_mesh.applyRadioFromPrefs()` on blur, even when nothing changed. On
+   touch boards a field only blurs on a deliberate tap-out after an edit —
+   rare. On the pager there's no touch fallback, so plain keyboard/encoder
+   "next field" navigation blurs a field on every step: arrowing through the
+   6-field row re-triggered a real flash write + LR1121 reinit up to six
+   times with zero edits made. Measured on hardware via `[STALL] ui:lvgl`
+   (the callback runs synchronously inside LVGL's event dispatch, so its
+   blocking I/O gets attributed to the `ui:lvgl` checkpoint even though it
+   isn't a rendering cost): 6 escalating stalls per navigation pass, up to
+   8.7s each. **Fix**: skip `setRadioParams()`/region persistence on a
+   silent (DEFOCUSED) blur when the parsed field values already match
+   `NodePrefs`, gated `#if defined(TLORA_PAGER)` so touch boards keep their
+   original always-save-on-blur behavior unchanged. Post-fix hardware
+   capture: one `[STALL] ui:lvgl 702ms` (one-time settings-modal build cost)
+   instead of the 6-stall escalation, user-confirmed "much better now".
+13. **Unread-message LED notification (screen-off glanceable indicator) —
+   INVESTIGATED, DEFERRED, not implemented (2026-07-10).** User asked whether
+   this board could get a Tanmatsu-style "glance at the device anytime and
+   see there's an unread message" indicator while the screen is off. Confirmed
+   from multiple sources — this repo's `pins_arduino.h` ("no onboard status
+   LED"), the full XL9555 channel map and I²C device list in the hardware
+   facts above, the trail-mate reference port (its `board_facts.h` doesn't
+   even carry an `led_present` field), and freshly-fetched vendor sources
+   (LilyGoLib's `docs/hardware/lilygo-t-lora-pager.md` hardware doc and its
+   actual `LilyGo_LoRa_Pager.cpp`/`.h` firmware — the same file that already
+   caught the DISP_RST/ch6 bug, so trusted as ground truth here too) — **this
+   board has no onboard LED of any kind.** Tanmatsu has one: a discrete
+   RGB "envelope" LED on its CH32 coprocessor (`UITask.cpp:2435`,
+   `msgLedRefresh()`/`msgLedFlash()`) that breathes green while unread and
+   flashes white on arrival, independent of screen power. The pager's only
+   real substitute would be pulsing `KB_BACKLIGHT` (GPIO46, wired up this
+   session via `updatePagerKbBacklight()`), but that's the backlight for the
+   ENTIRE physical keyboard, not a single low-current indicator LED — a
+   continuous Tanmatsu-style "breathe while unread" pattern on it would be a
+   real, likely-not-small standby power cost for however long a message sits
+   unread (hours), unlike Tanmatsu's tiny dedicated LED. The bounded
+   alternative (a single brief flash on arrival, mirroring the T-Deck's
+   existing opt-in "Flash on new message", `UITask.cpp:10446`) has negligible
+   power cost but was explicitly rejected by the user as not solving the
+   actual want: a flash you have to be looking at the instant it happens
+   isn't a "come back later and glance at it" indicator, just a gimmick.
+   **Decision: do not implement either variant.** Revisit only if this board
+   ever gets a hardware revision with a real low-power indicator LED, or if a
+   software-only always-partially-on approach becomes acceptable (not
+   currently the case).
+
+## References
+
+- Upstream MeshCore (MIT): `meshcore-dev/MeshCore` — does **NOT** currently have
+  `variants/lilygo_tlora_pager/` or `CustomLR1121*` (re-verified 2026-07-06, see
+  Decision ②); only `CustomLR1110{,Wrapper}.h` exists in `src/helpers/radiolib/`,
+  same as our own core fork. Flasher precedent (unrelated to firmware source):
+  `flasher.meshcore.io/lilygo-t-lora-pager/`
+- Local working port (pin map + LR1121 init + keymap + AW9364/BQ27220/XL9555 usage):
+  `~/dev/trail-mate/boards/tlora_pager/` (esp. `src/tlora_pager_board.cpp initLoRa()`,
+  `include/boards/tlora_pager/tlora_pager_board.h`) and
+  `~/dev/trail-mate/variants/lilygo_tlora_pager/pins_arduino.h`
+- Canonical pin map (ground truth, matches trail-mate exactly): [`espressif/arduino-esp32`
+  `variants/lilygo_tlora_pager/pins_arduino.h`](https://github.com/espressif/arduino-esp32/blob/master/variants/lilygo_tlora_pager/pins_arduino.h)
+- Official hardware doc (chip list, I²C addresses, power-rail table, electrical
+  specs): [LilyGoLib `docs/hardware/lilygo-t-lora-pager.md`](https://github.com/Xinyuan-LilyGO/LilyGoLib/blob/master/docs/hardware/lilygo-t-lora-pager.md) —
+  see the caveat under "Hardware / platform facts" above about its Pins Map
+  table's internal inconsistencies.
+- Hardware docs: LilyGo product page (T-LoRa Pager), CNX-Software 2025-08-12 writeup,
+  Meshtastic device page (`meshtastic.org/docs/hardware/devices/lilygo/tpager/`)
+- In-repo templates: `variants/lilygo_tdeck/` (S3 + SPI radio + shared bus),
+  Tanmatsu keypad-nav path in `src/ui-touch/UITask.cpp`, `TANMATSU_PORT.md` (tracker
+  precedent)
+- TFT_eSPI's ST7796 driver support (ground truth for the CGRAM_OFFSET/
+  colstart/rowstart mechanism, Decision ④): `.pio/libdeps/*/TFT_eSPI/TFT_Drivers/{ST7796_Rotation.h,ST7796_Defines.h}`,
+  cross-checked against `ST7789_Defines.h` and `setAddrWindow()` in
+  `TFT_eSPI.cpp` — pulled via the pinned `bodmer/TFT_eSPI @ ^2.5.43` lib_dep.
+- AW9364 backlight driver actually consumed (not hand-rolled): `lewisxhe/SensorLib`'s
+  `AW9364LedDriver.hpp` (MIT, header-only) — reference copy at
+  `~/dev/trail-mate/.pio/libdeps/*/SensorLib/src/AW9364LedDriver.hpp`.

TLORA_PAGER_SHORTCUTS.md

@@ -0,0 +1,239 @@
+# T-LoRa Pager: Keyboard & Rotary Encoder Guide
+
+The LilyGo T-LoRa Pager has **no touchscreen and no trackball** — every
+screen, every setting, and every chat is driven entirely by the physical
+QWERTY keyboard and the rotary encoder knob. If you're coming from the
+T-Deck or Heltec V4 (touch-first), this is the one board where learning a
+handful of gestures up front pays off immediately. This guide covers both
+radio variants (LR1121 and SX1262) — the UI and input handling are identical
+on both.
+
+## The two inputs
+
+- **Keyboard** — a physical QWERTY matrix with a Space bar, Backspace, Enter,
+  a Shift key, and an orange **Fn/Alt** key (bottom-left). No dedicated Esc,
+  arrow keys, or number row — those are covered by combos below.
+- **Rotary encoder** — turn to move the on-screen focus highlight; click
+  (press the knob) to select. It's your only pointing device, so almost
+  every screen is navigable with turn + click alone.
+
+Everything below only fires while you're **not** actively typing into a text
+field — if a field is focused and you're typing into it, letters type
+normally and these combos step out of the way.
+
+## Rotary encoder
+
+| Gesture | Action | Keyboard equivalent |
+|---|---|---|
+| Turn | Move focus to the next/previous item on screen | **Fn (Alt) tapped alone** moves forward one step (NEXT only — no keyboard way to go backward) |
+| Short click | Select / confirm the focused item | **Enter** |
+| Hold ~1 s, then release | **Back**: closes a popup → closes an open chat → goes Home → Esc (whichever applies first) | **Backspace held ~1 s** |
+| **Fn (Alt) + turn**, on a main tab | Jump directly between the 5 main tabs (Chats / Contacts / Home / Map / Settings) | none — encoder only |
+| **Fn (Alt) + turn**, inside a settings page or chat | Scroll the page up/down | none — encoder only |
+| Turn, with a dropdown open | Scroll through the dropdown's options | none — encoder only |
+| Turn, with the accent picker open | Cycle through the accent variants (see below) | none — encoder only (Fn+Space to enter is shared) |
+| Turn, with the @-mention list open | Cycle through matching contacts (see below) | none — encoder only |
+| Turn, at the oldest/newest **loaded** message in an open chat | Loads more history in that direction and keeps going — see [Chat screen](#chat-screen) | none — encoder only |
+
+The knob doubles as your only way to reach the bottom tab bar — since
+there's no touch to tap an icon, **Fn+turn** while on any main tab is the
+fastest way to switch sections.
+
+## Chat screen
+
+An open chat has no touch-only jump-to-oldest/jump-to-latest buttons on this
+board — everything is reachable by turning and clicking, and the encoder
+behaves a bit differently here than anywhere else in the app.
+
+### Turning through messages
+
+Message history is loaded lazily: only the messages currently near the
+viewport actually exist as on-screen items, and older/newer ones are pulled in
+as you approach them. Turning the encoder normally moves the focus highlight
+one message at a time, and **at the edge of what's currently loaded, it keeps
+going** — the turn instead scrolls the list to pull in the next batch of
+history, then continues moving the highlight onto it. You'll only ever land
+outside the message list (see below) once you've genuinely reached the very
+oldest or very newest message in the whole conversation — never mid-history.
+
+### Leaving the message list
+
+Turning **past the oldest loaded message** (top edge), once there's truly
+nothing more to load, wraps around to whatever the last focusable item on the
+screen is — the channel-settings gear in an open **channel**, or the Send
+button in a **DM** (a DM has no gear to reach). This is plain focus wrap, the
+same as reaching the end of any other list in the app; there's no chat-specific
+handling for this edge.
+
+Turning **past the newest loaded message** (bottom edge) moves into the reply
+row below the messages: quick-reply (△) → emoji → text box → Send. Turning
+further past Send *is* chat-specific: in a channel it goes to the
+channel-settings gear; in a DM (nothing to reach there) it returns you to the
+newest message instead.
+
+### The reply row
+
+Below the messages, turning steps through: **quick-reply (△) → emoji →
+text box → Send**, in that order, in both directions — nothing is skipped.
+Turning past the △ chip (toward the messages) always jumps straight to the
+newest message, regardless of channel or DM.
+
+### Backspace and Fn (Alt) — leaving vs. catching up
+
+These two keys are your shortcuts in and out of "reading mode" on this
+screen, and they do different things depending on whether you've got unread
+messages:
+
+- **Fn (Alt) tapped alone** — jumps straight to the **newest** message and
+  moves focus into the text box, ready to type a reply. This is the
+  deliberate "I'm done reading, let me respond" gesture — it works regardless
+  of where your focus currently is in the chat.
+- **Backspace (tap)** — jumps to whichever message needs your attention:
+  - If there are unread messages, it jumps to the first one — right below the
+    **"NEW ----"** divider — and selects it, so you can then turn forward
+    through your unread messages in order, oldest-of-the-unread first.
+  - If nothing is unread, it jumps to the newest message instead (same
+    destination as Fn+Alt, but leaves focus on the message itself rather than
+    the text box).
+
+Backspace's override above only applies while you're inside an open chat and
+*not* actively editing the text box — the usual rule from the top of this
+guide; with a field focused, Backspace deletes a character as normal.
+Fn (Alt) tap's override fires the same way whether or not the text box
+already has focus, since landing there is the whole point of the gesture.
+
+## Keyboard layout
+
+Base layer (no modifier):
+
+```
+q  w  e  r  t  y  u  i  o  p
+a  s  d  f  g  h  j  k  l  [Enter]
+   z  x  c  v  b  n  m
+[Space]
+```
+
+Hold **Fn (Alt)** for numbers/symbols instead:
+
+```
+1  2  3  4  5  6  7  8  9  0
+*  /  +  -  =  :  '  "  @
+   _  $  ;  ?  !  ,  .
+[Space]
+```
+
+### Shift and Caps Lock
+
+- **Hold Shift + a letter**: that letter (or letters, for as long as you
+  hold Shift) types uppercase — released, typing goes back to lowercase.
+  Real momentary Shift, just like a normal keyboard.
+- **Hold Fn (Alt), then press Shift**: while you're editing a text field,
+  toggles **Caps Lock** on/off — stays uppercase until you repeat the chord.
+  Anywhere else (not editing a field), the chord does nothing.
+- Shift alone, tapped with nothing else, does nothing (as expected).
+- **Hold Fn (Alt), then press Backspace**: jumps straight to the **Home**
+  screen — works everywhere, including while you're actively editing a field
+  (unlike Alt+Shift above, this one isn't context-dependent). Doesn't delete
+  a character or trigger the plain-Backspace gestures below.
+
+### Special keys
+
+| Key | While editing a text field | Otherwise |
+|---|---|---|
+| **Enter** | Send / submit / newline | Select the focused item — or, if a chat message bubble is focused, opens its action menu (Ack / Mention / Copy / Info / Block) |
+| **Backspace** (tap) | Delete a character | In an open chat: jump to your first unread message, or the newest message if nothing's unread — see [Chat screen](#chat-screen) |
+| **Backspace** (hold ~1 s) | — | Same as the encoder's long-press: **Back** |
+| **Backspace** (hold ~1 s) *while the screen is locked* | — | Unlock the screen |
+| **Space** (tap) | Types a space | — |
+| **Space** (double-tap, within 250 ms) | Switches between English and your configured secondary keyboard layout | — |
+| **Space** (hold ~1 s) | — | Locks the screen (shows a "Locking…" progress bar; tapping any key cancels) |
+| **Fn (Alt)** tapped alone (press+release, nothing else) | — | Moves focus to the next field/item — a keyboard-only substitute for a turn of the encoder. In an open chat: jumps to the newest message and focuses the text box instead — see [Chat screen](#chat-screen) |
+
+The **BOOT** button (top of the device) instantly wakes the screen from
+idle-dim. It does *not* unlock a screen you've manually locked with the
+Space-hold gesture above — for that, hold Backspace.
+
+## Accented characters
+
+Typing a letter that has accent variants (all vowels, plus `n c s y t z l r`,
+both cases) pops up a small row of alternatives above the field. To pick one
+without touch:
+
+1. **Fn (Alt) + Space** — jumps focus into the popup.
+2. **Turn the encoder** — cycles through the variants.
+3. **Enter** — confirms your choice and replaces the letter you just typed.
+4. **Backspace** — dismisses the popup and keeps the plain letter.
+
+## @-mentions
+
+Typing `@` followed by a few letters of a contact's name pops up a matching
+list in a channel/group chat. Unlike the accent picker above, this one grabs
+the encoder **immediately** — no Fn+Space needed, since it only appears once
+you've deliberately started typing a mention:
+
+1. **Turn the encoder** — cycles through the matching contacts.
+2. **Enter / encoder click** — confirms the highlighted one, replacing
+   `@partial` with `@FullName ` in your message.
+3. **Backspace** — dismisses the list without touching what you typed.
+
+## Sliders
+
+Any focused slider (Control Center brightness, a Settings slider, the Map
+zoom bar) can't be dragged without touch — instead:
+
+- **Q** — decrease
+- **E** — increase
+
+Each press moves it proportionally (about 20 presses end-to-end) and
+persists the new value immediately, the same as releasing a drag.
+
+## Map screen panning
+
+While the **Map** tab is active:
+
+- **W** — pan north
+- **A** — pan west
+- **S** — pan south
+- **D** — pan east
+
+Each press shifts the view a quarter-screen and reloads tiles/markers as
+needed.
+
+## Keyboard backlight
+
+**Settings → Keyboard → Keyboard backlight** cycles through three modes
+(tap to advance):
+
+- **Off** — always dark
+- **On** — always lit
+- **Auto** (default) — lights up on any keypress, turns off ~3 seconds after
+  the last one
+
+Unlike the T-Deck, this is a plain on/off strip under the keys, not a
+dimmable brightness curve.
+
+## Quick reference
+
+| Input | Action |
+|---|---|
+| Turn encoder (or Fn tap = NEXT only) | Move focus |
+| Turn, at the loaded edge of a chat | Load more history, keep moving — only exits the list at the true oldest/newest message |
+| Click encoder (or Enter) | Select / confirm |
+| Hold encoder ~1s (or hold Backspace ~1s) | Back |
+| Fn + turn (main tab) | Switch tabs |
+| Fn + turn (page/chat) | Scroll |
+| Fn tap alone | Next field (in a chat: jump to newest message + focus the text box) |
+| Hold Shift + letter | Momentary uppercase |
+| Fn + Shift (editing a field) | Toggle Caps Lock |
+| Fn + Shift (not editing a field) | Nothing |
+| Fn + Backspace (anywhere) | Jump to Home |
+| Fn + Space | Enter accent picker |
+| @ + letters (composer) | Auto-focuses the mention list — no Fn+Space needed |
+| Enter | Select / send / message action menu |
+| Backspace (tap) | Delete / in a chat: jump to first unread message, or newest if none |
+| Backspace (hold 1s) | Back, or unlock if locked |
+| Space (tap) | Space |
+| Space (double-tap) | Switch keyboard language |
+| Space (hold 1s) | Lock screen |
+| Q / E (slider focused) | Decrease / increase |
+| W / A / S / D (Map tab) | Pan map north/west/south/east |

boards/attaky_mesh_series.json

@@ -0,0 +1,43 @@
+{
+  "build": {
+    "arduino": {
+      "ldscript": "esp32s3_out.ld",
+      "partitions": "default_16MB.csv",
+      "memory_type": "qio_opi"
+      },
+    "core": "esp32",
+    "extra_flags": [
+      "-DBOARD_HAS_PSRAM",
+      "-DARDUINO_USB_CDC_ON_BOOT=0",
+      "-DARDUINO_USB_MODE=0",
+      "-DARDUINO_RUNNING_CORE=1",
+      "-DARDUINO_EVENT_RUNNING_CORE=1"
+    ],
+    "f_cpu": "240000000L",
+    "f_flash": "80000000L",
+    "flash_mode": "qio",
+    "psram_type": "opi",
+    "hwids": [["0x303A", "0x1001"]],
+    "mcu": "esp32s3",
+    "variant": "attaky_mesh_series"
+  },
+  "connectivity": ["wifi", "bluetooth", "lora"],
+  "debug": {
+    "default_tool": "esp-builtin",
+    "onboard_tools": ["esp-builtin"],
+    "openocd_target": "esp32s3.cfg"
+  },
+  "frameworks": ["arduino", "espidf"],
+  "name": "Attaky Core (ESP32-S3-WROOM-1U-N16R8, 16 MB FLASH, 8 MB OCTAL PSRAM)",
+  "upload": {
+    "flash_size": "16MB",
+    "maximum_ram_size": 8388608,
+    "maximum_size": 16777216,
+    "use_1200bps_touch": true,
+    "wait_for_upload_port": true,
+    "require_upload_port": true,
+    "speed": 115200
+  },
+  "url": "https://attaky.com/",
+  "vendor": "attaky"
+}

boards/heltec_v4_r8.json

@@ -0,0 +1,43 @@
+{
+  "build": {
+    "arduino": {
+      "ldscript": "esp32s3_out.ld",
+      "partitions": "default_16MB.csv",
+      "memory_type": "qio_opi"
+      },
+    "core": "esp32",
+    "extra_flags": [
+      "-DBOARD_HAS_PSRAM",
+      "-DARDUINO_USB_CDC_ON_BOOT=1",
+      "-DARDUINO_USB_MODE=0",
+      "-DARDUINO_RUNNING_CORE=1",
+      "-DARDUINO_EVENT_RUNNING_CORE=1"
+    ],
+    "f_cpu": "240000000L",
+    "f_flash": "80000000L",
+    "flash_mode": "qio",
+    "psram_type": "opi",
+    "hwids": [["0x303A", "0x1001"]],
+    "mcu": "esp32s3",
+    "variant": "heltec_v4"
+  },
+  "connectivity": ["wifi", "bluetooth", "lora"],
+  "debug": {
+    "default_tool": "esp-builtin",
+    "onboard_tools": ["esp-builtin"],
+    "openocd_target": "esp32s3.cfg"
+  },
+  "frameworks": ["arduino", "espidf"],
+  "name": "heltec_wifi_lora_32 v4-R8 (16 MB FLASH, 8 MB OCTAL PSRAM)",
+  "upload": {
+    "flash_size": "16MB",
+    "maximum_ram_size": 8388608,
+    "maximum_size": 16777216,
+    "use_1200bps_touch": true,
+    "wait_for_upload_port": true,
+    "require_upload_port": true,
+    "speed": 921600
+  },
+  "url": "https://heltec.org/",
+  "vendor": "heltec"
+}

boards/lilygo-t-lora-pager.json

@@ -0,0 +1,41 @@
+{
+  "build": {
+    "arduino": {
+      "ldscript": "esp32s3_out.ld",
+      "partitions": "app3M_fat9M_16MB.csv",
+      "memory_type": "qio_qspi"
+    },
+    "core": "esp32",
+    "extra_flags": [
+      "-DBOARD_HAS_PSRAM",
+      "-DARDUINO_USB_MODE=1",
+      "-DARDUINO_RUNNING_CORE=1",
+      "-DARDUINO_EVENT_RUNNING_CORE=1",
+      "-DARDUINO_USB_CDC_ON_BOOT=1"
+    ],
+    "f_cpu": "240000000L",
+    "f_flash": "80000000L",
+    "flash_mode": "qio",
+    "hwids": [["0x303A", "0x82D4"]],
+    "mcu": "esp32s3",
+    "variant": "lilygo_tlora_pager_pins",
+    "variants_dir": "variants"
+  },
+  "connectivity": ["wifi"],
+  "debug": {
+    "default_tool": "esp-builtin",
+    "onboard_tools": ["esp-builtin"],
+    "openocd_target": "esp32s3.cfg"
+  },
+  "frameworks": ["arduino", "espidf"],
+  "name": "LilyGo T-LoRa-Pager (16M Flash 8M QSPI PSRAM )",
+  "upload": {
+    "flash_size": "16MB",
+    "maximum_ram_size": 327680,
+    "maximum_size": 16777216,
+    "require_upload_port": true,
+    "speed": 921600
+  },
+  "url": "https://www.lilygo.cc",
+  "vendor": "LilyGo"
+}

boards/rak_tap_v2.json

@@ -0,0 +1,43 @@
+{
+  "build": {
+    "arduino": {
+      "ldscript": "esp32s3_out.ld",
+      "partitions": "default_16MB.csv",
+      "memory_type": "qio_opi"
+      },
+    "core": "esp32",
+    "extra_flags": [
+      "-DBOARD_HAS_PSRAM",
+      "-DARDUINO_USB_CDC_ON_BOOT=1",
+      "-DARDUINO_USB_MODE=1",
+      "-DARDUINO_RUNNING_CORE=1",
+      "-DARDUINO_EVENT_RUNNING_CORE=1"
+    ],
+    "f_cpu": "240000000L",
+    "f_flash": "80000000L",
+    "flash_mode": "dio",
+    "psram_type": "qspi",
+    "hwids": [["0x303A", "0x1001"]],
+    "mcu": "esp32s3",
+    "variant": "esp32s3"
+  },
+  "connectivity": ["wifi", "bluetooth", "lora"],
+  "debug": {
+    "default_tool": "esp-builtin",
+    "onboard_tools": ["esp-builtin"],
+    "openocd_target": "esp32s3.cfg"
+  },
+  "frameworks": ["arduino", "espidf"],
+  "name": "RAK WisMesh Tap V2 (16 MB FLASH, 8 MB Octal PSRAM)",
+  "upload": {
+    "flash_size": "16MB",
+    "maximum_ram_size": 8388608,
+    "maximum_size": 16777216,
+    "use_1200bps_touch": false,
+    "wait_for_upload_port": false,
+    "require_upload_port": true,
+    "speed": 460800
+  },
+  "url": "https://store.rakwireless.com/products/wismesh-tap-v2",
+  "vendor": "RAKwireless"
+}

boards/thinknode_m9.json

@@ -0,0 +1,40 @@
+{
+  "build": {
+    "arduino": {
+      "ldscript": "esp32s3_out.ld",
+      "partitions": "default_16MB.csv",
+      "memory_type": "qio_opi"
+    },
+    "core": "esp32",
+    "extra_flags": [
+      "-DBOARD_HAS_PSRAM",
+      "-DARDUINO_USB_CDC_ON_BOOT=0",
+      "-DARDUINO_RUNNING_CORE=1",
+      "-DARDUINO_EVENT_RUNNING_CORE=1"
+    ],
+    "f_cpu": "240000000L",
+    "f_flash": "80000000L",
+    "flash_mode": "qio",
+    "psram_type": "opi",
+    "hwids": [["0x303A", "0x1001"]],
+    "mcu": "esp32s3",
+    "variant": "esp32s3"
+  },
+  "connectivity": ["wifi", "bluetooth", "lora", "gps"],
+  "debug": {
+    "default_tool": "esp-builtin",
+    "onboard_tools": ["esp-builtin"],
+    "openocd_target": "esp32s3.cfg"
+  },
+  "frameworks": ["arduino", "espidf"],
+  "name": "Elecrow ThinkNode M9 (16 MB FLASH, 8 MB PSRAM)",
+  "upload": {
+    "flash_size": "16MB",
+    "maximum_ram_size": 327680,
+    "maximum_size": 16777216,
+    "require_upload_port": true,
+    "speed": 921600
+  },
+  "url": "https://www.elecrow.com/",
+  "vendor": "Elecrow"
+}

deploy/gen-meshamerica-catalog.py

@@ -42,39 +42,66 @@ if os.path.exists(nf):
     notes = "\n".join(l.strip() for l in open(nf, encoding="utf-8")
                       if l.strip() and not l.strip().startswith("#"))
 
-# Both touch boards are ESP32-S3, single touch-UI ("gui") role. ota_0 sits at
-# 0x10000 on both (partitions_t*_touch.csv), so flash-update@0x10000 is correct.
+# Every wadamesh tile here is ESP32-S3, touch-UI ("gui") role. ota_0 sits at
+# 0x10000 on every touch env (partitions_t*_touch.csv), so flash-update@0x10000 is correct.
+# `name` MUST match the official MeshCore device name character-for-character, or Mesh America lists it
+# as a NEW device instead of folding our firmware into the existing tile (TJ Downes, 2026-06). Canonical
+# names verified from apps.meshamerica.com/proxy/flasher/config.json. The V4 entry is the Expansion Kit
+# (Touch) variant only, per Kaj. `slug` still maps to our bin filenames on firmware.wadamesh.com.
+#
+# A board may carry `variants` instead of a single `slug`: one "gui" firmware entry is emitted per
+# variant, all under the one tile. The T-Lora Pager ships with either radio, and Mesh America folds both
+# under a single "LilyGo T-Lora Pager" tile distinguished by a [RADIO] title prefix — matching how their
+# own stock pager entries are labelled ([SX1262]/[LR1121]), so ours sit naturally alongside them.
 BOARDS = [
-    {"name": "wadamesh — Heltec V4 TFT", "slug": "heltec-v4-tft"},
-    {"name": "wadamesh — LilyGo T-Deck", "slug": "tdeck"},
+    {"name": "Heltec v4 + Expansion Kit (Touch)", "slug": "heltec-v4-tft"},
+    {"name": "LilyGo T-Deck", "slug": "tdeck"},
+    {"name": "LilyGo T-Lora Pager", "variants": [
+        {"title": "[LR1121] Touch UI", "slug": "tlora-pager-lr1121"},
+        {"title": "[SX1262] Touch UI", "slug": "tlora-pager-sx1262"},
+    ]},
 ]
 
+def _firmware(title, slug):
+    merged, appbin = "wadamesh-%s-merged.bin" % slug, "wadamesh-%s.bin" % slug
+    return {
+        "role": "gui",
+        "title": title,
+        "version": {TAG: {
+            "notes": notes,
+            "files": [
+                {"type": "flash-wipe",   "name": merged,
+                 "url": "%s/%s" % (BASE, merged),
+                 "title": "Full install (bootloader + firmware)"},
+                {"type": "flash-update", "name": appbin,
+                 "url": "%s/%s" % (BASE, appbin),
+                 "title": "Update (app only)"},
+            ],
+        }},
+    }
+
 def device(b):
-    merged, appbin = "wadamesh-%s-merged.bin" % b["slug"], "wadamesh-%s.bin" % b["slug"]
+    # `variants` (per-radio builds) fold under one tile; a plain board is the single default variant.
+    variants = b.get("variants") or [{"title": "Touch UI", "slug": b["slug"]}]
     return {
         "maker": "wadamesh",
         "class": "wadamesh",
         "name": b["name"],
         "type": "esp32",
         "tooltip": "<img class='device' src='%s'>" % ICON,
-        "firmware": [{
-            "role": "gui",
-            "title": "Touch UI",
-            "version": {TAG: {
-                "notes": notes,
-                "files": [
-                    {"type": "flash-wipe",   "name": merged,
-                     "url": "%s/%s" % (BASE, merged),
-                     "title": "Full install (bootloader + firmware)"},
-                    {"type": "flash-update", "name": appbin,
-                     "url": "%s/%s" % (BASE, appbin),
-                     "title": "Update (app only)"},
-                ],
-            }},
-        }],
+        "firmware": [_firmware(v["title"], v["slug"]) for v in variants],
     }
 
+# Optional "what's this?" blurb Mesh America shows on a hover tooltip next to our provider badge
+# (spec section 3, added by TJ 2026-06-30). Plain text only — rendered escaped, so no markup/links.
+DESCRIPTION = (
+    "WADAMESH is a full touch-screen interface for MeshCore: on-device chat, contacts, a live map "
+    "with offline tiles, and complete radio settings. Same MeshCore protocol and phone-app companion "
+    "as stock MeshCore, just a richer on-device front-end."
+)
+
 catalog = {
+    "description": DESCRIPTION,
     "maker":  {"wadamesh": {"name": "wadamesh"}},
     "device": [device(b) for b in BOARDS],
 }

deploy/meshamerica-catalog.json

@@ -1,4 +1,5 @@
 {
+  "description": "WADAMESH is a full touch-screen interface for MeshCore: on-device chat, contacts, a live map with offline tiles, and complete radio settings. Same MeshCore protocol and phone-app companion as stock MeshCore, just a richer on-device front-end.",
   "maker": {
     "wadamesh": {
       "name": "wadamesh"
@@ -8,7 +9,7 @@
     {
       "maker": "wadamesh",
       "class": "wadamesh",
-      "name": "wadamesh — Heltec V4 TFT",
+      "name": "Heltec v4 + Expansion Kit (Touch)",
       "type": "esp32",
       "tooltip": "<img class='device' src='https://wadamesh.com/wadamesh-icon-512.png'>",
       "firmware": [
@@ -16,19 +17,19 @@
           "role": "gui",
           "title": "Touch UI",
           "version": {
-            "beta_20": {
-              "notes": "Spectrum analyzer: a new app in the app drawer that sweeps the LoRa band and draws a live spectrum with a waterfall under it, a colour scale on the side and a peak-frequency readout. Handy for spotting interference or finding a quiet part of the band before you settle on a frequency.\nCustom notification sounds: you can set your own notification sound from a 16-bit WAV file on the SD card, per event, instead of only the built-in chime. There is also a separate switch for the direct-message chime.\nSaved Wi-Fi networks: the device remembers more than one network now and can auto-join them. Each saved network has its own auto-join switch and can be forgotten on its own.\nOne chat settings screen: the gear on a chat or channel row, a long-press on that row, and the cog inside an open chat now all open the same screen. Everything is in one place: mark as read, mute messages, mute mentions, region and scope, share secret, blocked users, and remove or delete.\nPer-channel mute: silence the notification sound for a single channel while the rest keep chiming.\nHigh-gain receiver for the Heltec V4.3: the V4.3 front-end module has a roughly 17 dB receive amplifier that the firmware never switched on, so every V4.3 shipped with it bypassed. There is now a \"High-gain receiver (FEM LNA)\" toggle under Radio and Mesh, in the Signal section. Turning it on can noticeably improve weak-signal reception in quiet or remote spots; in a noisy area it can overload the front end, so it is off by default. V4.2 boards do not have this amplifier and do not show the toggle. Thanks to Wireless Rocks for the report and the measurements.\nApps button on the Heltec V4 home screen: the V4 home screen now has an Apps button next to Send advert, so the app drawer (Spectrum, RF Monitor, Snake and the rest) is one tap away. The T-Deck and Tanmatsu already had this.\nBlocked list is easier to reach: open it from Contacts (the overflow menu) and from the chat settings screen, not only from where it used to live.\nPortuguese (Brazil) is now a UI language, which brings the total to twelve. Community translation.\nAdverts sent from the touch screen are now relayed by region-scoped repeaters. The advert went out without a region tag, so a repeater set to a single region dropped it, while the same advert sent from the phone app got through. The device now tags its flood advert the same way the phone companion does. (Issue #68, reported by EricMW61.)\nA message could be transmitted on the wrong channel. After you added or removed channels the cached channel index could drift, so a message typed in one channel was sent on another channel's key. It looked correct on your own screen but arrived in the other channel. The send path now matches the target channel by name at the moment of sending, so this can no longer happen.\nRoom server logins could time out when the only route to the server was through a region-scoped repeater. A new opt-in toggle, \"Scope direct messages to region\" under Radio and Mesh, in the Signal section, tags your direct, login and admin messages with your region so a region-only repeater will relay them. It is off by default, so cross-region messaging is unchanged for anyone who does not need it. (Issue #64, reported by randelreiss.)\nThe Wi-Fi scan could come back empty. If a scan ran while the device was already connected, the automatic reconnect could cancel it mid-sweep and the list returned zero networks. The scan and the reconnect no longer fight over the radio, and the SSID list loads reliably again.\nFlood scoping was reworked so channel floods and direct floods are handled separately. Channel and group messages stay tagged with your region scope so public channels remain contained, while direct messages, logins and admin traffic stay unscoped by default to keep cross-region messaging working. The new region-scope toggle opts the direct traffic into the region tag (issue #64), and the advert path was moved onto the same scoping the phone companion already used (issue #68).\nThe Spectrum app and the mesh share one radio. While Spectrum is open it takes ownership of the SX1262 so the mesh loop does not re-tune or re-arm receive underneath the sweep, and leaving the app restores the mesh radio settings and resumes normal receive. The sweep also waits out the chip's RSSI settle time after each retune and takes a short peak reading per step, so the trace shows real energy instead of the reset floor.\nA shared flag now tells the main loop when a Wi-Fi scan is running, so the periodic reconnect does not disconnect and reconnect during a sweep, and auto-reconnect is paused for the length of the scan.\nThe Heltec V4.3 front-end module (KCT8103L) is now driven for receive with its low-noise amplifier behind the new setting. This is the large amplifier and it is separate from the SX1262's own internal RX-boost bit, which is only a fraction of a dB.\nThe new settings (per-channel mute, custom sounds, saved WLine truncated
+            "beta_50": {
+              "notes": "Fixed the on-device updater downloading the wrong firmware on several boards. The V4-R8, ThinkNode M9, RAK Tap V2, T-LoRa Pager and Attaky now each pull their own build instead of the Heltec V4 TFT one.\nT-Display P4: the \"Get test builds (beta)\" toggle and the on-device update now appear. They were hidden before, so the P4 could only be updated over USB. Newly enabled, please test and report.\nLock screen fixed: tap Backspace to peek the screen without unlocking, hold Backspace to unlock. The clock and text are repositioned to fit the wide screen and stay readable.\nOn-screen keyboard now works with the detachable keyboard module: the keys stay down while the module is attached, and the module's # key brings them back up for symbols. The POWER button toggles the screen and wakes the board.\nBoard fixes: correct LoRa clock (no false TCXO), GPS baud, and sensor probing that was colliding with the touch and keyboard chips.",
               "files": [
                 {
                   "type": "flash-wipe",
                   "name": "wadamesh-heltec-v4-tft-merged.bin",
-                  "url": "https://firmware.wadamesh.com/releases/TOUCH/beta_20/wadamesh-heltec-v4-tft-merged.bin",
+                  "url": "https://firmware.wadamesh.com/releases/TOUCH/beta_50/wadamesh-heltec-v4-tft-merged.bin",
                   "title": "Full install (bootloader + firmware)"
                 },
                 {
                   "type": "flash-update",
                   "name": "wadamesh-heltec-v4-tft.bin",
-                  "url": "https://firmware.wadamesh.com/releases/TOUCH/beta_20/wadamesh-heltec-v4-tft.bin",
+                  "url": "https://firmware.wadamesh.com/releases/TOUCH/beta_50/wadamesh-heltec-v4-tft.bin",
                   "title": "Update (app only)"
                 }
               ]
@@ -40,7 +41,7 @@
     {
       "maker": "wadamesh",
       "class": "wadamesh",
-      "name": "wadamesh — LilyGo T-Deck",
+      "name": "LilyGo T-Deck",
       "type": "esp32",
       "tooltip": "<img class='device' src='https://wadamesh.com/wadamesh-icon-512.png'>",
       "firmware": [
@@ -48,19 +49,74 @@
           "role": "gui",
           "title": "Touch UI",
           "version": {
-            "beta_20": {
-              "notes": "Spectrum analyzer: a new app in the app drawer that sweeps the LoRa band and draws a live spectrum with a waterfall under it, a colour scale on the side and a peak-frequency readout. Handy for spotting interference or finding a quiet part of the band before you settle on a frequency.\nCustom notification sounds: you can set your own notification sound from a 16-bit WAV file on the SD card, per event, instead of only the built-in chime. There is also a separate switch for the direct-message chime.\nSaved Wi-Fi networks: the device remembers more than one network now and can auto-join them. Each saved network has its own auto-join switch and can be forgotten on its own.\nOne chat settings screen: the gear on a chat or channel row, a long-press on that row, and the cog inside an open chat now all open the same screen. Everything is in one place: mark as read, mute messages, mute mentions, region and scope, share secret, blocked users, and remove or delete.\nPer-channel mute: silence the notification sound for a single channel while the rest keep chiming.\nHigh-gain receiver for the Heltec V4.3: the V4.3 front-end module has a roughly 17 dB receive amplifier that the firmware never switched on, so every V4.3 shipped with it bypassed. There is now a \"High-gain receiver (FEM LNA)\" toggle under Radio and Mesh, in the Signal section. Turning it on can noticeably improve weak-signal reception in quiet or remote spots; in a noisy area it can overload the front end, so it is off by default. V4.2 boards do not have this amplifier and do not show the toggle. Thanks to Wireless Rocks for the report and the measurements.\nApps button on the Heltec V4 home screen: the V4 home screen now has an Apps button next to Send advert, so the app drawer (Spectrum, RF Monitor, Snake and the rest) is one tap away. The T-Deck and Tanmatsu already had this.\nBlocked list is easier to reach: open it from Contacts (the overflow menu) and from the chat settings screen, not only from where it used to live.\nPortuguese (Brazil) is now a UI language, which brings the total to twelve. Community translation.\nAdverts sent from the touch screen are now relayed by region-scoped repeaters. The advert went out without a region tag, so a repeater set to a single region dropped it, while the same advert sent from the phone app got through. The device now tags its flood advert the same way the phone companion does. (Issue #68, reported by EricMW61.)\nA message could be transmitted on the wrong channel. After you added or removed channels the cached channel index could drift, so a message typed in one channel was sent on another channel's key. It looked correct on your own screen but arrived in the other channel. The send path now matches the target channel by name at the moment of sending, so this can no longer happen.\nRoom server logins could time out when the only route to the server was through a region-scoped repeater. A new opt-in toggle, \"Scope direct messages to region\" under Radio and Mesh, in the Signal section, tags your direct, login and admin messages with your region so a region-only repeater will relay them. It is off by default, so cross-region messaging is unchanged for anyone who does not need it. (Issue #64, reported by randelreiss.)\nThe Wi-Fi scan could come back empty. If a scan ran while the device was already connected, the automatic reconnect could cancel it mid-sweep and the list returned zero networks. The scan and the reconnect no longer fight over the radio, and the SSID list loads reliably again.\nFlood scoping was reworked so channel floods and direct floods are handled separately. Channel and group messages stay tagged with your region scope so public channels remain contained, while direct messages, logins and admin traffic stay unscoped by default to keep cross-region messaging working. The new region-scope toggle opts the direct traffic into the region tag (issue #64), and the advert path was moved onto the same scoping the phone companion already used (issue #68).\nThe Spectrum app and the mesh share one radio. While Spectrum is open it takes ownership of the SX1262 so the mesh loop does not re-tune or re-arm receive underneath the sweep, and leaving the app restores the mesh radio settings and resumes normal receive. The sweep also waits out the chip's RSSI settle time after each retune and takes a short peak reading per step, so the trace shows real energy instead of the reset floor.\nA shared flag now tells the main loop when a Wi-Fi scan is running, so the periodic reconnect does not disconnect and reconnect during a sweep, and auto-reconnect is paused for the length of the scan.\nThe Heltec V4.3 front-end module (KCT8103L) is now driven for receive with its low-noise amplifier behind the new setting. This is the large amplifier and it is separate from the SX1262's own internal RX-boost bit, which is only a fraction of a dB.\nThe new settings (per-channel mute, custom sounds, saved WLine truncated
+            "beta_50": {
+              "notes": "Fixed the on-device updater downloading the wrong firmware on several boards. The V4-R8, ThinkNode M9, RAK Tap V2, T-LoRa Pager and Attaky now each pull their own build instead of the Heltec V4 TFT one.\nT-Display P4: the \"Get test builds (beta)\" toggle and the on-device update now appear. They were hidden before, so the P4 could only be updated over USB. Newly enabled, please test and report.\nLock screen fixed: tap Backspace to peek the screen without unlocking, hold Backspace to unlock. The clock and text are repositioned to fit the wide screen and stay readable.\nOn-screen keyboard now works with the detachable keyboard module: the keys stay down while the module is attached, and the module's # key brings them back up for symbols. The POWER button toggles the screen and wakes the board.\nBoard fixes: correct LoRa clock (no false TCXO), GPS baud, and sensor probing that was colliding with the touch and keyboard chips.",
               "files": [
                 {
                   "type": "flash-wipe",
                   "name": "wadamesh-tdeck-merged.bin",
-                  "url": "https://firmware.wadamesh.com/releases/TOUCH/beta_20/wadamesh-tdeck-merged.bin",
+                  "url": "https://firmware.wadamesh.com/releases/TOUCH/beta_50/wadamesh-tdeck-merged.bin",
                   "title": "Full install (bootloader + firmware)"
                 },
                 {
                   "type": "flash-update",
                   "name": "wadamesh-tdeck.bin",
-                  "url": "https://firmware.wadamesh.com/releases/TOUCH/beta_20/wadamesh-tdeck.bin",
+                  "url": "https://firmware.wadamesh.com/releases/TOUCH/beta_50/wadamesh-tdeck.bin",
+                  "title": "Update (app only)"
+                }
+              ]
+            }
+          }
+        }
+      ]
+    },
+    {
+      "maker": "wadamesh",
+      "class": "wadamesh",
+      "name": "LilyGo T-Lora Pager",
+      "type": "esp32",
+      "tooltip": "<img class='device' src='https://wadamesh.com/wadamesh-icon-512.png'>",
+      "firmware": [
+        {
+          "role": "gui",
+          "title": "[LR1121] Touch UI",
+          "version": {
+            "beta_50": {
+              "notes": "Fixed the on-device updater downloading the wrong firmware on several boards. The V4-R8, ThinkNode M9, RAK Tap V2, T-LoRa Pager and Attaky now each pull their own build instead of the Heltec V4 TFT one.\nT-Display P4: the \"Get test builds (beta)\" toggle and the on-device update now appear. They were hidden before, so the P4 could only be updated over USB. Newly enabled, please test and report.\nLock screen fixed: tap Backspace to peek the screen without unlocking, hold Backspace to unlock. The clock and text are repositioned to fit the wide screen and stay readable.\nOn-screen keyboard now works with the detachable keyboard module: the keys stay down while the module is attached, and the module's # key brings them back up for symbols. The POWER button toggles the screen and wakes the board.\nBoard fixes: correct LoRa clock (no false TCXO), GPS baud, and sensor probing that was colliding with the touch and keyboard chips.",
+              "files": [
+                {
+                  "type": "flash-wipe",
+                  "name": "wadamesh-tlora-pager-lr1121-merged.bin",
+                  "url": "https://firmware.wadamesh.com/releases/TOUCH/beta_50/wadamesh-tlora-pager-lr1121-merged.bin",
+                  "title": "Full install (bootloader + firmware)"
+                },
+                {
+                  "type": "flash-update",
+                  "name": "wadamesh-tlora-pager-lr1121.bin",
+                  "url": "https://firmware.wadamesh.com/releases/TOUCH/beta_50/wadamesh-tlora-pager-lr1121.bin",
+                  "title": "Update (app only)"
+                }
+              ]
+            }
+          }
+        },
+        {
+          "role": "gui",
+          "title": "[SX1262] Touch UI",
+          "version": {
+            "beta_50": {
+              "notes": "Fixed the on-device updater downloading the wrong firmware on several boards. The V4-R8, ThinkNode M9, RAK Tap V2, T-LoRa Pager and Attaky now each pull their own build instead of the Heltec V4 TFT one.\nT-Display P4: the \"Get test builds (beta)\" toggle and the on-device update now appear. They were hidden before, so the P4 could only be updated over USB. Newly enabled, please test and report.\nLock screen fixed: tap Backspace to peek the screen without unlocking, hold Backspace to unlock. The clock and text are repositioned to fit the wide screen and stay readable.\nOn-screen keyboard now works with the detachable keyboard module: the keys stay down while the module is attached, and the module's # key brings them back up for symbols. The POWER button toggles the screen and wakes the board.\nBoard fixes: correct LoRa clock (no false TCXO), GPS baud, and sensor probing that was colliding with the touch and keyboard chips.",
+              "files": [
+                {
+                  "type": "flash-wipe",
+                  "name": "wadamesh-tlora-pager-sx1262-merged.bin",
+                  "url": "https://firmware.wadamesh.com/releases/TOUCH/beta_50/wadamesh-tlora-pager-sx1262-merged.bin",
+                  "title": "Full install (bootloader + firmware)"
+                },
+                {
+                  "type": "flash-update",
+                  "name": "wadamesh-tlora-pager-sx1262.bin",
+                  "url": "https://firmware.wadamesh.com/releases/TOUCH/beta_50/wadamesh-tlora-pager-sx1262.bin",
                   "title": "Update (app only)"
                 }
               ]

deploy/nginx/firmware.wadamesh.com.conf

@@ -25,12 +25,22 @@ server {
     root /srv/wadamesh/firmware;
 
     # The update-check feed — served at the no-slash path the firmware requests.
+    # STABLE channel (the default on-device update check).
     location = /releases/TOUCH {
         default_type application/json;
         alias /srv/wadamesh/firmware/releases/TOUCH/index.json;
         add_header Cache-Control "public, max-age=60";
     }
 
+    # Same, for the opt-in TEST/BETA channel — what a device requests when the
+    # "Get test builds (beta)" switch is on. Without this exact-match the no-slash
+    # path 301-redirects to a dir with no index and the beta check comes back empty.
+    location = /releases/BETA {
+        default_type application/json;
+        alias /srv/wadamesh/firmware/releases/BETA/index.json;
+        add_header Cache-Control "public, max-age=60";
+    }
+
     # Bins + everything else under /releases/. CORS so the browser flasher
     # (flasher.wadamesh.com) can fetch the images cross-origin.
     location /releases/ {
@@ -41,7 +51,7 @@ server {
     }
 
     # Rolling "latest" merged images — the web flasher's manifests point here so
-    # they always install the newest build (release.sh refreshes this dir).
+    # they always install the newest build (release.sh refreshes this dir). STABLE.
     location /latest/ {
         autoindex off;
         types { application/octet-stream bin; }
@@ -49,5 +59,15 @@ server {
         add_header Access-Control-Allow-Origin "*";
     }
 
+    # Rolling "latest" for the TEST/BETA channel — the beta web-flasher feed
+    # (version.json + manifests + rolling bins). Without this it falls to the
+    # catch-all 404 and the flasher's beta toggle can't load metadata.
+    location /latest-beta/ {
+        autoindex off;
+        types { application/octet-stream bin; }
+        add_header Cache-Control "public, max-age=300";
+        add_header Access-Control-Allow-Origin "*";
+    }
+
     location / { return 404; }
 }

deploy/site/docs.html

@@ -0,0 +1,605 @@
+<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>WADAMESH — Documentation</title>
+<meta name="description" content="User guide for the WADAMESH touch firmware on the LilyGo T-Deck: home, chat, contacts, map, settings and the built-in apps. Real device screenshots.">
+<link rel="icon" href="wadamesh-badge.svg">
+<link rel="preconnect" href="https://fonts.googleapis.com">
+<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+<link href="https://fonts.googleapis.com/css2?family=JetBrains+Mono:wght@600;700&display=swap" rel="stylesheet">
+<style>
+  :root{
+    --bg:#ffffff; --bg2:#f4f6f2; --ink:#15181e; --mut:#5d6770;
+    --line:#e5e8e2; --teal:#15b6a6; --teal-ink:#0e8d80;
+    color-scheme:light;
+  }
+  *{box-sizing:border-box;margin:0;padding:0}
+  html{scroll-behavior:smooth}
+  body{font:16px/1.65 -apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,Inter,sans-serif; background:var(--bg); color:var(--ink); -webkit-font-smoothing:antialiased}
+  a{color:var(--teal-ink); text-decoration:none}
+
+  .top{position:sticky; top:0; z-index:30; display:flex; align-items:center; gap:14px; padding:12px 22px;
+    background:rgba(255,255,255,.88); backdrop-filter:saturate(1.2) blur(8px); border-bottom:1px solid var(--line)}
+  .top .word{font-weight:700; letter-spacing:2px; font-size:1.05rem; color:var(--ink)}
+  .top .word .t{color:var(--teal)}
+  .top .tag{font-family:'JetBrains Mono',monospace; font-size:.66rem; letter-spacing:.18em; text-transform:uppercase; color:var(--mut); border:1px solid var(--line); border-radius:100px; padding:4px 9px}
+  .top .sp{flex:1}
+  .top .home{display:inline-flex; align-items:center; gap:7px; color:var(--mut); font-size:.86rem; border:1px solid var(--line); border-radius:100px; padding:6px 13px; background:#fff; transition:background .15s,color .15s,border-color .15s}
+  .top .home:hover{color:var(--teal-ink); background:var(--bg2); border-color:#bfe6e0}
+  .top .home svg{width:16px;height:16px}
+
+  .shell{max-width:1200px; margin:0 auto; display:grid; grid-template-columns:220px 1fr; gap:34px; padding:0 22px}
+  nav.toc{position:sticky; top:64px; align-self:start; height:calc(100vh - 64px); overflow:auto; padding:26px 0 40px}
+  nav.toc .grp{font-family:'JetBrains Mono',monospace; font-size:.68rem; letter-spacing:.13em; text-transform:uppercase; color:var(--mut); margin:20px 0 7px}
+  nav.toc .grp:first-child{margin-top:0}
+  nav.toc a{display:block; padding:6px 12px; border-radius:9px; color:#46525c; font-size:.92rem; border-left:2px solid transparent}
+  nav.toc a:hover{background:var(--bg2); color:var(--ink)}
+  nav.toc a.on{color:var(--teal-ink); background:rgba(21,182,166,.09); border-left-color:var(--teal); font-weight:600}
+
+  main{padding:30px 0 90px; min-width:0}
+  .hero h1{font-size:clamp(1.9rem,4.4vw,2.6rem); letter-spacing:-.5px; font-weight:750}
+  .hero p{color:var(--mut); max-width:64ch; margin-top:10px; font-size:1.05rem}
+  .hero .meta{display:flex; gap:8px; flex-wrap:wrap; margin-top:16px}
+  .chip{display:inline-flex; align-items:center; gap:6px; font-size:.8rem; color:#3a444d; border:1px solid var(--line); border-radius:100px; padding:5px 11px; background:#fff}
+  .chip svg{width:14px;height:14px;color:var(--teal)}
+
+  section.doc{padding:36px 0; border-top:1px solid var(--line); scroll-margin-top:74px}
+  .doc h2{font-size:1.5rem; font-weight:730; letter-spacing:-.3px; display:flex; align-items:center; gap:10px}
+  .doc h2 .ico{width:30px;height:30px;border-radius:9px;display:grid;place-items:center;flex:none; background:rgba(21,182,166,.12);color:var(--teal)}
+  .doc h2 .ico svg{width:18px;height:18px}
+  .row{display:grid; grid-template-columns:minmax(0,1fr) 372px; gap:34px; align-items:start; margin-top:16px}
+  @media(max-width:980px){.row{grid-template-columns:1fr}}
+  .prose{color:#3c454d; min-width:0}
+  .prose p{margin:0 0 12px}
+  .prose h3{font-size:1.02rem; margin:18px 0 6px; color:var(--ink)}
+  .prose ul{margin:4px 0 12px; padding-left:18px}
+  .prose li{margin:4px 0}
+  .prose b{color:var(--ink)}
+  .prose code{font-family:'JetBrains Mono',monospace; font-size:.85em; background:var(--bg2); border:1px solid var(--line); border-radius:6px; padding:1px 6px}
+  .shot{position:sticky; top:74px}
+  .cap{text-align:center; font-family:'JetBrains Mono',monospace; font-size:.68rem; color:var(--mut); margin-top:10px; letter-spacing:.04em}
+
+  /* T-Deck frame: the real screenshot + a generated QWERTY keyboard (added in JS) */
+  .device{width:344px; margin:0 auto; background:#16191d; border-radius:16px; padding:12px 12px 9px; border:1px solid #e9ece7; box-shadow:0 24px 60px -30px rgba(21,24,30,.5)}
+  .device img.screen{display:block; width:320px; height:240px; border-radius:8px}
+  .kbd{margin:9px auto 2px; display:flex; flex-direction:column; gap:4px; width:312px}
+  .kr{display:flex; gap:4px; justify-content:center}
+  .key{flex:1; max-width:28px; height:15px; background:#23282e; border-radius:4px; display:grid; place-items:center; font:8px/1 system-ui; color:#7d8893}
+  .key.wide{max-width:140px; flex:4}
+
+  .gallery{display:grid; grid-template-columns:repeat(auto-fill,minmax(232px,1fr)); gap:20px; margin-top:18px}
+  .mini{background:#16191d; border-radius:12px; padding:7px; border:1px solid #e9ece7}
+  .mini img{display:block; width:100%; height:auto; border-radius:6px}
+  .mini .cap{margin-top:6px}
+  .webgrid{display:grid; grid-template-columns:repeat(auto-fill,minmax(178px,1fr)); gap:18px; margin-top:22px}
+  figure.phone{margin:0; background:#16191d; border-radius:20px; padding:8px; border:1px solid #e9ece7; box-shadow:0 18px 44px -26px rgba(21,24,30,.5)}
+  figure.phone img{display:block; width:100%; height:auto; border-radius:13px}
+  figure.phone figcaption{text-align:center; font-family:'JetBrains Mono',monospace; font-size:.66rem; color:var(--mut); margin-top:8px; letter-spacing:.04em}
+  .subh{font-size:1.06rem; font-weight:700; color:var(--ink); margin:30px 0 2px}
+
+  /* Settings-page detail cards: real screenshot + what the page does + its controls */
+  .sgrp{font-family:'JetBrains Mono',monospace; font-size:.7rem; letter-spacing:.14em; text-transform:uppercase; color:var(--mut); margin:30px 0 0; padding-top:4px}
+  .scards{display:grid; grid-template-columns:repeat(auto-fill,minmax(290px,1fr)); gap:20px; margin-top:13px}
+  .scard{border:1px solid var(--line); border-radius:14px; background:#fff; padding:13px; display:flex; flex-direction:column}
+  .scard .thumb{background:#16191d; border-radius:9px; padding:6px}
+  .scard .thumb img{display:block; width:100%; height:auto; border-radius:5px}
+  .scard .thumb.ph{aspect-ratio:4/3; display:grid; place-items:center; border:1px dashed #39424b; padding:0}
+  .scard .thumb.ph span{font-family:'JetBrains Mono',monospace; font-size:.6rem; letter-spacing:.12em; color:#7d8893; text-transform:uppercase}
+  .scard h3{font-size:1.04rem; margin:12px 0 2px; color:var(--ink); display:flex; align-items:center; gap:8px; flex-wrap:wrap}
+  .scard h3 .tag{font-family:'JetBrains Mono',monospace; font-size:.58rem; letter-spacing:.05em; text-transform:uppercase; color:var(--teal-ink); background:rgba(21,182,166,.1); border-radius:5px; padding:2px 6px; font-weight:600}
+  .scard .lede{color:var(--mut); font-size:.9rem; margin:2px 0 9px}
+  .scard ul{margin:0; padding-left:17px}
+  .scard li{margin:4px 0; font-size:.89rem; color:#3c454d; line-height:1.5}
+  .scard li b{color:var(--ink); font-weight:600}
+
+  /* Caution callout (amber) */
+  .callout{display:flex; gap:11px; margin-top:18px; padding:13px 15px; border-radius:11px; background:#fff7ed; border:1px solid #f6dcb8}
+  .callout .cico{flex:none; width:20px; height:20px; color:#c2740b; margin-top:1px}
+  .callout .cico svg{width:20px; height:20px}
+  .callout b{display:block; color:#7c4a03; margin-bottom:3px; font-size:.94rem}
+  .callout p{margin:0; color:#7a5320; font-size:.9rem; line-height:1.55}
+
+  footer{border-top:1px solid var(--line); padding:26px 22px; text-align:center; color:var(--mut); font-size:.85rem}
+  @media(max-width:980px){
+    .shell{grid-template-columns:1fr; gap:0}
+    nav.toc{position:static; height:auto; border-bottom:1px solid var(--line); padding:14px 0; display:flex; gap:6px; overflow:auto; white-space:nowrap}
+    nav.toc .grp{display:none} nav.toc a{border-left:0; flex:none}
+    .shot{position:static; margin:0 auto 6px}
+  }
+</style>
+</head>
+<body>
+
+<div class="top">
+  <a class="word" href="index.html">WADA<span class="t">MESH</span></a>
+  <span class="tag">Docs</span>
+  <span class="sp"></span>
+  <a class="home" href="index.html"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="m12 19-7-7 7-7"/><path d="M19 12H5"/></svg> Back to site</a>
+</div>
+
+<div class="shell">
+  <nav class="toc" id="toc">
+    <div class="grp">Start here</div>
+    <a href="#overview">Overview</a>
+    <div class="grp">The five tabs</div>
+    <a href="#home">Home</a>
+    <a href="#chat">Chat</a>
+    <a href="#contacts">Contacts</a>
+    <a href="#map">Map</a>
+    <a href="#settings">Settings</a>
+    <div class="grp">With your phone</div>
+    <a href="#companion">Companion mode</a>
+    <a href="#remote">Remote &amp; web app</a>
+    <a href="#web">Web browser</a>
+    <div class="grp">Reference</div>
+    <a href="#updates">Updates &amp; test builds</a>
+    <a href="#settings-pages">Settings pages</a>
+    <a href="#apps">Apps</a>
+  </nav>
+
+  <main>
+    <div class="hero" id="overview">
+      <h1>WADAMESH user guide</h1>
+      <p>WADAMESH turns a LilyGo T-Deck — its landscape screen, BlackBerry-style keyboard and trackball — into a complete front-end for your MeshCore radio: chat, channels, contacts, a live map and deep radio settings, all on the device. (It also runs on the Heltec V4 and Tanmatsu.) Every screen below is a real screenshot from the device.</p>
+      <div class="meta">
+        <span class="chip"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><circle cx="12" cy="12" r="10"/><path d="m9 12 2 2 4-4"/></svg> No phone required</span>
+        <span class="chip"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M5 12.55a11 11 0 0 1 14 0"/><path d="M8.5 16.4a5 5 0 0 1 7 0"/><line x1="12" y1="20" x2="12" y2="20"/></svg> LoRa + Wi-Fi + Bluetooth</span>
+        <span class="chip"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><rect x="3" y="3" width="18" height="18" rx="2"/></svg> Keyboard + touch</span>
+      </div>
+      <div class="callout">
+        <span class="cico"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M4 4h11l5 5v11a1 1 0 0 1-1 1H5a1 1 0 0 1-1-1V4z"/><path d="M9 4v4M13 4v4"/></svg></span>
+        <div>
+          <b>Got a microSD slot? Keep a card inserted.</b>
+          <p>On devices with a microSD slot (the LilyGo T-Deck and Tanmatsu), wadamesh is best used with a card in place. It keeps map tiles, your contacts and your chat history on the card, which is roomier and far more reliable than the small internal flash, so a card prevents memory issues and stops that data being lost on reboot. The Heltec V4 has no card slot and manages fine on its internal storage.</p>
+        </div>
+      </div>
+    </div>
+
+    <section class="doc" id="home">
+      <h2><span class="ico"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="m3 9 9-7 9 7v11a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2z"/><path d="M9 22V12h6v10"/></svg></span> Home</h2>
+      <div class="row">
+        <div class="prose">
+          <p>The home tab is your <b>app launcher</b> — a grid of everything on the device:</p>
+          <ul>
+            <li><b>Cmdr</b> — the command centre overview.</li>
+            <li><b>Chats</b>, <b>Contacts</b>, <b>Map</b>, <b>Mentions</b> — jump straight to those.</li>
+            <li><b>Advertise</b> — announce yourself to the mesh (manual or on a timer).</li>
+            <li><b>Signal</b> and <b>Monitor</b> — live RX signal and a repeater-style RF activity view.</li>
+            <li><b>Spectrum</b> — sweep the LoRa band for interference.</li>
+            <li><b>Settings</b>, <b>Terminal</b> (MeshCore CLI), <b>Files</b> (microSD).</li>
+          </ul>
+          <p>The bar along the bottom is always there — it switches the five main tabs (Chat, Contacts, Home, Map, Settings) from anywhere. The top bar shows unread count, time, signal and battery.</p>
+        </div>
+        <div class="shot"><div class="device"><img class="screen" src="docs-img/home.png" alt="Home app launcher"></div><div class="cap">Home — app launcher</div></div>
+      </div>
+    </section>
+
+    <section class="doc" id="chat">
+      <h2><span class="ico"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M21 15a2 2 0 0 1-2 2H7l-4 4V5a2 2 0 0 1 2-2h14a2 2 0 0 1 2 2z"/></svg></span> Chat</h2>
+      <div class="row">
+        <div class="prose">
+          <p>Every conversation in one list, newest first — both <b>channels</b> (group chats like <code>#wadamesh</code>, <code>Public</code>) and <b>direct messages</b>. An unread badge shows the count.</p>
+          <h3>On each row</h3>
+          <ul>
+            <li><b>Tap</b> a row to open the conversation, then type on the keyboard to reply.</li>
+            <li>The <b>gear</b> on the right opens that chat's settings — mute, region &amp; scope, share secret, blocked users, remove — the same screen as the cog inside a chat.</li>
+          </ul>
+          <p>The top-right buttons add a contact, mark everything read, and show your QR code.</p>
+        </div>
+        <div class="shot"><div class="device"><img class="screen" src="docs-img/chat.png" alt="Chat channel list"></div><div class="cap">Chat — channels &amp; DMs</div></div>
+      </div>
+    </section>
+
+    <section class="doc" id="contacts">
+      <h2><span class="ico"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M16 21v-2a4 4 0 0 0-4-4H6a4 4 0 0 0-4 4v2"/><circle cx="9" cy="7" r="4"/></svg></span> Contacts</h2>
+      <div class="row">
+        <div class="prose">
+          <p>Everyone your node knows — name, type and how recently you heard them. Tap a contact to message it or open its details: signal history, a route trace, telemetry, and share/favourite options.</p>
+          <p>The <b>overflow menu</b> (top right) holds Search, the <b>Discovered</b> list (nodes heard but not yet added), Add contact, Auto-add settings, and the Blocked list. Auto-add can pull new nodes in from their adverts, or you can add them by hand.</p>
+        </div>
+        <div class="shot"><div class="device"><img class="screen" src="docs-img/contacts.png" alt="Contacts list"></div><div class="cap">Contacts</div></div>
+      </div>
+    </section>
+
+    <section class="doc" id="map">
+      <h2><span class="ico"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M9 18l-6 3V6l6-3 6 3 6-3v15l-6 3-6-3z"/><path d="M9 3v15"/><path d="M15 6v15"/></svg></span> Map</h2>
+      <div class="row">
+        <div class="prose">
+          <p>An OpenStreetMap / OpenTopoMap view with your position and your contacts plotted as markers, plus link lines from you to each node. Tiles are fetched over Wi-Fi through the wadamesh proxy and cached to flash (or microSD), so areas you've viewed work offline.</p>
+          <p>It also has a line-of-sight analyzer: pick a contact and it uses SRTM elevation to show whether terrain blocks the path.</p>
+        </div>
+        <div class="shot"><div class="device"><img class="screen" src="docs-img/map.png?v=2" alt="Map"></div><div class="cap">Map</div></div>
+      </div>
+      <div class="prose">
+        <h3>Bring your own tiles (offline maps)</h3>
+        <p>You don't need Wi-Fi to see the map. Copy a standard OpenStreetMap tile pack onto the T-Deck's microSD card and the map reads straight off the card, fully offline.</p>
+        <p><b>Where they go.</b> Use the usual slippy-map <code>z/x/y</code> folder layout, in either of these locations on the card:</p>
+        <ul>
+          <li><code>/maps/osm/&lt;z&gt;/&lt;x&gt;/&lt;y&gt;.png</code> &mdash; the Meshtastic / MeshCore standard layout (recommended, so packs are interchangeable between apps).</li>
+          <li><code>/tiles/&lt;z&gt;/&lt;x&gt;/&lt;y&gt;.png</code> &mdash; also read. This is the same folder the Wi-Fi download cache uses, so your own tiles and downloaded ones live side by side.</li>
+        </ul>
+        <p><b>Format.</b> 256&times;256 <code>.png</code> tiles (<code>.jpg</code> also works). <code>z</code> is the zoom level and <code>x</code>/<code>y</code> the tile column/row at that zoom &mdash; the same scheme OSM's own tile server and every XYZ tile downloader use, so most ready-made packs drop in unchanged.</p>
+        <p><b>Turn it on.</b> Open the map's options (the gear button on the map) and switch on <b>Tiles from SD card</b>; the status line confirms <code>Map tiles: microSD</code>. Turn it back off to fetch live tiles over Wi-Fi again.</p>
+        <p><b>Making a pack.</b> Any XYZ / slippy-map tile downloader works &mdash; point it at OpenStreetMap for your area and a sensible zoom range, then copy the resulting <code>z/x/y</code> folders onto the card. Each extra zoom level roughly quadruples the tile count, so grab only the levels you'll actually use.</p>
+        <div class="callout">
+          <span class="cico"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="12" r="10"/><line x1="12" y1="16" x2="12" y2="12"/><line x1="12" y1="8" x2="12.01" y2="8"/></svg></span>
+          <div>
+            <b>Board differences</b>
+            <p>The "Tiles from SD card" toggle is a T-Deck feature. The Heltec V4 has no microSD slot, so it caches downloaded tiles to a small internal partition (no offline packs there). On the Tanmatsu, tiles &mdash; your own or downloaded &mdash; live at <code>/tiles/&lt;z&gt;/&lt;x&gt;/&lt;y&gt;.jpg</code> on the microSD card; drop JPEG tiles there and they show alongside the downloaded ones.</p>
+          </div>
+        </div>
+      </div>
+    </section>
+
+    <section class="doc" id="settings">
+      <h2><span class="ico"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><circle cx="12" cy="12" r="3"/><path d="M19.4 15a1.65 1.65 0 0 0 .33 1.82l.06.06a2 2 0 1 1-2.83 2.83l-.06-.06a1.65 1.65 0 0 0-2.4.33 1.65 1.65 0 0 0-1 1.51V21a2 2 0 0 1-4 0v-.09A1.65 1.65 0 0 0 8 19.4a1.65 1.65 0 0 0-1.82.33l-.06.06a2 2 0 1 1-2.83-2.83l.06-.06a1.65 1.65 0 0 0 .33-2.4 1.65 1.65 0 0 0-1.51-1H1a2 2 0 0 1 0-4h.09A1.65 1.65 0 0 0 3 8z"/></svg></span> Settings</h2>
+      <div class="row">
+        <div class="prose">
+          <p>A tile for each category. Tap one to open its page; the title bar carries a back chevron. The full set is in <a href="#settings-pages">Settings pages</a> below.</p>
+          <ul>
+            <li><b>Profile</b> — your name and node identity.</li>
+            <li><b>Radio &amp; Mesh</b> — frequency, spreading factor, region scope, high-gain receiver, signal probe, auto-advert.</li>
+            <li><b>Auto-add, Wi-Fi, Bluetooth, GPS</b> — discovery and connectivity.</li>
+            <li><b>Clock, Battery, Sensors, Display, Keyboard, Sound, Quick replies, Lock screen</b> — the device experience.</li>
+            <li><b>Language</b> (twelve UI languages), <b>Backups</b>, and <b>About</b> (firmware version, update check, diagnostics).</li>
+          </ul>
+        </div>
+        <div class="shot"><div class="device"><img class="screen" src="docs-img/settings.png" alt="Settings categories"></div><div class="cap">Settings categories</div></div>
+      </div>
+    </section>
+
+    <section class="doc" id="companion">
+      <h2><span class="ico"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><rect x="5" y="2" width="14" height="20" rx="2"/><line x1="11" y1="18" x2="13" y2="18"/></svg></span> Companion mode</h2>
+      <div class="row">
+        <div class="prose">
+          <p>WADAMESH runs everything on its own, but it can also be the radio for the <b>official MeshCore app</b> on your phone (iOS and Android). Your phone brings the big screen and full keyboard; the device does the LoRa. Best of all it works <b>alongside</b> the on-device UI — you can keep using the touch screen while your phone is connected, and your contacts, channels and messages stay in sync between them.</p>
+          <h3>Three ways to connect</h3>
+          <ul>
+            <li><b>USB</b> — plug the device into an Android phone or a computer; the app connects over the cable. Nothing to set up on the device.</li>
+            <li><b>Bluetooth</b> — turn on Bluetooth in <b>Settings &rarr; Bluetooth</b>. The device appears in the app as <code>MeshCore-&lt;your node name&gt;</code>; pair with the 6-digit code (default <code>123456</code>, changeable on the same page).</li>
+            <li><b>Wi-Fi</b> — put the device on your network in <b>Settings &rarr; Wi-Fi</b>. On the same Wi-Fi, the app connects to the device's IP address on port <code>5000</code> (the Wi-Fi page shows the IP).</li>
+          </ul>
+          <div class="callout">
+            <span class="cico"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M10.29 3.86 1.82 18a2 2 0 0 0 1.71 3h16.94a2 2 0 0 0 1.71-3L13.71 3.86a2 2 0 0 0-3.42 0z"/><line x1="12" y1="9" x2="12" y2="13"/><line x1="12" y1="17" x2="12.01" y2="17"/></svg></span>
+            <div>
+              <b>Run Bluetooth and Wi-Fi together only when you need to</b>
+              <p>Bluetooth and Wi-Fi can be on at the same time, but each one reserves a good chunk of RAM. On the Heltec V4 especially — it has the least free memory of the three boards — keeping both on at once leaves little headroom and can lead to instability or odd behaviour. If you only want the phone app, pick one transport (Bluetooth or Wi-Fi) and leave the other off; if you mostly use the device on its own, keep both off.</p>
+            </div>
+          </div>
+        </div>
+        <div class="shot"><div class="device"><img class="screen" src="docs-img/set_bluetooth.png" alt="Bluetooth pairing page"></div><div class="cap">Bluetooth &mdash; pairing code</div></div>
+      </div>
+    </section>
+
+    <section class="doc" id="remote">
+      <h2><span class="ico"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M2 16.1A5 5 0 0 1 5.9 20M2 12.05A9 9 0 0 1 9.95 20M2 8V6a2 2 0 0 1 2-2h16a2 2 0 0 1 2 2v12a2 2 0 0 1-2 2h-6"/><line x1="2" y1="20" x2="2.01" y2="20"/></svg></span> Remote &amp; web app</h2>
+      <div class="row">
+        <div class="prose">
+          <p>Over Wi-Fi, a WADAMESH device can put its screen &mdash; or a whole browser app &mdash; on your phone or laptop. There is nothing to install: the device serves a web page you open in any browser on the same network. Turn it on from <b>Home &rarr; Remote</b> (or the Remote screen in Settings), pick a mode, and open the address it shows.</p>
+          <h3>Three ways to connect</h3>
+          <ul>
+            <li><b>Remote app</b> (recommended) &mdash; a full control panel, native to the browser: <b>Chats</b>, <b>Contacts</b>, a <b>Terminal</b> and <b>Settings</b>, with live message notifications. Run the device entirely from your phone.</li>
+            <li><b>Screen mirror (VNC)</b> &mdash; streams the device's live screen to the browser and sends your taps and key presses back, so you see and drive exactly what is on the device, in real time.</li>
+            <li><b>Remote UI</b> &mdash; renders the interface off-screen at desktop size (a wide landscape layout) and streams that instead of the small panel, for a roomier view on a big screen.</li>
+          </ul>
+          <p>Screen mirror and Remote UI both show the same interface you already know from the device &mdash; mirrored, or drawn larger. The <b>Remote app</b> is different: a browser-native panel built for a phone, shown below.</p>
+          <h3>Turning it on</h3>
+          <p>Connect the device to Wi-Fi first, then open <b>Home &rarr; Remote</b>. The screen shows the address to type into your browser (like <code>http://192.168.1.42</code>) and a switch for each mode. Only one streaming mode runs at a time, and the phone and the device must be on the same Wi-Fi network.</p>
+        </div>
+        <div class="shot"><div class="device"><img class="screen" src="docs-img/app_remote.png" alt="Remote access screen on the device"></div><div class="cap">Remote &mdash; turn it on, then open the address</div></div>
+      </div>
+
+      <div class="subh">The remote app in a browser</div>
+      <div class="prose" style="max-width:70ch"><p>The remote app is phone-first. It carries the same status icons as the device (signal, Wi-Fi, Bluetooth, battery), pops up a notification when a message arrives, and refreshes an open chat on its own as replies come in &mdash; so you rarely need to touch the device itself.</p></div>
+      <div class="webgrid">
+        <figure class="phone"><img src="docs-img/web_chats.png" alt="Chats tab in the web app"><figcaption>Chats &mdash; DMs, channels, unread badges</figcaption></figure>
+        <figure class="phone"><img src="docs-img/web_chat.png" alt="A conversation in the web app"><figcaption>A conversation, with delivery ticks</figcaption></figure>
+        <figure class="phone"><img src="docs-img/web_contacts.png" alt="Contacts tab in the web app"><figcaption>Contacts &mdash; search, sort, filter</figcaption></figure>
+        <figure class="phone"><img src="docs-img/web_contact_sheet.png" alt="Contact actions in the web app"><figcaption>Tap a contact for actions</figcaption></figure>
+        <figure class="phone"><img src="docs-img/web_discovered.png" alt="Discovered nodes in the web app"><figcaption>Discovered nodes &mdash; add with a tap</figcaption></figure>
+        <figure class="phone"><img src="docs-img/web_settings.png" alt="Settings in the web app"><figcaption>Settings &mdash; including live radio</figcaption></figure>
+        <figure class="phone"><img src="docs-img/web_terminal.png" alt="Terminal in the web app"><figcaption>Terminal &mdash; the MeshCore CLI</figcaption></figure>
+      </div>
+    </section>
+
+    <section class="doc" id="web">
+      <h2><span class="ico"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="12" r="10"/><line x1="2" y1="12" x2="22" y2="12"/><path d="M12 2a15.3 15.3 0 0 1 4 10 15.3 15.3 0 0 1-4 10 15.3 15.3 0 0 1-4-10 15.3 15.3 0 0 1 4-10z"/></svg></span> Web browser</h2>
+      <div class="row">
+        <div class="prose">
+          <p>WADAMESH can read the web on its own screen. Open the <b>Web</b> app from the home launcher, type an address, and the device fetches the page and shows it as plain, readable text &mdash; articles, wikis, docs, simple sites. There is no proxy in the middle and nothing is tracked: it pulls the page straight from the site and strips it down to the words.</p>
+          <ul>
+            <li><b>Text only</b> &mdash; no JavaScript, no images, no ads. Pages load small and read clean.</li>
+            <li><b>Tappable links</b> &mdash; follow a link to the next page, with <b>back</b>, <b>forward</b> and <b>refresh</b> in the toolbar.</li>
+            <li><b>Direct &amp; private</b> &mdash; the device connects to the site itself over Wi-Fi (HTTPS); no server of ours sees what you read.</li>
+          </ul>
+          <p>Reading the web on-device takes more memory than the smallest board carries, so the Web app is on the <b>T-Deck</b> and <b>Tanmatsu</b>. On the 2&nbsp;MB Heltec&nbsp;V4 it is hidden &mdash; that board can't complete the secure handshake &mdash; but you can still bounce any link to your phone (below).</p>
+        </div>
+        <div class="shot"><div class="device"><img class="screen" src="docs-img/app_web.png" alt="The on-device Web app"></div><div class="cap">Web &mdash; open an address, read it as text</div></div>
+      </div>
+
+      <div class="subh">Links in chat</div>
+      <div class="prose" style="max-width:70ch"><p>A link that arrives in a message is now tappable. Tap it for a small menu: <b>Open in web</b> loads the page in the on-device browser (T-Deck and Tanmatsu), and <b>Create QR</b> puts a scannable QR code on screen so you can open the link on your phone. Create QR works on <em>every</em> board, including the Heltec&nbsp;V4 &mdash; so even where the browser isn't available, a link is one tap from your phone.</p></div>
+      <div class="gallery">
+        <div class="mini"><img src="docs-img/app_web_links.png" alt="Tapping a link in chat opens a menu"><div class="cap">Tap a link &mdash; Open in web, or Create QR</div></div>
+        <div class="mini"><img src="docs-img/app_web_qr.png" alt="A QR code for a link from chat"><div class="cap">Create QR &mdash; scan to open on your phone</div></div>
+      </div>
+    </section>
+
+    <section class="doc" id="updates">
+      <h2><span class="ico"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M23 4v6h-6"/><path d="M1 20v-6h6"/><path d="M3.51 9a9 9 0 0 1 14.85-3.36L23 10M1 14l4.64 4.36A9 9 0 0 0 20.49 15"/></svg></span> Updates &amp; test builds</h2>
+      <div class="row">
+        <div class="prose">
+          <p>On the boards that update over Wi-Fi (the Heltec V4 and the standalone T-Deck), WADAMESH checks for new firmware on its own. When one is available, <b>Settings &rarr; About</b> shows it and you can flash it straight from the device with <b>Install update</b>, no computer needed. (Under Launcher and on the Tanmatsu you update through Launcher or the app store instead.)</p>
+          <h3>Two channels: Stable and Test</h3>
+          <ul>
+            <li><b>Stable</b> is the default. It is the build that has been tested and is recommended for everyday use. Leave your device on this unless you want to help test.</li>
+            <li><b>Test (beta)</b> gets new features and fixes earlier, before they are proven. It can be rough, so it is meant for trying things early and reporting bugs, not for a device you rely on.</li>
+          </ul>
+          <h3>Turn on test builds</h3>
+          <p>Flip <b>Settings &rarr; About &rarr; "Get test builds (beta)"</b> on. From then on, both the update check and <b>Install update</b> follow the test channel, so the device offers the newest test build over Wi-Fi. Turn the switch back off to return to stable. You can switch either way at any time.</p>
+          <p>Prefer to start on a test build from scratch? Pick <b>Beta &middot; testing</b> when you flash from <a href="https://flasher.wadamesh.com" target="_blank" rel="noopener">flasher.wadamesh.com</a>.</p>
+        </div>
+        <div class="shot"><div class="device"><img class="screen" src="docs-img/set_about.png" alt="About page"></div><div class="cap">The About page</div></div>
+      </div>
+    </section>
+
+    <section class="doc" id="settings-pages">
+      <h2><span class="ico"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><line x1="4" y1="6" x2="20" y2="6"/><line x1="4" y1="12" x2="20" y2="12"/><line x1="4" y1="18" x2="20" y2="18"/></svg></span> Settings pages</h2>
+      <div class="prose" style="max-width:68ch"><p>WADAMESH splits its settings into nineteen pages. Here is what each one does and the controls you will find on it. Open any page from the Settings tab; a back chevron in the title bar returns you to the grid.</p></div>
+
+      <div class="sgrp">Identity &amp; radio</div>
+      <div class="scards">
+        <div class="scard">
+          <div class="thumb"><img src="docs-img/set_profile.png" alt="Profile settings"></div>
+          <h3>Profile</h3>
+          <div class="lede">Who you are on the mesh.</div>
+          <ul>
+            <li><b>Node name</b> — your callsign on the network</li>
+            <li><b>Advert location</b> plus a share-in-advert toggle</li>
+            <li><b>Identity key</b> and <b>Share QR</b> to hand out your contact</li>
+            <li><b>Export / Import</b> your whole setup as a JSON backup</li>
+          </ul>
+        </div>
+        <div class="scard">
+          <div class="thumb"><img src="docs-img/set_radio___mesh.png" alt="Radio and Mesh settings"></div>
+          <h3>Radio &amp; Mesh</h3>
+          <div class="lede">Every LoRa and mesh parameter, split into RADIO / MESH / SIGNAL.</div>
+          <ul>
+            <li><b>Radio</b> — preset, frequency, bandwidth, spreading factor, coding rate, TX power, with a live duty-cycle and airtime-per-packet readout</li>
+            <li><b>Mesh</b> — answer-telemetry, path-hash size, region scope tag, scope direct messages</li>
+            <li><b>Signal</b> — high-gain receiver (Heltec V4.3), signal probe, and a shortcut to the Advertise app</li>
+            <li><b>Experimental</b> — multi-ACKs, client repeat, RX boost, duty meter</li>
+          </ul>
+        </div>
+        <div class="scard">
+          <div class="thumb"><img src="docs-img/set_auto_add.png" alt="Auto-add settings"></div>
+          <h3>Auto-add</h3>
+          <div class="lede">Which nodes join Contacts automatically from their adverts.</div>
+          <ul>
+            <li>Per-type toggles: <b>chat</b>, <b>repeater</b>, <b>room</b>, <b>sensor</b></li>
+            <li><b>Overwrite oldest</b> when the contact list is full</li>
+            <li><b>Notify</b> when a new contact is added</li>
+            <li><b>Max hops</b> filter for how far away a node can be</li>
+          </ul>
+        </div>
+      </div>
+
+      <div class="sgrp">Connectivity</div>
+      <div class="scards">
+        <div class="scard">
+          <div class="thumb"><img src="docs-img/set_wi_fi.png" alt="Wi-Fi settings"></div>
+          <h3>Wi-Fi</h3>
+          <div class="lede">For map tiles, clock sync and update checks.</div>
+          <ul>
+            <li>On / off with a live status line (IP, signal)</li>
+            <li><b>Scan</b> and tap an SSID, or type one in by hand</li>
+            <li><b>Save &amp; reconnect</b> applies live — no reboot</li>
+            <li>Saved network slots for one-tap quick-connect</li>
+          </ul>
+        </div>
+        <div class="scard">
+          <div class="thumb"><img src="docs-img/set_bluetooth.png" alt="Bluetooth settings"></div>
+          <h3>Bluetooth</h3>
+          <div class="lede">Pair with the MeshCore phone app over BLE.</div>
+          <ul>
+            <li><b>Enable Bluetooth</b> with a live mode status line</li>
+            <li>Set a 6-digit <b>pairing code</b> (applies after a reboot)</li>
+          </ul>
+        </div>
+        <div class="scard">
+          <div class="thumb"><img src="docs-img/set_gps.png" alt="GPS settings"></div>
+          <h3>GPS</h3>
+          <div class="lede">The on-board GPS receiver.</div>
+          <ul>
+            <li>On / off with a live <b>fix status</b> (acquiring, 2D/3D, age)</li>
+            <li><b>Serial baud</b> rate (applies after a reboot)</li>
+            <li>Reads "no GPS module" on devices without one</li>
+          </ul>
+        </div>
+        <div class="scard">
+          <div class="thumb"><img src="docs-img/set_mqtt_bridge.png" alt="MQTT bridge settings"></div>
+          <h3>MQTT bridge <span class="tag">experimental</span></h3>
+          <div class="lede">Forward received messages to your own MQTT broker.</div>
+          <ul>
+            <li>Publishes the <b>text, sender and time</b> of messages your node hears to an MQTT broker</li>
+            <li>Broker <b>host, port and topic</b>, plus an <b>encryption key</b></li>
+            <li>Stays off until you <b>accept the privacy note</b> &mdash; anyone who can read the broker sees the messages, so use one you control, never a public broker</li>
+          </ul>
+        </div>
+      </div>
+
+      <div class="sgrp">Time &amp; power</div>
+      <div class="scards">
+        <div class="scard">
+          <div class="thumb"><img src="docs-img/set_clock___time.png" alt="Clock and time settings"></div>
+          <h3>Clock &amp; time</h3>
+          <div class="lede">Keep the clock right.</div>
+          <ul>
+            <li><b>Sync clock</b> from the system / NTP</li>
+            <li><b>Time zone</b> picker, or a custom UTC offset with steppers</li>
+            <li><b>12-hour clock</b> toggle</li>
+          </ul>
+        </div>
+        <div class="scard">
+          <div class="thumb"><img src="docs-img/set_battery.png" alt="Battery settings"></div>
+          <h3>Battery</h3>
+          <div class="lede">Power readouts and tuning.</div>
+          <ul>
+            <li><b>Battery &amp; power history</b> chart</li>
+            <li><b>Calibrate</b> — tap to set 100% at the current voltage</li>
+            <li><b>Battery saver</b> throttles the CPU when idle (T-Deck)</li>
+          </ul>
+        </div>
+        <div class="scard">
+          <div class="thumb"><img src="docs-img/set_sensors.png" alt="Sensors settings"></div>
+          <h3>Sensors <span class="tag">Heltec V4</span></h3>
+          <div class="lede">For the V4 Expansion Kit.</div>
+          <ul>
+            <li><b>Expansion Kit</b> configuration</li>
+            <li><b>Show Sensors tab</b> in the bottom bar (applies after restart)</li>
+          </ul>
+        </div>
+      </div>
+
+      <div class="sgrp">Experience</div>
+      <div class="scards">
+        <div class="scard">
+          <div class="thumb"><img src="docs-img/set_display.png" alt="Display settings"></div>
+          <h3>Display</h3>
+          <div class="lede">Look and feel.</div>
+          <ul>
+            <li><b>Screen timeout</b> before it sleeps</li>
+            <li><b>UI size</b> — Normal / Large / Huge</li>
+            <li><b>Colourful chat bubbles</b>, distance in miles, hide device name</li>
+            <li><b>Theme colour</b> picker</li>
+          </ul>
+        </div>
+        <div class="scard">
+          <div class="thumb"><img src="docs-img/set_keyboard.png" alt="Keyboard settings"></div>
+          <h3>Keyboard</h3>
+          <div class="lede">Typing and on-device input.</div>
+          <ul>
+            <li><b>Secondary layouts</b> — Cyrillic, Greek, Arabic, French, German and more</li>
+            <li><b>Accent popups</b> — long-press for accented letters</li>
+            <li><b>Enter sends</b> the message (T-Deck)</li>
+            <li><b>Flash</b> the screen and keys on a new message (T-Deck)</li>
+          </ul>
+        </div>
+        <div class="scard">
+          <div class="thumb"><img src="docs-img/set_sound.png" alt="Sound settings"></div>
+          <h3>Sound</h3>
+          <div class="lede">Notification audio.</div>
+          <ul>
+            <li>Master sound plus per-type toggles: <b>message</b>, <b>DM</b>, <b>@mention</b></li>
+            <li>Custom <b>sound files</b> from microSD where supported</li>
+            <li><b>Volume</b> control (T-Deck / Tanmatsu)</li>
+          </ul>
+        </div>
+        <div class="scard">
+          <div class="thumb"><img src="docs-img/set_quick_replies.png" alt="Quick replies settings"></div>
+          <h3>Quick replies</h3>
+          <div class="lede">One-tap canned messages.</div>
+          <ul>
+            <li>Edit <b>six</b> short replies</li>
+            <li>Pick them from the composer to send instantly</li>
+          </ul>
+        </div>
+        <div class="scard">
+          <div class="thumb"><img src="docs-img/set_lock_screen.png" alt="Lock screen settings"></div>
+          <h3>Lock screen <span class="tag">T-Deck</span></h3>
+          <div class="lede">A simple lock when idle.</div>
+          <ul>
+            <li><b>Wallpaper</b> picker and <b>lock text colour</b></li>
+            <li><b>Lock when screen off</b>, then hold to unlock</li>
+          </ul>
+        </div>
+      </div>
+
+      <div class="sgrp">System</div>
+      <div class="scards">
+        <div class="scard">
+          <div class="thumb ph"><span>Screenshot pending</span></div>
+          <h3>General</h3>
+          <div class="lede">Device housekeeping.</div>
+          <ul>
+            <li><b>Send advert now</b></li>
+            <li><b>Store data on SD</b> (reboot)</li>
+            <li><b>Run setup again</b> from scratch</li>
+            <li><b>Reboot device</b></li>
+          </ul>
+        </div>
+        <div class="scard">
+          <div class="thumb"><img src="docs-img/set_backups.png" alt="Backups settings"></div>
+          <h3>Backups</h3>
+          <div class="lede">Save and restore your whole config.</div>
+          <ul>
+            <li><b>Export</b> a new JSON backup</li>
+            <li>Restore from the <b>saved list</b></li>
+            <li><b>Factory reset</b> in the danger zone</li>
+          </ul>
+        </div>
+        <div class="scard">
+          <div class="thumb"><img src="docs-img/set_language.png" alt="Language settings"></div>
+          <h3>Language</h3>
+          <div class="lede">Twelve UI languages.</div>
+          <ul>
+            <li>Tap a language; the device reboots to apply</li>
+          </ul>
+        </div>
+        <div class="scard">
+          <div class="thumb"><img src="docs-img/set_about.png" alt="About settings"></div>
+          <h3>About</h3>
+          <div class="lede">Version, updates and diagnostics.</div>
+          <ul>
+            <li><b>Firmware version</b> plus update check / install</li>
+            <li><b>Get test builds (beta)</b> switch: opt into the <a href="#updates">test channel</a></li>
+            <li>Full <b>system diagnostics</b> — uptime, chip, memory, flash, storage</li>
+            <li><b>Device ID</b> and crash-report export</li>
+          </ul>
+        </div>
+      </div>
+    </section>
+
+    <section class="doc" id="apps">
+      <h2><span class="ico"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><line x1="8" y1="6" x2="21" y2="6"/><line x1="8" y1="12" x2="21" y2="12"/><line x1="8" y1="18" x2="21" y2="18"/><line x1="3" y1="6" x2="3.01" y2="6"/><line x1="3" y1="12" x2="3.01" y2="12"/><line x1="3" y1="18" x2="3.01" y2="18"/></svg></span> Apps</h2>
+      <div class="prose" style="max-width:64ch">
+        <p>Tools from the home launcher. <b>RF Monitor</b> is a repeater-style view of recent packets and radio stats; <b>Spectrum</b> sweeps the band so you can spot interference or find a clear frequency.</p>
+      </div>
+      <div class="gallery">
+        <div class="mini"><img src="docs-img/app_rfmonitor.png" alt="RF Monitor"><div class="cap">RF Monitor</div></div>
+        <div class="mini"><img src="docs-img/app_spectrum.png" alt="Spectrum analyzer"><div class="cap">Spectrum analyzer</div></div>
+      </div>
+    </section>
+  </main>
+</div>
+
+<footer>WADAMESH — open-source MeshCore touch firmware · <a href="index.html">wadamesh.com</a></footer>
+
+<script>
+  var KB = ['QWERTYUIOP', 'ASDFGHJKL', 'ZXCVBNM'];
+  document.querySelectorAll('.device').forEach(function(dev){
+    var kb = document.createElement('div'); kb.className = 'kbd';
+    KB.forEach(function(rowStr){
+      var r = document.createElement('div'); r.className = 'kr';
+      rowStr.split('').forEach(function(ch){ var k = document.createElement('span'); k.className = 'key'; k.textContent = ch; r.appendChild(k); });
+      kb.appendChild(r);
+    });
+    var sp = document.createElement('div'); sp.className = 'kr';
+    sp.innerHTML = '<span class="key">sym</span><span class="key wide"></span><span class="key">&#9166;</span>';
+    kb.appendChild(sp);
+    dev.appendChild(kb);
+  });
+  var links = Array.prototype.slice.call(document.querySelectorAll('nav.toc a'));
+  var obs = new IntersectionObserver(function(es){
+    es.forEach(function(e){ if (e.isIntersecting) {
+      links.forEach(function(l){ l.classList.remove('on'); });
+      var a = document.querySelector('nav.toc a[href="#' + e.target.id + '"]');
+      if (a) a.classList.add('on');
+    }});
+  }, { rootMargin: '-25% 0px -65% 0px' });
+  ['overview','home','chat','contacts','map','settings','companion','settings-pages','apps'].forEach(function(id){ var el = document.getElementById(id); if (el) obs.observe(el); });
+</script>
+</body>
+</html>

deploy/site/index.html

@@ -42,7 +42,15 @@
     font-family:'JetBrains Mono',monospace; background:#fff; transition:border-color .15s, color .15s}
   .kicker:hover{border-color:var(--teal); color:var(--ink)}
   .freeline{margin:0 auto 24px; color:var(--mut); font-size:.92rem}
-  .fab-rail{position:fixed; top:16px; z-index:45; display:flex; flex-direction:column; gap:12px}
+  .fab-rail{position:fixed; top:var(--fab-top,16px); z-index:45; display:flex; flex-direction:column; gap:12px}
+  /* dismissible donate banner */
+  .donate-bar{position:sticky; top:0; z-index:50; display:flex; align-items:center; justify-content:center; gap:7px 16px; flex-wrap:wrap;
+    padding:9px 44px; background:var(--ink); color:#fff; font-size:.9rem; line-height:1.4; text-align:center}
+  .donate-bar a{color:#fff; text-decoration:underline; text-underline-offset:2px}
+  .donate-bar .donate-cta{background:var(--teal); color:#fff; text-decoration:none; padding:5px 14px; border-radius:100px; font-weight:650; white-space:nowrap}
+  .donate-bar .donate-cta:hover{background:var(--cyan)}
+  .donate-bar .x{position:absolute; right:12px; top:50%; transform:translateY(-50%); background:none; border:0; color:#fff; font-size:1.5rem; line-height:1; cursor:pointer; opacity:.75; padding:0 4px}
+  .donate-bar .x:hover{opacity:1}
   .fab-rail.left{left:16px} .fab-rail.right{right:16px}
   .fab{width:44px; height:44px; border-radius:50%; display:grid; place-items:center; cursor:pointer;
     background:#fff; border:1px solid var(--line); color:#46525c; box-shadow:0 10px 26px -14px rgba(21,24,30,.45);
@@ -141,12 +149,56 @@
     flex-direction:column; gap:10px; align-items:flex-start; box-shadow:0 8px 26px -22px rgba(21,24,30,.5)}
   .board h4{font-size:1.02rem}
   .board p{color:var(--mut); font-size:.86rem}
+  /* Per-board support-level badge + hover popover (same visual language as the hero pills). */
+  .sup{position:relative; display:inline-flex; align-items:center; gap:6px; padding:3px 10px; border-radius:999px;
+    font-size:.72rem; font-weight:700; letter-spacing:.2px; cursor:default; width:max-content}
+  .sup .dot{width:7px; height:7px; border-radius:50%; flex:none}
+  .sup.full{background:#e7f6ec; color:#1c7c3f; border:1px solid #bfe6cc}
+  .sup.full .dot{background:#27a35a}
+  .sup.part{background:#fdf3e4; color:#9a6410; border:1px solid #f0dcb4}
+  .sup.part .dot{background:#e3a127}
+  .sup .pop{position:absolute; top:calc(100% + 11px); left:0; transform:translateY(5px);
+    width:min(272px,80vw); background:#fff; border:1px solid var(--line); border-radius:12px; padding:13px 15px;
+    box-shadow:0 18px 44px -18px rgba(21,24,30,.32); text-align:left; font-size:.84rem; font-weight:400;
+    letter-spacing:0; line-height:1.5; color:var(--mut); opacity:0; visibility:hidden;
+    transition:opacity .16s ease, transform .16s ease; z-index:20; cursor:default}
+  .sup .pop b{display:block; color:var(--ink); margin-bottom:4px; font-size:.92rem}
+  .sup .pop::before{content:""; position:absolute; bottom:100%; left:18px; border:7px solid transparent; border-bottom-color:#fff}
+  .sup:hover .pop,.sup:focus .pop,.sup:focus-within .pop{opacity:1; visibility:visible; transform:translateY(0)}
   esp-web-install-button{--esp-tools-button-color:var(--teal);--esp-tools-button-text-color:#fff}
   .dl{display:inline-flex;align-items:center;gap:8px;background:var(--teal);color:#fff;border-radius:9px;
     padding:9px 15px;font-weight:650;font-size:.9rem}
   .dl:hover{background:var(--teal-ink)}
   .dl svg{width:15px;height:15px}
+  .dl2{display:inline-block;margin-top:-2px;text-decoration:none;line-height:1.3}
+  .dl2 .dl2-row{display:inline-flex;align-items:center;gap:6px;font-size:.85rem;color:var(--teal);font-weight:700;white-space:nowrap}
+  .dl2:hover .dl2-row{text-decoration:underline}
+  .dl2 svg{width:14px;height:14px;flex:none}
+  .dl2 .dlver{display:block;font-size:.72rem;color:var(--mut);font-weight:600;margin-top:2px;padding-left:20px;letter-spacing:.03em}
+  .dl2 .dlver:empty{display:none}
   .hint{max-width:760px;margin:18px auto 0;color:var(--mut);font-size:.86rem;text-align:center}
+  /* device selector — grouped by manufacturer, collapsible, searchable */
+  .devsel{max-width:840px; margin:20px auto 0}
+  .devsearch{position:relative; max-width:460px; margin:0 auto 18px}
+  .devsearch>svg{position:absolute; left:15px; top:50%; transform:translateY(-50%); width:17px; height:17px; color:var(--mut); pointer-events:none}
+  .devsearch input{width:100%; box-sizing:border-box; font:inherit; font-size:.95rem; padding:11px 42px; border:1px solid var(--line); border-radius:11px; background:#fff; color:var(--ink)}
+  .devsearch input::-webkit-search-cancel-button{display:none}
+  .devsearch input:focus{outline:none; border-color:var(--teal); box-shadow:0 0 0 3px rgba(21,182,166,.15)}
+  .devsearch-x{position:absolute; right:8px; top:50%; transform:translateY(-50%); width:26px; height:26px; border:0; border-radius:50%; background:var(--bg2); color:var(--mut); font-size:1.15rem; line-height:1; cursor:pointer; display:flex; align-items:center; justify-content:center}
+  .devsearch-x:hover{color:var(--ink); background:var(--line)}
+  .devsearch-empty{text-align:center; color:var(--mut); font-size:.9rem; margin:12px 0 0}
+  .devsearch-empty button{font:inherit; font-size:.9rem; color:var(--teal-ink); background:none; border:0; padding:0; cursor:pointer; text-decoration:underline}
+  .mfr{border:1px solid var(--line); border-radius:14px; background:var(--bg2); margin:0 auto 12px; overflow:hidden}
+  .mfr[hidden]{display:none}
+  .mfr>summary{list-style:none; cursor:pointer; user-select:none; display:flex; align-items:center; gap:11px; padding:15px 18px; font-weight:700; font-size:1.05rem; color:var(--ink)}
+  .mfr>summary::-webkit-details-marker{display:none}
+  .mfr>summary:hover{color:var(--teal-ink)}
+  .mfr-name{flex:1 1 auto}
+  .mfr-count{font-weight:600; font-size:.78rem; color:var(--mut); letter-spacing:.02em}
+  .mfr .chev{width:18px; height:18px; color:var(--mut); flex:none; transition:transform .18s}
+  .mfr[open]>summary .chev{transform:rotate(180deg)}
+  .mfr-boards{max-width:none; margin:0; padding:2px 16px 18px}
+  .board[hidden]{display:none}
   /* "install a previous version" picker */
   .verpick{max-width:760px; margin:16px auto 0; border:1px solid var(--line); border-radius:12px; background:var(--bg2); text-align:left}
   .verpick summary{cursor:pointer; padding:12px 16px; font-weight:600; font-size:.92rem; color:var(--ink); list-style:none; user-select:none}
@@ -210,6 +262,11 @@
 </style>
 </head>
 <body>
+<div class="donate-bar" id="donateBar">
+  <span>Like the project and want to donate? Help out the <b>MeshCore</b> founders instead. <a href="https://blog.meshcore.io/2026/07/04/help-us-save-meshcore" target="_blank" rel="noopener">Learn more</a></span>
+  <a class="donate-cta" href="https://givealittle.co.nz/cause/help-us-save-meshcore" target="_blank" rel="noopener">Donate</a>
+  <button class="x" id="donateX" type="button" aria-label="Dismiss">&times;</button>
+</div>
 <div id="vanta-bg"></div>
 
 <!-- floating quick links -->
@@ -225,9 +282,9 @@
   <a class="fab" href="https://github.com/ALLFATHER-BV/wadamesh/issues" target="_blank" rel="noopener" aria-label="Report a bug on GitHub" title="Report a bug">
     <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><rect width="8" height="14" x="8" y="6" rx="4"/><path d="m19 7-3 2"/><path d="m5 7 3 2"/><path d="m19 19-3-2"/><path d="m5 19 3-2"/><path d="M20 13h-4"/><path d="M4 13h4"/><path d="m10 4 1 2"/><path d="m14 4-1 2"/></svg>
   </a>
-  <button class="fab" id="docsBtn" type="button" aria-label="Documentation" title="Documentation">
+  <a class="fab" id="docsBtn" href="docs.html" aria-label="Documentation" title="Documentation">
     <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M15 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V7z"/><path d="M14 2v5h5"/><path d="M16 13H8"/><path d="M16 17H8"/><path d="M10 9H8"/></svg>
-  </button>
+  </a>
   <a class="fab" href="https://t413.com/p/projects/MapTileDl/" target="_blank" rel="noopener" aria-label="Map tile downloader" title="Map tile downloader">
     <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M9 18l-6 3V6l6-3 6 3 6-3v15l-6 3-6-3z"/><path d="M9 3v15"/><path d="M15 6v15"/></svg>
   </a>
@@ -317,6 +374,12 @@
       <button class="back" data-back>← choose a different path</button>
       <div class="guide-head"><h3>Standalone install</h3></div>
       <p class="p">Plug the device in over USB and flash it right here. Works in <b>Chrome</b> or <b>Edge</b> on desktop.</p>
+      <div class="chtoggle" role="group" aria-label="Release channel" style="display:inline-flex;margin:14px 0 0;border:1px solid var(--line);border-radius:10px;overflow:hidden">
+        <button type="button" data-wm-ch="stable" style="font:inherit;font-size:.85rem;font-weight:600;padding:7px 16px;border:0;background:#fff;color:var(--mut);cursor:pointer">Stable</button>
+        <button type="button" data-wm-ch="beta" style="font:inherit;font-size:.85rem;font-weight:600;padding:7px 16px;border:0;border-left:1px solid var(--line);background:#fff;color:var(--mut);cursor:pointer">Beta · testing</button>
+      </div>
+      <p style="margin:12px auto 0;max-width:600px;text-align:left;font-size:.88rem;line-height:1.6"><b>Stable</b> is the tested default. Pick it unless you want to help test. <b>Beta &middot; testing</b> gets new features and fixes earlier, before they are proven, so it can be rough. It is for trying things early and reporting bugs.<br>Already running WADAMESH? You do not have to reflash to switch channels: turn on <b>Settings &rarr; About &rarr; "Get test builds (beta)"</b> on the device and it updates to test builds over Wi-Fi. Switch it off to go back to stable.</p>
+      <p data-wm-betahint hidden style="margin:8px auto 0;font-size:.84rem;color:#b4631a;max-width:560px">Beta builds are newer and less tested — for trying things early and reporting bugs. On a T-Deck under Launcher you download the .bin and side-load it.</p>
       <div data-whatsnew hidden style="margin:18px auto 0;max-width:560px;background:rgba(21,182,166,.07);border:1px solid rgba(21,182,166,.28);border-radius:12px;padding:13px 16px;text-align:left">
         <div style="font-weight:600">What's new in <span data-wn-tag style="color:var(--teal)">the latest build</span></div>
         <ul data-wn-notes style="margin:7px 0 0;padding-left:18px;font-size:.9rem;color:var(--mut);line-height:1.55"></ul>
@@ -326,16 +389,102 @@
         <div class="step"><div class="num">2</div><div><h4>Pick your board &amp; install</h4><p>Hit <b>Install</b> below, choose the serial port, and let it flash. It does a clean full install.</p></div></div>
         <div class="step"><div class="num">3</div><div><h4>You're on the mesh</h4><p>The device reboots into WADAMESH. Set your name + region in the first-run wizard.</p></div></div>
       </div>
-      <div class="boards">
-        <div class="board"><h4>Heltec V4 + TFT</h4><p>ESP32-S3 with CHSC6x touch.</p>
-          <esp-web-install-button id="inst-heltec" manifest="https://firmware.wadamesh.com/latest/manifest-heltec-v4-tft.json"></esp-web-install-button></div>
-        <div class="board"><h4>LilyGo T-Deck / Plus</h4><p>ESP32-S3 keyboard handheld.</p>
-          <esp-web-install-button id="inst-tdeck" manifest="https://firmware.wadamesh.com/latest/manifest-tdeck.json"></esp-web-install-button></div>
-        <div class="board"><h4>Tanmatsu</h4><p>ESP32-P4 keyboard handheld.</p>
-          <p style="color:var(--mut);font-size:.84rem;margin:0;line-height:1.5">Already have one? No USB flashing needed — install WADAMESH straight from the <b>Tanmatsu app store</b> on the device.</p>
-          <a class="dl" href="https://shop.nicolaielectronics.nl/" target="_blank" rel="noopener"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M6 2 3 6v14a2 2 0 0 0 2 2h14a2 2 0 0 0 2-2V6l-3-4z"/><path d="M3 6h18"/><path d="M16 10a4 4 0 0 1-8 0"/></svg>Get a Tanmatsu</a></div>
+      <div class="devsel" id="devsel">
+        <div class="devsearch">
+          <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><circle cx="11" cy="11" r="7"/><path d="M21 21l-3.6-3.6"/></svg>
+          <input type="search" id="devSearch" autocomplete="off" placeholder="Search by device or maker — T-Deck, Heltec, P4…" aria-label="Search devices">
+          <button type="button" id="devClearX" class="devsearch-x" data-devclear hidden aria-label="Clear search">&times;</button>
+        </div>
+        <p class="devsearch-empty" data-devempty hidden>No devices match “<span data-devq></span>”. <button type="button" data-devclear>Clear search</button></p>
+
+        <details class="mfr" open data-mfr="LilyGo">
+          <summary><span class="mfr-name">LilyGo</span><span class="mfr-count"></span><svg class="chev" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M6 9l6 6 6-6"/></svg></summary>
+          <div class="boards mfr-boards">
+            <div class="board" data-search="lilygo t-deck tdeck plus esp32-s3 keyboard handheld"><h4>LilyGo T-Deck / Plus</h4><p>ESP32-S3 keyboard handheld.</p>
+              <span class="sup full" tabindex="0"><span class="dot"></span>Fully supported<span class="pop"><b>Fully supported</b>Everything wadamesh offers works here — this is one of the two primary development boards, tested on every release.</span></span>
+              <esp-web-install-button id="inst-tdeck" manifest="https://firmware.wadamesh.com/latest/manifest-tdeck.json"></esp-web-install-button>
+              <a class="dl2" data-dl-board="tdeck" download href="https://firmware.wadamesh.com/latest/wadamesh-tdeck-merged.bin"><span class="dl2-row"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M12 3v12M7 11l5 5 5-5M5 21h14"/></svg>Download .bin</span><span class="dlver" data-dl-ver></span></a></div>
+            <div class="board" data-search="lilygo t-display p4 tdisplay amoled rm69a10 esp32-p4 touch handheld"><h4>LilyGo T-Display P4 <span style="font-weight:600;color:var(--mut)">(AMOLED)</span></h4><p>ESP32-P4 &middot; AMOLED touch handheld.</p>
+              <span class="sup part" tabindex="0"><span class="dot"></span>Partially supported<span class="pop"><b>Partially supported</b>Early port — it's known that not everything works yet, but the core does: LoRa mesh communication, chat, map, GPS and the phone-app link over Wi-Fi or USB. Bluetooth pairing isn't available on this board (a hardware limitation of its stock radio firmware).</span></span>
+              <esp-web-install-button id="inst-tdp4" manifest="https://firmware.wadamesh.com/latest-beta/manifest-tdisplay-p4.json"></esp-web-install-button>
+              <a class="dl2" data-dl-board="tdisplay-p4" data-dl-betaonly download href="https://firmware.wadamesh.com/latest-beta/wadamesh-tdisplay-p4-merged.bin"><span class="dl2-row"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M12 3v12M7 11l5 5 5-5M5 21h14"/></svg>Download .bin</span><span class="dlver" data-dl-ver></span></a>
+              <p data-wm-betaonly style="color:var(--mut);font-size:.78rem;margin:6px 0 0">New board: beta channel only until the next stable.</p></div>
+            <div class="board" data-search="lilygo t-display p4 tdisplay lcd tft hi8561 esp32-p4 touch handheld"><h4>LilyGo T-Display P4 <span style="font-weight:600;color:var(--mut)">(LCD)</span></h4><p>ESP32-P4 &middot; TFT-LCD touch handheld.</p>
+              <span class="sup part" tabindex="0"><span class="dot"></span>Partially supported<span class="pop"><b>Partially supported</b>The LCD-screen model of the T-Display P4 (the AMOLED variant is listed above). Early port — the core works: LoRa mesh, chat, map, GPS and the phone-app link over Wi-Fi or USB. Bluetooth pairing isn't available on this board. Flash with care and report back.</span></span>
+              <esp-web-install-button id="inst-tdp4-lcd"></esp-web-install-button>
+              <a class="dl2" id="dl-tdp4-lcd" download><span class="dl2-row"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M12 3v12M7 11l5 5 5-5M5 21h14"/></svg>Download .bin</span><span class="dlver" id="dl-tdp4-lcd-ver"></span></a>
+              <p data-wm-betaonly style="color:var(--mut);font-size:.78rem;margin:6px 0 0">New screen variant, not yet hardware-tested &mdash; beta only. Flash with care and report back.</p></div>
+            <div class="board" data-search="lilygo t-lora pager tlora esp32-s3 qwerty rotary encoder lr1121 sx1262"><h4>LilyGo T-LoRa Pager</h4><p>ESP32-S3 QWERTY + rotary encoder.</p>
+              <span class="sup part" tabindex="0"><span class="dot"></span>Partially supported<span class="pop"><b>Partially supported</b>New community port (thanks @codemonkeybr). The core works: LoRa mesh communication, chat, contacts, channels and the phone-app link. Pick the build that matches your radio chip.</span></span>
+              <p style="color:var(--mut);font-size:.8rem;margin:0">Radio <b>LR1121</b>:</p>
+              <esp-web-install-button id="inst-pager-lr1121" manifest="https://firmware.wadamesh.com/latest-beta/manifest-tlora-pager-lr1121.json"></esp-web-install-button>
+              <a class="dl2" data-dl-board="tlora-pager-lr1121" data-dl-betaonly download href="https://firmware.wadamesh.com/latest-beta/wadamesh-tlora-pager-lr1121-merged.bin"><span class="dl2-row"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M12 3v12M7 11l5 5 5-5M5 21h14"/></svg>Download .bin</span><span class="dlver" data-dl-ver></span></a>
+              <p style="color:var(--mut);font-size:.8rem;margin:8px 0 0">Radio <b>SX1262</b>:</p>
+              <esp-web-install-button id="inst-pager-sx1262" manifest="https://firmware.wadamesh.com/latest-beta/manifest-tlora-pager-sx1262.json"></esp-web-install-button>
+              <a class="dl2" data-dl-board="tlora-pager-sx1262" data-dl-betaonly download href="https://firmware.wadamesh.com/latest-beta/wadamesh-tlora-pager-sx1262-merged.bin"><span class="dl2-row"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M12 3v12M7 11l5 5 5-5M5 21h14"/></svg>Download .bin</span><span class="dlver" data-dl-ver></span></a>
+              <p data-wm-betaonly style="color:var(--mut);font-size:.78rem;margin:6px 0 0">New board: beta channel only until the next stable.</p></div>
+          </div>
+        </details>
+
+        <details class="mfr" open data-mfr="Heltec">
+          <summary><span class="mfr-name">Heltec</span><span class="mfr-count"></span><svg class="chev" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M6 9l6 6 6-6"/></svg></summary>
+          <div class="boards mfr-boards">
+            <div class="board" data-search="heltec v4 tft esp32-s3 chsc6x touch"><h4>Heltec V4 + TFT</h4><p>ESP32-S3 with CHSC6x touch.</p>
+              <span class="sup full" tabindex="0"><span class="dot"></span>Fully supported<span class="pop"><b>Fully supported</b>Everything wadamesh offers works here — this is one of the two primary development boards, tested on every release.</span></span>
+              <esp-web-install-button id="inst-heltec" manifest="https://firmware.wadamesh.com/latest/manifest-heltec-v4-tft.json"></esp-web-install-button>
+              <a class="dl2" data-dl-board="heltec-v4-tft" download href="https://firmware.wadamesh.com/latest/wadamesh-heltec-v4-tft-merged.bin"><span class="dl2-row"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M12 3v12M7 11l5 5 5-5M5 21h14"/></svg>Download .bin</span><span class="dlver" data-dl-ver></span></a></div>
+            <div class="board" data-search="heltec v4-r8 v4 r8 esp32-s3 psram sd card experimental"><h4>Heltec V4-R8 <span style="font-weight:600;color:var(--mut)">(experimental)</span></h4><p>ESP32-S3 &middot; 8&nbsp;MB PSRAM &middot; SD card.</p>
+              <span class="sup part" tabindex="0"><span class="dot"></span>Partially supported<span class="pop"><b>Partially supported</b>The core works: LoRa mesh communication, chat, contacts, channels and the phone-app link. This revision is still being hardware-verified — flash with care and report back.</span></span>
+              <esp-web-install-button id="inst-v4r8" manifest="https://firmware.wadamesh.com/latest-beta/manifest-heltec-v4-r8-tft.json"></esp-web-install-button>
+              <a class="dl2" data-dl-board="heltec-v4-r8-tft" data-dl-betaonly download href="https://firmware.wadamesh.com/latest-beta/wadamesh-heltec-v4-r8-tft-merged.bin"><span class="dl2-row"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M12 3v12M7 11l5 5 5-5M5 21h14"/></svg>Download .bin</span><span class="dlver" data-dl-ver></span></a>
+              <p data-wm-betaonly style="color:var(--mut);font-size:.78rem;margin:6px 0 0">New board, not yet hardware-tested &mdash; beta only. Please flash with care and report back.</p></div>
+          </div>
+        </details>
+
+        <details class="mfr" data-mfr="Elecrow">
+          <summary><span class="mfr-name">Elecrow</span><span class="mfr-count"></span><svg class="chev" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M6 9l6 6 6-6"/></svg></summary>
+          <div class="boards mfr-boards">
+            <div class="board" data-search="elecrow thinknode m9 esp32-s3 qwerty lr1110 handheld"><h4>ThinkNode M9</h4><p>ESP32-S3 QWERTY handheld (LR1110).</p>
+              <span class="sup part" tabindex="0"><span class="dot"></span>Partially supported<span class="pop"><b>Partially supported</b>The core works: LoRa mesh communication, chat, contacts, channels and the phone-app link. Not every feature has been ported or hardware-verified on this board yet.</span></span>
+              <esp-web-install-button id="inst-m9" manifest="https://firmware.wadamesh.com/latest-beta/manifest-thinknode-m9.json"></esp-web-install-button>
+              <a class="dl2" data-dl-board="thinknode-m9" data-dl-betaonly download href="https://firmware.wadamesh.com/latest-beta/wadamesh-thinknode-m9-merged.bin"><span class="dl2-row"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M12 3v12M7 11l5 5 5-5M5 21h14"/></svg>Download .bin</span><span class="dlver" data-dl-ver></span></a>
+              <p data-wm-betaonly style="color:var(--mut);font-size:.78rem;margin:6px 0 0">New board: beta channel only until the next stable.</p></div>
+          </div>
+        </details>
+
+        <details class="mfr" data-mfr="RAKwireless">
+          <summary><span class="mfr-name">RAKwireless</span><span class="mfr-count"></span><svg class="chev" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M6 9l6 6 6-6"/></svg></summary>
+          <div class="boards mfr-boards">
+            <div class="board" data-search="rakwireless rak wismesh tap v2 esp32-s3 touch node"><h4>RAK WisMesh Tap V2</h4><p>ESP32-S3 touch node.</p>
+              <span class="sup part" tabindex="0"><span class="dot"></span>Partially supported<span class="pop"><b>Partially supported</b>The core works: LoRa mesh communication, chat, contacts, channels and the phone-app link. Not every feature has been ported or hardware-verified on this board yet.</span></span>
+              <esp-web-install-button id="inst-rak" manifest="https://firmware.wadamesh.com/latest-beta/manifest-rak-tap-v2.json"></esp-web-install-button>
+              <a class="dl2" data-dl-board="rak-tap-v2" data-dl-betaonly download href="https://firmware.wadamesh.com/latest-beta/wadamesh-rak-tap-v2-merged.bin"><span class="dl2-row"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M12 3v12M7 11l5 5 5-5M5 21h14"/></svg>Download .bin</span><span class="dlver" data-dl-ver></span></a>
+              <p data-wm-betaonly style="color:var(--mut);font-size:.78rem;margin:6px 0 0">New board: beta channel only until the next stable.</p></div>
+          </div>
+        </details>
+
+        <details class="mfr" data-mfr="Nicolai Electronics">
+          <summary><span class="mfr-name">Nicolai Electronics</span><span class="mfr-count"></span><svg class="chev" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M6 9l6 6 6-6"/></svg></summary>
+          <div class="boards mfr-boards">
+            <div class="board" data-search="nicolai electronics tanmatsu esp32-p4 keyboard handheld app store"><h4>Tanmatsu</h4><p>ESP32-P4 keyboard handheld.</p>
+              <span class="sup part" tabindex="0"><span class="dot"></span>Partially supported<span class="pop"><b>Partially supported</b>The core works: LoRa mesh communication, chat, contacts, channels and the phone-app link over Wi-Fi/USB. Some features are still settling on this board (Bluetooth pairing has known gaps).</span></span>
+              <p style="color:var(--mut);font-size:.84rem;margin:0;line-height:1.5">Already have one? No USB flashing needed — install WADAMESH straight from the <b>Tanmatsu app store</b> on the device.</p>
+              <a class="dl" href="https://shop.nicolaielectronics.nl/" target="_blank" rel="noopener"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M6 2 3 6v14a2 2 0 0 0 2 2h14a2 2 0 0 0 2-2V6l-3-4z"/><path d="M3 6h18"/><path d="M16 10a4 4 0 0 1-8 0"/></svg>Get a Tanmatsu</a></div>
+          </div>
+        </details>
+
+        <details class="mfr" data-mfr="Attaky">
+          <summary><span class="mfr-name">Attaky</span><span class="mfr-count"></span><svg class="chev" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M6 9l6 6 6-6"/></svg></summary>
+          <div class="boards mfr-boards">
+            <div class="board" data-search="attaky core esp32-s3 psram experimental"><h4>Attaky Core <span style="font-weight:600;color:var(--mut)">(experimental)</span></h4><p>ESP32-S3 &middot; 16&nbsp;MB &middot; 8&nbsp;MB PSRAM.</p>
+              <span class="sup part" tabindex="0"><span class="dot"></span>Partially supported<span class="pop"><b>Partially supported</b>The core works: LoRa mesh communication, chat, contacts, channels and the phone-app link. This community-contributed board (PR #158) isn't hardware-verified by us yet — flash with care and report back.</span></span>
+              <esp-web-install-button id="inst-attaky" manifest="https://firmware.wadamesh.com/latest-beta/manifest-attaky.json"></esp-web-install-button>
+              <a class="dl2" data-dl-board="attaky" data-dl-betaonly download href="https://firmware.wadamesh.com/latest-beta/wadamesh-attaky-merged.bin"><span class="dl2-row"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M12 3v12M7 11l5 5 5-5M5 21h14"/></svg>Download .bin</span><span class="dlver" data-dl-ver></span></a>
+              <p data-wm-betaonly style="color:var(--mut);font-size:.78rem;margin:6px 0 0">New board, not yet hardware-tested &mdash; beta only. Please flash with care and report back.</p></div>
+          </div>
+        </details>
       </div>
-      <details class="verpick">
+            <details class="verpick">
         <summary>Install a previous version</summary>
         <div class="verpick-body">
           <div class="verpick-row"><label for="verSel">Version</label><select id="verSel" aria-label="Firmware version"></select></div>
@@ -352,6 +501,11 @@
       <div class="guide-head"><h3>Install with bmorcelli's Launcher</h3></div>
       <p class="p"><a href="https://bmorcelli.github.io/Launcher/" target="_blank" rel="noopener">Launcher</a> is a multi-app boot menu for ESP32 devices — keep it, and run WADAMESH as one of your apps.</p>
       <p class="p" style="margin-top:10px"><b>This path is for the LilyGo&nbsp;T-Deck only.</b> On the Heltec&nbsp;V4, install <a href="#standalone" onclick="choose('standalone');return false">Standalone</a> instead.</p>
+      <div class="chtoggle" role="group" aria-label="Release channel" style="display:inline-flex;margin:14px 0 0;border:1px solid var(--line);border-radius:10px;overflow:hidden">
+        <button type="button" data-wm-ch="stable" style="font:inherit;font-size:.85rem;font-weight:600;padding:7px 16px;border:0;background:#fff;color:var(--mut);cursor:pointer">Stable</button>
+        <button type="button" data-wm-ch="beta" style="font:inherit;font-size:.85rem;font-weight:600;padding:7px 16px;border:0;border-left:1px solid var(--line);background:#fff;color:var(--mut);cursor:pointer">Beta · testing</button>
+      </div>
+      <p style="margin:8px auto 0;max-width:560px;font-size:.84rem;color:var(--mut)"><b>Stable</b> is the tested default; <b>Beta</b> gets new builds earlier. The download below follows this choice.</p>
       <div class="steps" style="margin-top:22px">
         <div class="step"><div class="num">1</div><div><h4>Install Launcher first</h4><p>Flash bmorcelli's Launcher to your device, following its own installer — <a href="https://bmorcelli.github.io/Launcher/" target="_blank" rel="noopener">bmorcelli.github.io/Launcher</a>.</p></div></div>
         <div class="step"><div class="num">2</div><div><h4>Add the WADAMESH app</h4><p>Grab the WADAMESH <b>app image</b> for your board below, then install it from Launcher (via its web UI / OTA, or copy the <code>.bin</code> to your SD card).</p></div></div>
@@ -359,7 +513,8 @@
       </div>
       <div class="boards" style="grid-template-columns:1fr; max-width:380px">
         <div class="board"><h4>LilyGo T-Deck / Plus</h4><p>app image (no bootloader)</p>
-          <a class="dl" href="https://firmware.wadamesh.com/latest/wadamesh-tdeck.bin"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M12 3v12M7 11l5 5 5-5M5 21h14"/></svg>Download .bin</a></div>
+          <a class="dl" id="dl-tdeck" download href="https://firmware.wadamesh.com/latest/wadamesh-tdeck.bin"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M12 3v12M7 11l5 5 5-5M5 21h14"/></svg>Download .bin</a>
+          <p style="margin:11px 0 0;font-size:.84rem;color:var(--mut);line-height:1.5">You're downloading version <b data-wn-tag style="color:var(--teal)">…</b><span data-wm-chlabel></span>.<br>The file saves as <code data-dl-fname style="font-size:.82em">wadamesh-tdeck.bin</code> — rename it if you keep several.</p></div>
       </div>
       <p class="hint">New to Launcher? It's the easiest way to try WADAMESH without giving up your other firmware — and you can fully switch to Standalone any time.</p>
     </div>
@@ -474,24 +629,125 @@ We use no tracking, analytics, or advertising cookies. Our CDN and security prov
   try { if (!localStorage.getItem('wm-cookie-ack')) cbar.classList.add('show'); } catch(_) {}
   document.getElementById('cookieok').addEventListener('click', () => { cbar.classList.remove('show'); try { localStorage.setItem('wm-cookie-ack','1'); } catch(_) {} });
 
+  // ---- donate banner: dismissible; shifts the corner FABs down while shown ----
+  (function(){
+    const bar = document.getElementById('donateBar'); if (!bar) return;
+    function setFabTop(){ document.documentElement.style.setProperty('--fab-top', (getComputedStyle(bar).display === 'none' ? 16 : bar.offsetHeight + 12) + 'px'); }
+    try { if (localStorage.getItem('wm-donate-dismiss') === '1') bar.style.display = 'none'; } catch(_) {}
+    setFabTop();
+    addEventListener('resize', setFabTop);
+    document.getElementById('donateX').addEventListener('click', () => { bar.style.display = 'none'; setFabTop(); try { localStorage.setItem('wm-donate-dismiss','1'); } catch(_) {} });
+  })();
+
   // Live release version + "what's new" — read from the firmware host so the
   // flasher always reflects the current build (the release pipeline updates
   // version.json; no site redeploy needed per release).
-  fetch('https://firmware.wadamesh.com/latest/version.json', {cache:'no-store'})
-    .then(r => r.ok ? r.json() : null)
-    .then(v => {
-      if (!v || !v.tag) return;
-      document.querySelectorAll('[data-wn-tag]').forEach(e => e.textContent = v.tag);
-      const notes = Array.isArray(v.notes) ? v.notes : [];
-      document.querySelectorAll('[data-wn-notes]').forEach(ul => {
-        ul.innerHTML = '';
-        notes.forEach(n => { const li = document.createElement('li'); li.textContent = n; ul.appendChild(li); });
-      });
-      if (notes.length) document.querySelectorAll('[data-whatsnew]').forEach(b => b.hidden = false);
-    }).catch(()=>{});
+  // Release channel (Stable default / Beta testing). The toggle swaps the feed dir
+  // on the firmware host — latest/ (stable) <-> latest-beta/ (beta) — and the install
+  // manifests, "what's new", the Launcher .bin link and the version picker follow.
+  const WM = (window.WM = { feed:'latest', arch:'TOUCH' });
+  // ThinkNode M9 + RAK Tap V2 exist on the BETA feed only until the first stable
+  // promote that includes them: their install buttons are pinned to latest-beta in
+  // the HTML and deliberately NOT switched by wmSetChannel. When a stable ships
+  // with their bins, add them here + to wmSetChannel and drop the pinned notes.
+  const WM_MAN = { heltec:'manifest-heltec-v4-tft.json', tdeck:'manifest-tdeck.json' };
+  window.wmManifest = board => 'https://firmware.wadamesh.com/' + WM.feed + '/' + WM_MAN[board];
+  function wmWhatsNew(){
+    const wn = document.querySelectorAll('[data-whatsnew]');
+    fetch('https://firmware.wadamesh.com/' + WM.feed + '/version.json', {cache:'no-store'})
+      .then(r => r.ok ? r.json() : null)
+      .then(v => {
+        if (!v || !v.tag) { wn.forEach(b => b.hidden = true); return; }
+        document.querySelectorAll('[data-wn-tag]').forEach(e => e.textContent = v.tag);
+        const notes = Array.isArray(v.notes) ? v.notes : [];
+        document.querySelectorAll('[data-wn-notes]').forEach(ul => {
+          ul.innerHTML = '';
+          notes.forEach(n => { const li = document.createElement('li'); li.textContent = n; ul.appendChild(li); });
+        });
+        wn.forEach(b => b.hidden = !notes.length);
+      }).catch(() => { wn.forEach(b => b.hidden = true); });
+  }
+  window.wmSetChannel = function(ch){
+    WM.feed = ch === 'beta' ? 'latest-beta' : 'latest';
+    WM.arch = ch === 'beta' ? 'BETA' : 'TOUCH';
+    const bH = document.getElementById('inst-heltec'), bT = document.getElementById('inst-tdeck');
+    if (bH) bH.setAttribute('manifest', wmManifest('heltec'));
+    if (bT) bT.setAttribute('manifest', wmManifest('tdeck'));
+    const dl = document.getElementById('dl-tdeck');
+    if (dl) dl.href = 'https://firmware.wadamesh.com/' + WM.feed + '/wadamesh-tdeck.bin';
+    document.querySelectorAll('[data-wm-chlabel]').forEach(e => e.textContent = ch === 'beta' ? ' · beta (testing)' : ' · stable');
+    document.querySelectorAll('[data-wm-ch]').forEach(b => { const on = b.getAttribute('data-wm-ch') === ch;
+      b.style.background = on ? 'var(--teal)' : '#fff'; b.style.color = on ? '#fff' : 'var(--mut)'; });
+    document.querySelectorAll('[data-wm-betahint]').forEach(e => e.hidden = ch !== 'beta');
+    const vs = document.getElementById('verSel');
+    if (vs && vs.options.length) { vs.selectedIndex = 0; vs.dispatchEvent(new Event('change')); }
+    wmUpdateDownloads();
+    wmWhatsNew();
+  };
+  // Per-board "download the .bin" links on the standalone cards: follow the channel
+  // toggle (beta-only boards stay pinned to latest-beta) and show the exact version
+  // each feed serves — both channel tags are fetched once so every link is accurate.
+  const WM_VER = {};
+  // The T-Display P4 LCD-screen variant ships only in the per-tag BETA archive (no
+  // rolling-feed bin, no server manifest), so wire its Install button to a manifest
+  // built client-side (same blob trick as the previous-version picker) and point its
+  // download at the immutable archive bin. Called once the beta tag is known.
+  window.wmWireP4Lcd = function(tag){
+    const bin = 'https://firmware.wadamesh.com/releases/BETA/' + tag + '/wadamesh-tdisplay-p4-lcd-merged.bin';
+    const btn = document.getElementById('inst-tdp4-lcd');
+    if (btn){ const m = { name:'wadamesh ' + tag + ' \u2014 T-Display P4 (LCD)', version:tag, new_install_prompt_erase:true,
+      builds:[{ chipFamily:'ESP32-P4', parts:[{ path:bin, offset:0 }] }] };
+      btn.setAttribute('manifest', URL.createObjectURL(new Blob([JSON.stringify(m)], {type:'application/json'}))); }
+    const dl = document.getElementById('dl-tdp4-lcd');
+    if (dl){ dl.href = bin; const v = document.getElementById('dl-tdp4-lcd-ver'); if (v) v.textContent = tag; }
+  };
+  window.wmUpdateDownloads = function(){
+    document.querySelectorAll('[data-dl-board]').forEach(a => {
+      const feed = a.hasAttribute('data-dl-betaonly') ? 'latest-beta' : WM.feed;
+      a.href = 'https://firmware.wadamesh.com/' + feed + '/wadamesh-' + a.getAttribute('data-dl-board') + '-merged.bin';
+      const v = a.querySelector('[data-dl-ver]'); if (v) v.textContent = WM_VER[feed] || '';
+    });
+  };
+  ['latest','latest-beta'].forEach(feed => fetch('https://firmware.wadamesh.com/' + feed + '/version.json', {cache:'no-store'})
+    .then(r => r.ok ? r.json() : null).then(v => { if (v && v.tag) { WM_VER[feed] = v.tag; wmUpdateDownloads(); if (feed === 'latest-beta' && window.wmWireP4Lcd) wmWireP4Lcd(v.tag); } }).catch(()=>{}));
+  document.querySelectorAll('[data-wm-ch]').forEach(b => b.addEventListener('click', () => wmSetChannel(b.getAttribute('data-wm-ch'))));
+  wmSetChannel('stable');
+
+  // ---- device selector: fill counts, remember default open state, live search ----
+  (function(){
+    const root = document.getElementById('devsel'); if (!root) return;
+    const input = document.getElementById('devSearch');
+    const clearX = document.getElementById('devClearX');
+    const empty = root.querySelector('[data-devempty]'), qout = root.querySelector('[data-devq]');
+    const groups = Array.from(root.querySelectorAll('.mfr'));
+    groups.forEach(g => { g.dataset.defopen = g.open ? '1' : '0';
+      const n = g.querySelectorAll('.board').length, c = g.querySelector('.mfr-count');
+      if (c) c.textContent = n + (n === 1 ? ' device' : ' devices'); });
+    const txt = b => (b.getAttribute('data-search') || b.textContent || '').toLowerCase();
+    function run(q){
+      const terms = q.toLowerCase().split(/\s+/).filter(Boolean);
+      let anyVisible = false;
+      groups.forEach(g => { let vis = 0;
+        g.querySelectorAll('.board').forEach(b => { const ok = !terms.length || terms.every(t => txt(b).includes(t));
+          b.hidden = !ok; if (ok) vis++; });
+        g.hidden = vis === 0;
+        if (!g.hidden){ anyVisible = true; g.open = terms.length ? true : (g.dataset.defopen === '1'); } });
+      if (empty) empty.hidden = !(terms.length && !anyVisible);
+      if (qout) qout.textContent = q;
+      if (clearX) clearX.hidden = !q;
+    }
+    function clr(){ if (input){ input.value = ''; input.focus(); } run(''); }
+    if (input){ input.addEventListener('input', () => run(input.value));
+      input.addEventListener('keydown', e => { if (e.key === 'Escape') clr(); }); }
+    root.querySelectorAll('[data-devclear]').forEach(b => b.addEventListener('click', clr));
+  })();
 
   // ---- community videos — add an entry here to add a video ----
   const VIDEOS = [
+    // newest first
+    { id: 'e63uKp9r65U', title: 'LilyGo T-Deck Plus + WADAMESH: The Firmware That Finally Makes It Worth It', by: 'Signal Trek' },
+    { id: '1I7Oe1SqFlk', title: 'WadaMesh Update! Supercharge Your T-Deck', by: 'KDHD Stuff' },
+    { id: 's-8pRsC0TYA', title: 'WadaMesh: The Feature That Makes T-Deck Plus Stand Out', by: 'BFGNeil' },
     { id: 'V19od8jbFRc', title: 'WadaMesh: The Best T-Deck Firmware So Far', by: 'KDHD Stuff' },
     // { id: '<youtube-id>', title: '<title>', by: '<channel>' },
   ];
@@ -521,8 +777,7 @@ We use no tracking, analytics, or advertising cookies. Our CDN and security prov
 
   // ---- toast + docs placeholder ----
   function toast(msg){ const t = document.getElementById('toast'); if (!t) return; t.textContent = msg; t.classList.add('show'); clearTimeout(t._t); t._t = setTimeout(() => t.classList.remove('show'), 2400); }
-  const docsBtn = document.getElementById('docsBtn');
-  if (docsBtn) docsBtn.addEventListener('click', () => toast('Documentation — coming soon!'));
+  // The documentation button is a plain link to docs.html (no handler needed).
 
   // ---- standalone: install a previous version (latest 4 betas + release notes) ----
   (function(){
@@ -530,7 +785,7 @@ We use no tracking, analytics, or advertising cookies. Our CDN and security prov
     const wrap = sel.closest('.verpick');
     const notesEl = document.getElementById('verNotes'), activeEl = document.getElementById('verActive');
     const btnH = document.getElementById('inst-heltec'), btnT = document.getElementById('inst-tdeck');
-    const latestH = btnH && btnH.getAttribute('manifest'), latestT = btnT && btnT.getAttribute('manifest');
+    const latestH = () => window.wmManifest('heltec'), latestT = () => window.wmManifest('tdeck');
     const num = t => parseInt((String(t).match(/beta_(\d+)/) || [])[1] || '-1', 10);
     let notes = {};
     const esc = s => s.replace(/&/g,'&amp;').replace(/</g,'&lt;').replace(/>/g,'&gt;');
@@ -546,10 +801,10 @@ We use no tracking, analytics, or advertising cookies. Our CDN and security prov
     function showNotes(tag){ notesEl.innerHTML = notes[tag] ? md(notes[tag])
       : '<p>Release notes on <a href="https://github.com/ALLFATHER-BV/wadamesh/releases/tag/'+tag+'" target="_blank" rel="noopener">GitHub</a>.</p>'; }
     function blobManifest(tag, board){ const m = { name:'wadamesh '+tag, version:tag, new_install_prompt_erase:true,
-      builds:[{ chipFamily:'ESP32-S3', parts:[{ path:'https://firmware.wadamesh.com/releases/TOUCH/'+tag+'/wadamesh-'+board+'-merged.bin', offset:0 }] }] };
+      builds:[{ chipFamily:'ESP32-S3', parts:[{ path:'https://firmware.wadamesh.com/releases/'+((window.WM&&window.WM.arch)||'TOUCH')+'/'+tag+'/wadamesh-'+board+'-merged.bin', offset:0 }] }] };
       return URL.createObjectURL(new Blob([JSON.stringify(m)], {type:'application/json'})); }
     function apply(){ const tag = sel.value, isLatest = sel.selectedIndex === 0;
-      if (isLatest){ if(btnH&&latestH) btnH.setAttribute('manifest', latestH); if(btnT&&latestT) btnT.setAttribute('manifest', latestT); activeEl.hidden = true; }
+      if (isLatest){ if(btnH) btnH.setAttribute('manifest', latestH()); if(btnT) btnT.setAttribute('manifest', latestT()); activeEl.hidden = true; }
       else { if(btnH) btnH.setAttribute('manifest', blobManifest(tag,'heltec-v4-tft')); if(btnT) btnT.setAttribute('manifest', blobManifest(tag,'tdeck'));
         activeEl.hidden = false; activeEl.innerHTML = 'The <b>Install</b> buttons above now flash <b>'+tag+'</b>.'; }
       showNotes(tag); }

include/lv_conf.h

@@ -3,6 +3,10 @@
 #define LV_COLOR_DEPTH 16
 #define LV_COLOR_16_SWAP 0
 
+// NOTE: LV_USE_LARGE_COORD is intentionally OFF — enabling it caused a boot-time
+// LoadProhibited in LVGL on the T-Deck. Chat scroll heights >8191 px are handled
+// in UITask via int32 layout offsets + compressed LVGL scroll coords.
+
 // Route LVGL's general allocator through PSRAM-preferred wrappers (defined in
 // LvglPsramAlloc.cpp). The board has 8 MB of PSRAM and the ~60 KB of widget
 // state LVGL grows during buildUiTree would otherwise come out of the 320 KB
@@ -48,10 +52,11 @@
 #define LV_FONT_MONTSERRAT_12 1
 #define LV_FONT_MONTSERRAT_14 1
 #define LV_FONT_MONTSERRAT_16 1
-/* Larger Montserrat sizes for the Tanmatsu's crisp "UI size" (Large/Huge) — render the UI bigger
- * at native resolution instead of upscaling a low-res frame. Gated to the Tanmatsu so the
- * flash-tighter S3 touch builds don't pay for fonts they never use. */
-#if defined(HAS_TANMATSU)
+/* Larger Montserrat sizes for the large-screen boards' crisp "UI size" (Large/Huge) — render the
+ * UI bigger at native resolution instead of upscaling a low-res frame. Gated to the CAP_LARGE_SCREEN
+ * P4 boards (Tanmatsu + T-Display P4) so the flash-tighter S3 touch builds don't pay for fonts they
+ * never use. (device_caps.h isn't included here, so match on the board macros directly.) */
+#if defined(HAS_TANMATSU) || defined(HAS_TDISPLAY_P4)
 #define LV_FONT_MONTSERRAT_18 1
 #define LV_FONT_MONTSERRAT_20 1
 #define LV_FONT_MONTSERRAT_24 1
@@ -108,6 +113,7 @@
  * render full-colour emoji inline with text. The emoji set is pre-baked to
  * RGB565+alpha lv_img_dsc_t C-arrays (emoji_data.c) and wired as the tail of the
  * font fallback chain in UITask (montserrat -> extras -> emoji). */
+#define LV_USE_FONT_COMPRESSED 1   /* decode RLE-compressed extras/accent fonts (Tanmatsu size budget) */
 #define LV_USE_IMGFONT 1
 
 /* Bi-directional text + Arabic/Persian contextual shaping. Lets Arabic (and

release-notes/beta_20.txt

@@ -2,7 +2,7 @@
 
 # --- New ---
 Spectrum analyzer: a new app in the app drawer that sweeps the LoRa band and draws a live spectrum with a waterfall under it, a colour scale on the side and a peak-frequency readout. Handy for spotting interference or finding a quiet part of the band before you settle on a frequency.
-Custom notification sounds: you can set your own notification sound from a 16-bit WAV file on the SD card, per event, instead of only the built-in chime. There is also a separate switch for the direct-message chime.
+Custom notification sounds: you can set your own notification sound from a 16-bit WAV file on the SD card, per event, instead of only the built-in chime. There is also a separate switch for the direct-message chime. Contributed by Yazutsu (#66).
 Saved Wi-Fi networks: the device remembers more than one network now and can auto-join them. Each saved network has its own auto-join switch and can be forgotten on its own.
 One chat settings screen: the gear on a chat or channel row, a long-press on that row, and the cog inside an open chat now all open the same screen. Everything is in one place: mark as read, mute messages, mute mentions, region and scope, share secret, blocked users, and remove or delete.
 Per-channel mute: silence the notification sound for a single channel while the rest keep chiming.

release-notes/beta_21.txt

@@ -0,0 +1,16 @@
+# beta_21 (one user-facing note per non-blank, non-# line; # lines are section comments)
+
+# --- New ---
+Stable and test update channels. beta_21 is the first stable build. On devices that update over Wi-Fi there is now a "Get test builds (beta)" switch on the About screen: leave it off to stay on stable releases, or turn it on to receive test builds earlier — it switches both the "update available" check and the firmware you install to the test channel. You can go back to stable at any time.
+MQTT bridge (highly experimental, off by default). An opt-in bridge that forwards the messages your node receives to an MQTT broker of your choice, so you can log your mesh or wire it into other tools. It is gated behind a privacy consent you have to tick, direct messages are excluded unless you deliberately enable them, and the payload can be sealed with an encryption key so only you can read it. Use a broker you control, never a public one. This is experimental and may change. Contributed by Samuel Coustet (@samuelcoustet, PR #71), reworked for privacy.
+Portugal (Narrow) region preset, so Portuguese users can pick the local defaults in one tap. (Issue #74, requested by Salgueiron.)
+Saved-contacts counter. The Contacts overflow menu now shows how many contacts you have saved out of the maximum it can hold (for example 42 / 2000). (Issue #72, asked by Buko84.)
+
+# --- Fixed ---
+The signal probe never travels past the first node now. The "auto-discover" signal pulse, and the probe behind the Signal popup, are sent strictly zero-hop, so a repeater can no longer re-flood them across the mesh. The probe only measures the link to whatever hears it first, which is what it was always meant to do.
+Your most relevant contacts now show when you have a lot of them. The on-screen contact list is capped for performance, but it was trimming the list before sorting it, so some contacts could drop out of view. It now sorts first, shows the closest matches, and adds a "+N more — search to narrow the list" line at the bottom. (Issue #73, reported by 1nerdherder.)
+The blocked-users list opened from Contacts now shows the proper two-line title bar with a back button, instead of an unlabelled screen.
+The Contacts overflow popup fits the screen again after the saved-contacts counter was added.
+
+# --- Also ---
+Everything from beta_20 is included.

release-notes/beta_22.txt

@@ -0,0 +1,8 @@
+# beta_22 (TEST build — one user-facing note per non-blank, non-# line; # lines are section comments)
+
+# --- Fixed ---
+The signal probe reads a real signal again. In beta_21 the probe was changed to a zero-hop advert so it could never be re-flooded across the mesh — but nothing answers a zero-hop advert, so the signal reading stopped updating. It now sends a directed trace "ping" to your nearest repeater instead: the repeater replies directly (it still never floods the mesh) and the device reads the link signal from that reply. So you get both — no mesh flooding, and a live signal again. Thanks to Tarmo for spotting this and suggesting the fix.
+Contacts discovered while your phone is connected now show on the device too. If the T-Deck was connected to the MeshCore phone app over Bluetooth and heard a new node, the node appeared on the phone but not on the device's own screen, and the Contacts list did not refresh. The device now updates its own Contacts list and notification whether or not a phone app is connected. (Issue #73, reported by 1nerdherder.)
+
+# --- Also ---
+This is a test-channel build (opt in with "Get test builds" on the About screen). Everything from beta_21, the first stable, is included.

release-notes/beta_23.txt

@@ -0,0 +1,11 @@
+# beta_23 (TEST build — one user-facing note per non-blank, non-# line; # lines are section comments)
+
+# --- Fixed ---
+Bluetooth companion reliability, especially messages and repeater admin. When a phone or Mac was connected over Bluetooth, the device was sending it a log entry for every LoRa packet it heard — on a busy mesh that swamped the Bluetooth link and starved the frames that actually matter. The device no longer sends that packet log over Bluetooth (USB and Wi-Fi companions still get it), so incoming messages reach the app and repeater / room-server admin (Manage Regions, saving parameters) stops timing out and dropping the connection. (Issues #46 and #54.)
+
+# --- Also in this test line (carried from beta_22) ---
+The signal probe reads a real signal again: it sends a directed trace "ping" to your nearest repeater, which replies, instead of a zero-hop advert that nothing answers. Thanks to Tarmo for spotting it.
+Contacts discovered while your phone is connected now also show on the device's own screen, not just in the phone app. (Issue #73.)
+
+# --- Also ---
+This is a test-channel build (opt in with "Get test builds" on the About screen). Everything from the stable beta_21 is included.

release-notes/beta_24.txt

@@ -0,0 +1,7 @@
+# beta_24 (TEST build — one user-facing note per non-blank, non-# line; # lines are section comments)
+
+# --- Fixed ---
+The signal probe now reads a real signal to your nearest repeater. It sends the standard mesh node-discovery request that repeaters actually answer, instead of the trace packet from the last test build that they ignored, so the signal reading updates again. This is the same request the Ultra and KiekR apps use. Thanks to Tarmo for decoding the exact packet.
+
+# --- Also ---
+This is a test-channel build (opt in with "Get test builds" on the About screen). Everything from the stable beta_21 and the earlier test builds is included.

release-notes/beta_25.txt

@@ -0,0 +1,21 @@
+# beta_25 (STABLE — rolls up the beta_22..25 test builds on top of the previous stable, beta_21.
+# One user-facing note per non-blank, non-# line; # lines are section comments.)
+
+# --- Fixed ---
+The signal probe reads a live signal to your nearest repeater again. It sends the standard mesh node-discovery request that repeaters actually answer (the same one the Ultra and KiekR apps use), so the signal reading updates. Thanks to Tarmo for decoding the exact packet.
+Bluetooth companion reliability, especially messages and repeater / room-server admin. The device no longer floods the Bluetooth link with a per-packet log (USB and Wi-Fi companions still get it), so incoming messages reach the app and admin actions like Manage Regions stop timing out. (Issues #46 and #54.)
+Contacts show up right away. A node you discover, even while you're on another screen or one the phone app adds over Bluetooth, now appears in your contact list immediately instead of only after you change the sort. Thanks to 1nerdherder for the report. (Issue #73.)
+Manual telemetry and status requests now work on the first tap instead of needing a second. Thanks to Dan Vybiral (@Vybo) for the fix. (Issue #81.)
+On the emoji picker and quick-chat replies, pressing Esc or the red X now closes just the popup instead of the whole chat screen.
+Lock screen: you can now unlock the device after the screen wakes from an incoming message.
+
+# --- New ---
+New "Advertise on boot" option in the Advertise app (off by default): turn it on to send one advert when the device powers on, so nearby nodes refresh your details after a reflash. (Issue #76.)
+
+# --- Tanmatsu ---
+Tanmatsu: Wi-Fi map tiles now download and display, cached to the microSD card.
+Tanmatsu: contacts and message history now survive a reboot (moved to the microSD card, so keep a card inserted).
+Tanmatsu: fixed the crash that stopped the app from booting; popups now fit the screen and scroll, and keyboard navigation stays inside an open popup.
+
+# --- Also ---
+This is the new stable build, promoted from the beta_25 test channel. It includes everything from the beta_22, beta_23, beta_24 and beta_25 test builds.

release-notes/beta_26.txt

@@ -0,0 +1,8 @@
+# beta_26 (TEST) — storage-reliability fix on top of the current stable (beta_25).
+# One user-facing note per non-blank, non-# line; # lines are section comments.
+
+# --- Fixed ---
+Fixed a reboot loop that could hit while the device saved its contact list. Internal-flash housekeeping during a save could freeze the device long enough to trip the watchdog and restart it; that save no longer trips it. Thanks to the crash report that pinned it down.
+
+# --- Improved ---
+On devices with a microSD card, contacts and channels are now kept on the card (like chat history and map tiles already are). That frees the small internal flash and puts the frequently-rewritten files on the more reliable card. Your existing contacts move to the card automatically the first time; your identity and settings stay in internal flash, so the node is unchanged.

release-notes/beta_27.txt

@@ -0,0 +1,15 @@
+# beta_27 (STABLE — rolls up the beta_26 + beta_27 test builds on top of the previous stable, beta_25.
+# One user-facing note per non-blank, non-# line; # lines are section comments.)
+
+# --- Fixed ---
+Fixed a reboot loop that could hit while the device saved its contact list. Internal-flash housekeeping during a save could freeze the device long enough to trip the watchdog and restart it; that save no longer trips it. Thanks to the crash report that pinned it down.
+Devices installed under the Launcher no longer show the on-device "Install update" button. That update path only works on a standalone flash; under the Launcher it failed with "won't fit: Bad Size Given". The "update available" note stays, but you update through the Launcher instead. Thanks to Keith (KM1USR) for the report.
+
+# --- New ---
+Keyboard backlight brightness control on the T-Deck: a live slider plus Off / 25 / 50 / 75 / Max presets in Settings > Keyboard. It dims smoothly (fine-grained at the low end), applies to the on and auto modes and the new-message flash, and survives a reboot. Thanks to Yazutsu (PR #85).
+
+# --- Improved ---
+On devices with a microSD card, contacts and channels are now kept on the card (like chat history and map tiles already are). Your existing contacts move over automatically on first boot; your identity and settings stay in internal flash, so the node is unchanged. Keep the card inserted afterwards - the contact list lives on it, and an older firmware won't look there if you ever downgrade.
+
+# --- Also ---
+This is the new stable build, promoted from the beta_27 test channel. It includes everything from the beta_26 and beta_27 test builds.

release-notes/beta_28.txt

@@ -0,0 +1,13 @@
+# beta_28 (TEST) — room-server session fix + the wyvern.red feedback batch, on top of stable beta_27.
+# One user-facing note per non-blank, non-# line; # lines are section comments.
+
+# --- Fixed ---
+Room servers no longer go one-way "frozen". The device now keeps its room login session alive in the background and automatically logs back in when the session drops, so posts keep being delivered and new room messages keep arriving. There is also a new "Log in again" option in the room chat's menu, and a clear warning when the room only granted you read-only access (posts would previously just vanish). Thanks to EricMW61 for the report (issue #89).
+The screen now truly switches off in standby. Before, only the backlight went dark while the panel kept displaying the last image - the actual cause of the LCD ghosting / burn-in some of you noticed. The panel itself now sleeps, and on wake your screen is back instantly. Also: a lit lock screen now always dims on every board, a screen woken by a message re-darkens after 10 seconds, and the lock-screen clock drifts a few pixels to avoid ghosting. Thanks to wyvern.red for pinning this down.
+The on-device "Install update" now also hides on mixed or older partition layouts where an update could crash the device halfway through (found via a user crash report - thanks!).
+
+# --- New ---
+Compact messages (IRC style): a new toggle in chat settings shows one dense line per message instead of bubbles, fitting two to three times more history on screen. Off by default. (wyvern.red's suggestion.)
+Clearer delivery ticks: an up-arrow means sent but not yet confirmed, a double check means the other side confirmed it, and a failed message now says "tap to resend" - one tap resends it. (wyvern.red)
+Keyboard navigation: the scroll keys (F/C) now zoom the map, and backspace in an empty message box exits typing mode so the navigation keys work again. (wyvern.red)
+"Reset path" is now also in the chat's own menu next to Blocked users, so you can force a fresh route without going through Contacts.

release-notes/beta_29.txt

@@ -0,0 +1,17 @@
+# beta_29 (TEST) — clock hardening for room servers, BLE repeats-heard fix, deeper SD chat history, one-screen popups. On top of beta_28.
+# One user-facing note per non-blank, non-# line; # lines are section comments.
+
+# --- Fixed ---
+Room logins can no longer be silently locked out by the device clock. Room servers quietly reject anything older than the newest timestamp they have seen from you, so a clock that stepped backwards (a reboot without GPS or phone around, or a sync correcting a fast clock) black-holed every Join with zero feedback. The device now remembers the newest timestamp it has used across reboots so it can never fall behind itself, a Join that gets no reply shows a clear error after 20 seconds (including what the device thinks the time is) instead of spinning forever, and the device warns you when its clock and the room server's clock disagree. Thanks to EricMW61 for the follow-up testing on issue #89.
+"Repeats heard" works again over Bluetooth. The companion app counts repeats from the per-packet RX log, which beta_23 stopped sending over BLE to fix congestion. The firmware now recognises packets that are repeats of your own messages and lets exactly those through to BLE, so the counter works and the congestion fix stays. Thanks to daryldakine for the clean bisect (issue #94).
+Messages sent from the phone app through the device now also appear on the device itself, as your own outgoing message in that channel. This worked for direct messages but never for channels.
+Deleting a chat or channel now sticks. Deleted messages could survive in storage and resurrect the chat later, and removing a channel could miss the underlying channel entry so the thread came right back.
+Settings pages no longer jump down when opened on keyboard-navigation devices, and the red update dot can no longer steal the selection from the About button.
+The update check no longer shows "couldn't reach the update server" for six hours after one failed attempt. It now waits for Wi-Fi to actually have an address and retries within a minute.
+The Tanmatsu About page now shows the real firmware version instead of a stale hardcoded one.
+
+# --- New ---
+Much deeper chat history on devices with an SD card: up to 5000 messages instead of 500, with date separators (Today, Yesterday, day names) between messages from different days. Note for testers: if you later downgrade below beta_29, the older build will not read the larger history file and will start with an empty history.
+Chat and channel rows in the messages tab now use the same compact style as the Contacts tab, fitting more conversations on screen.
+The chat or channel settings sheet (long-press or the gear) now fits on one screen, laid out like the contact menu, instead of scrolling.
+Compact chat mode is easier to read: messages alternate between two background tones.

release-notes/beta_30.txt

@@ -0,0 +1,11 @@
+# beta_30 (TEST) — the big-mesh sluggishness fix + a much faster Spectrum analyzer. On top of beta_29.
+# One user-facing note per non-blank, non-# line; # lines are section comments.
+
+# --- Fixed ---
+The periodic multi-second freezes on busy meshes are gone. Saving the contact list to storage took up to 3 seconds at ~570 contacts and ran on the UI thread every couple of minutes, which is exactly the trackball and touch hesitation people felt since beta_25. The save now writes the same data in a few large chunks instead of thousands of tiny ones, cutting it to a fraction. Thanks to guinnessbear for the report and Yazutsu for the precise measurements that pinned this down (issue #82).
+The Contacts tab no longer rebuilds itself every 60 seconds just to refresh the "heard 2h ago" labels - they update in place now. That rebuild cost over a second on large contact lists and could yank the list while you were scrolling.
+A burst of adverts can no longer queue several back-to-back Contacts rebuilds; they are now coalesced.
+
+# --- Improved ---
+The Spectrum analyzer feels live now: the waterfall gets a new line about four times per second instead of once per sweep, the trace advances across the band as it sweeps (like a bench analyzer), and a full sweep is about 20 percent faster.
+The Spectrum trace also scales itself to the signal now: the chart tracks the live minimum and maximum, jumping out instantly for a strong signal (no more clipping flat at the top) and easing back once it is gone.

release-notes/beta_31.txt

@@ -0,0 +1,9 @@
+# beta_31 (TEST) — the new chats tab: avatars, message previews, custom channel icons. On top of beta_30.
+# One user-facing note per non-blank, non-# line; # lines are section comments.
+
+# --- New ---
+The chats tab has a fresh look: each conversation now shows a round avatar in that chat's signature colour (the same colour its bubbles use) with the first two letters of the name, the last message previewed under the name, the time top right and the unread count below it. Compact chat mode keeps the dense single-line rows instead, so both styles are available.
+Channels can have a custom icon: open the channel's settings (long-press or the gear) and tap "Chat icon" to pick any emoji as its avatar. Long-press the same entry to go back to the automatic letters. The choice is remembered per channel.
+
+# --- Fixed ---
+Long chat names no longer wrap onto the message preview underneath.

release-notes/beta_32.txt

@@ -0,0 +1,9 @@
+# beta_32 (TEST) — the Wi-Fi freeze fix: a stale phone/web connection can no longer stall the device. On top of beta_31.
+# One user-facing note per non-blank, non-# line; # lines are section comments.
+
+# --- Fixed ---
+The 1-2 second freezes every ~10 seconds some users saw with Wi-Fi on are gone. When a phone app or web client was connected over Wi-Fi and that connection went stale (phone asleep, walked out of range), every received mesh packet made the device wait on the dead connection before the UI could continue. The device now only writes to a connection when it can accept data immediately, and a connection that stays unresponsive for 10 seconds straight is dropped so the client can reconnect cleanly.
+Saving chat history could briefly hitch the UI on busy meshes: the history file now writes in a few large chunks instead of thousands of tiny ones (the same treatment the contact list got in beta_30), and background saves are spaced further apart while messages stream in.
+
+# --- New ---
+The About page now shows recent loop stalls (anything over 0.2 seconds, newest first), so freeze reports can be confirmed or ruled out at a glance.

release-notes/beta_33.txt

@@ -0,0 +1,7 @@
+# beta_33 (TEST) — the MQTT freeze fix + the About page no longer stalls itself. On top of beta_32.
+# One user-facing note per non-blank, non-# line; # lines are section comments.
+
+# --- Fixed ---
+The freezes with MQTT enabled are gone. Connecting to the broker (DNS lookup, TCP connect, login) could block the device for 2-10 seconds and retried every 15 seconds while the broker was unreachable, all on the UI thread. Connection attempts now run fully in the background, and writes to a broker that stops responding are skipped instead of waited on (the same treatment beta_32 gave phone/web connections). Tip: if your bridge keeps reconnecting, check the broker address and credentials - a healthy connection does not retry.
+The About page caused a ~0.4 second hitch every second while it was open: computing the firmware image size checksums the whole ~3 MB app in flash and ran twice per refresh. It is now computed once per boot, so About (and its stall list) no longer disturbs the very measurements it shows.
+Favoriting a contact when the favorites list is full (16) now says "Favorites full (max 16)" instead of the incorrect "Removed from favorites".

release-notes/beta_34.txt

@@ -0,0 +1,11 @@
+# beta_34 (TEST) - buffered receive: the missed-messages fix, ON by default on this test build. On top of beta_33.
+# One user-facing note per non-blank, non-# line; # lines are section comments.
+
+# --- New ---
+This build changes how the device collects packets from the LoRa radio, and the new way is ON by default so the test channel can prove it. Background: the radio chip holds only one received packet at a time, and until now the firmware only collected it when the main loop got around to it, the same loop that draws the screen. If the interface kept the loop busy while two packets arrived back to back, the first one was silently overwritten. That is the "my device missed a message another device right next to it heard" problem some of you reported, and why it affected this firmware but not stock MeshCore, which has no screen to draw. A small dedicated background task now collects every packet within about a millisecond of it arriving, no matter what the interface is doing.
+Because the receive path is the heart of the device, this ships with a safety hatch: if you see anything odd with receiving, sending, or the Spectrum analyzer, turn off "Buffered receive (experimental)" in Settings > Radio & Mesh (applies instantly, no reboot) and you are back on the old path. Please report it either way, that is exactly what the test channel is for.
+The About page now shows LoRa receive counters (heard / read / late-lost). "late-lost" counts packets the radio heard but the firmware failed to collect in time. With buffered receive on it should stay at zero. If you turn the toggle off on a busy mesh you may watch it creep up, which is the old bug happening live.
+
+# --- Fixed ---
+Messages sent by wadamesh no longer carry a few stray bytes at the end that stock MeshCore devices and some companion apps displayed as garbage characters after the text (issue #13).
+A GPS module reporting a bogus date can no longer drag the device clock back to the year 1902 (core clock guard).

release-notes/beta_35.txt

@@ -0,0 +1,11 @@
+# beta_35 (TEST) - V4 breathing room: freezes fixed, 30 KB of internal RAM back, crash-safe settings. On top of beta_34.
+# One user-facing note per non-blank, non-# line; # lines are section comments.
+
+# --- Fixed ---
+Heltec V4: multi-second freezes right after receiving messages are gone, including the screen refusing to wake from dark mode. Saving chat history to the internal flash could stall the device for up to 6 seconds (the V4 has no SD card, and internal flash pauses for housekeeping); that save now runs on a background task, so the screen and touch stay responsive no matter what storage is doing.
+Turning Bluetooth on while Wi-Fi is running no longer reboots the device when memory is tight: the switch now checks free memory first and tells you "Not enough free memory for Bluetooth. Turn Wi-Fi off first." instead of crashing.
+The same protection applies the other way around: turning Wi-Fi on with Bluetooth active used to claim "Wi-Fi on" while the radio silently never started. It now either really starts or tells you why it cannot.
+Settings could vanish for a single boot after an unlucky reboot (the device came up with a default name once, then recovered). Settings writes are now crash-safe: a reboot or power cut at any moment leaves at least one intact copy on storage, the loader self-heals from it, and a failed save now says "Couldn't save the name to storage" instead of pretending it worked.
+
+# --- Improved ---
+About 30 KB of the ESP32's scarce internal RAM has been freed by moving buffers to the external PSRAM and dropping unused USB components from the build. This is the headroom that makes Wi-Fi and Bluetooth run together comfortably again, especially on the Heltec V4.

release-notes/beta_36.txt

@@ -0,0 +1,13 @@
+# beta_36 (TEST) - Launcher SD storage really works now, Wi-Fi settings redesign, symbol passwords, lock-screen unread count. On top of beta_35.
+# One user-facing note per non-blank, non-# line; # lines are section comments.
+
+# --- Fixed ---
+The "Store data on SD" toggle is now actually honored after a reboot (fix contributed by scratchdiver, PR #123). On Launcher installs the setting silently reverted to internal storage every boot, which also meant those devices kept the slow internal-flash writes. If you run wadamesh under the Launcher and your mesh is busy, this one is for you: flip the toggle once and contacts and settings really move to the SD card.
+Turning "Store data on SD" off works reliably now too, including on Launcher installs (follow-up to PR #123).
+Passwords with special characters can now be entered everywhere: long-press any settings field, including the Wi-Fi password, for the Cut / Copy / Paste / All / Sym menu. Sym opens a picker with the characters the on-screen keyboard does not have (issue #122). Double-tap selects a word.
+
+# --- New ---
+The Wi-Fi network screens (join a network, hidden network, saved-network details) are full-screen pages now instead of small popups: same style as the other settings pages, title in the top bar, tap the bar to go back, and everything scrolls properly with the keyboard open.
+The lock screen shows an envelope with the number of unread messages under the clock, so you can check for news without unlocking (idea from issue #93). It disappears when there is nothing unread.
+For Launcher installs: a "Save update bin to SD" button on the About page downloads the latest firmware of your selected channel into a BINS folder on the SD card, named with the version and channel, ready to flash from the Launcher. The test-builds toggle is now visible on Launcher installs as well.
+New region preset "Australia (Mid)": 915.075 MHz, 125 kHz, SF9, CR5 (requested in issue #121).

release-notes/beta_37.txt

@@ -0,0 +1,15 @@
+# beta_37 (TEST) - Tanmatsu ALT accents + language switching, GPS quick reply, T-Deck touch self-heal, SD history reliability. On top of beta_36.
+# One user-facing note per non-blank, non-# line; # lines are section comments.
+
+# --- New ---
+Tanmatsu: hold ALT and press a letter to open the accent picker (a with ALT gives an accent popup, just like long-press on the touch boards). Keep ALT held and press the letter again to cycle through the options; release ALT to insert the highlighted one. Requested by jochentj in issue #129.
+Tanmatsu: double-tap the space bar to switch between your enabled keyboard languages, same as on the T-Deck.
+Accented letters on the Tanmatsu now render at full size at the Large and Huge UI scales instead of noticeably smaller (issue #129). Made possible by moving all boards to compressed UI fonts, which also frees a chunk of firmware space.
+Your GPS position is now the first row in the quick-reply picker, so you can send your current coordinates with one tap (contributed by Yazutsu, PR #125).
+While in a chat or channel, the top bar shows the active keyboard language next to the clock (only when more than one layout is enabled), so you can see what double-tap-space switched to.
+
+# --- Fixed ---
+The keyboard-backlight "Off" preset now actually switches the backlight off and stays off, instead of leaving the previous mode running (contributed by Yazutsu, PR #88).
+Chat history saves to the SD card are more robust: files are written atomically and a fallback save path covers the background worker not being armed yet, so a badly timed reboot can no longer truncate your message history (contributed by scratchdiver, PR #135).
+T-Deck: if the touch controller glitches into a stuck "phantom finger" state (everything looked frozen, touch dead, trackball clicks eaten, and the screen never timed out), the driver now detects it and recovers within seconds. Previously only a full power cycle would clear it.
+T-Deck: touch initialisation at boot now retries for a few seconds instead of giving up after a single attempt. A slow-to-wake touch controller could previously cost you touch AND keyboard for the whole session.

release-notes/beta_38.txt

@@ -0,0 +1,17 @@
+# beta_38 (TEST) - Full-history chat scrolling, message delete, two new boards, storage integrity fixes. On top of beta_37.
+# One user-facing note per non-blank, non-# line; # lines are section comments.
+
+# --- New ---
+Chat scrolling is fully virtualized (contributed by scratchdiver, PR #130): a chat now scrolls through its ENTIRE stored history, up to 5000 messages on SD-card devices, smoothly in both bubble and compact mode, instead of only the most recent rows. Several LVGL crash fixes came along with it.
+Long-press any message for a new Delete option that removes just that message. The message menu now lays its buttons out two per row so it always fits on one screen.
+The chat and channel settings sheet gains "Delete history": wipes the whole conversation after a confirmation, while the channel membership or contact stays.
+The in-chat jump buttons are now slim arrows tucked against the right edge of the screen: fully visible while you scroll, fading to half opacity a second after you stop.
+ThinkNode M9 hardware support is complete (contributed by ded, PR #138): GPS, microSD, buzzer, backlight control, lock screen, long-press context menus, and a d-pad-driven setup wizard. His fixes for focus scrolling in nested pages and the lock-screen paint order benefit every keyboard-nav board.
+New board in the source tree: RAK WisMesh Tap V2 (contributed by Ethac.chen, PR #136), with a 30+ fps display driver. Prebuilt images follow once the web-flasher integration lands.
+Tanmatsu: the app now builds size-optimized, roughly 300 KB smaller, leaving real headroom under the launcher's app-size limit for future features.
+
+# --- Fixed ---
+Messages no longer vanish when you reboot the device from the phone app (reported by Leon P). The history writer batches saves up to 30 seconds apart, and the app's reboot command skipped the final save that every on-device reboot path does - so the newest messages, read or unread, were lost. The reboot command now saves first.
+T-Deck: turning on "Store data on SD" now migrates your existing profile, settings and identity to the card FIRST. Upgrading to beta_36/37 with the toggle already on could adopt an empty card and boot as a brand-new node while your real profile sat orphaned on internal flash.
+T-Deck: for anyone already hit by that: Set -> General -> "Copy internal data to SD" restores the profile from internal flash onto the card (confirmation, then automatic reboot). Until you run it, toggling "Store data on SD" OFF and rebooting also brings the old profile back.
+Tanmatsu: profile name, settings and the node identity now persist reliably across reboots. They lived on the internal flash partition whose metadata layer is unreliable on this board; they now live on the SD card with everything else, and existing data is rescued automatically on first boot.

release-notes/beta_39.txt

@@ -0,0 +1,11 @@
+# beta_39 (TEST) - Translations, deletes that stick and are fast, emoji fixes. On top of beta_38.
+# One user-facing note per non-blank, non-# line; # lines are section comments.
+
+# --- New ---
+Big translation pass: hundreds of previously-English strings across menus, settings, dialogs and the setup flow are now translated into all 11 non-English languages (Dutch, German, French, Spanish, Italian, Russian, Ukrainian, Bulgarian, Serbian, Greek, Brazilian Portuguese). Menu rows that carry an icon now translate too, instead of silently falling back to English. Switch language under Settings.
+ThinkNode M9 and RAK WisMesh Tap V2 can now be installed straight from the web flasher.
+
+# --- Fixed ---
+Deleting a message, or clearing a whole chat, now sticks: it survives a reboot or a hardware reset instead of coming back (reported by Leon P and MrWeavis). The delete used to sit in a save that was batched up to 30 seconds later, so a reset in that window undid it.
+Deleting is also much faster now. The chat history is written compactly - only the messages you actually have, instead of the full 5000-slot ring every time - so a delete, a history wipe, or a reboot no longer pauses the screen while it saves. Normal message saving is lighter too.
+Emoji picker: the food and object emoji that showed as empty boxes (umbrella, coffee, pizza, cake, rocket, camera, phone, laptop, calendar, antenna, e-mail, house, car, watch) now render properly - they were listed but never baked into the font.

release-notes/beta_40.txt

@@ -0,0 +1,32 @@
+# beta_40 (STABLE) - the first stable since beta_35. Rolls up everything from beta_36 through beta_40: reliable SD storage, message delete + full-history scrolling, a big translation pass, two new boards, and a pile of storage/perf/stability fixes.
+# One user-facing note per non-blank, non-# line; # lines are section comments.
+
+# --- New ---
+Big translation pass: hundreds of previously-English strings across menus, settings, dialogs and the setup flow are now translated into all 11 non-English languages (Dutch, German, French, Spanish, Italian, Russian, Ukrainian, Bulgarian, Serbian, Greek, Brazilian Portuguese). Menu rows that carry an icon translate too. Switch language under Settings.
+Chat scrolling is fully virtualized (contributed by scratchdiver, PR #130): a chat now scrolls through its ENTIRE stored history, up to 5000 messages on SD-card devices, smoothly in both bubble and compact mode, instead of only the most recent rows.
+Long-press any message for a Delete option that removes just that message; the message menu lays its buttons two per row so it fits on one screen.
+The chat and channel settings sheet gains "Delete history": wipes the whole conversation after a confirmation, while the channel membership or contact stays.
+The in-chat jump buttons are slim arrows tucked against the right edge: fully visible while you scroll, fading to half opacity a second after you stop.
+ThinkNode M9 hardware support is complete (contributed by ded, PR #138): GPS, microSD, buzzer, backlight control, lock screen, long-press context menus, and a d-pad-driven setup wizard. It can be installed straight from the web flasher.
+New board: RAK WisMesh Tap V2 (contributed by Ethac.chen, PR #136), with a 30+ fps display driver, also installable from the web flasher.
+The Wi-Fi network screens (join a network, hidden network, saved-network details) are full-screen pages now instead of small popups, matching the other settings pages and scrolling properly with the keyboard open.
+The lock screen shows an envelope with the number of unread messages under the clock, so you can check for news without unlocking (idea from issue #93).
+Passwords with special characters can be entered everywhere: long-press any settings field, including the Wi-Fi password, for a Cut / Copy / Paste / All / Sym menu. Sym opens a picker with the characters the on-screen keyboard lacks (issue #122). Double-tap selects a word.
+For Launcher installs: a "Save update bin to SD" button on the About page downloads the latest firmware of your selected channel into a BINS folder on the SD card, ready to flash from the Launcher. The test-builds toggle is visible on Launcher installs too.
+New region preset "Australia (Mid)": 915.075 MHz, 125 kHz, SF9, CR5 (requested in issue #121).
+Your GPS position is now the first row in the quick-reply picker, so you can send your current coordinates with one tap (contributed by Yazutsu, PR #125).
+Tanmatsu: hold ALT and press a letter to open the accent picker; keep ALT held and press again to cycle, release to insert (requested by jochentj, issue #129). Double-tap the space bar to switch between your enabled keyboard languages, same as the T-Deck.
+While in a chat, the top bar shows the active keyboard language next to the clock when more than one layout is enabled.
+
+# --- Fixed ---
+The "Store data on SD" toggle is now actually honored after a reboot (fix contributed by scratchdiver, PR #123). On Launcher installs it silently reverted to internal storage every boot, which also kept the slow internal-flash writes. Turning it off works reliably now too.
+Turning on "Store data on SD" migrates your existing profile, settings and identity to the card FIRST, so upgrading no longer risks adopting an empty card and booting as a brand-new node. If you were already hit by that, Settings -> General -> "Copy internal data to SD" restores the profile from internal flash.
+Card-less devices (Heltec V4, and any board without an SD card) no longer freeze for several seconds at a time. A busy mesh re-writes the whole contacts file to internal flash on every advert refresh, and that flash garbage-collection stalled the whole device; contact saves are now coalesced so only real changes (a new or removed node) are written promptly.
+Deleting a message, or clearing a whole chat, now sticks: it survives a reboot or a hardware reset instead of coming back (reported by Leon P and MrWeavis). Deleting is also much faster - chat history is written compactly, only the messages you actually have, so a delete, a history wipe, or a reboot no longer pauses the screen while it saves.
+Messages no longer vanish when you reboot the device from the phone app (reported by Leon P): the app's reboot command now saves chat history first, like every on-device reboot path already did.
+Chat history saves to the SD card are more robust: files are written atomically with a fallback save path, so a badly timed reboot can no longer truncate your message history (contributed by scratchdiver, PR #135).
+Longer translated labels (French, German, etc.) that used to clip or wrap now shrink to fit: the message action menu, confirmation dialogs, and the app-drawer tiles all keep their text on one line. The signal card's "tap for details" hint no longer overlaps in other languages.
+Emoji picker: the food and object emoji that showed as empty boxes (umbrella, coffee, pizza, cake, rocket, camera, phone, laptop, calendar, antenna, e-mail, house, car, watch) now render properly.
+Tanmatsu: profile name, settings and the node identity persist reliably across reboots (moved off the unreliable internal-flash partition onto the SD card, with existing data rescued on first boot). Accented letters render at full size at the Large and Huge UI scales. The About page shows the correct firmware version now.
+T-Deck: if the touch controller glitches into a stuck "phantom finger" state (touch dead, trackball clicks eaten, screen never timing out), the driver detects it and recovers within seconds instead of needing a full power cycle. Touch initialisation at boot also retries for a few seconds instead of giving up after one attempt.
+The keyboard-backlight "Off" preset now actually switches the backlight off and stays off (contributed by Yazutsu, PR #88).

release-notes/beta_41.txt

@@ -0,0 +1,10 @@
+# beta_41 (TEST) - experimental web control: view and drive the wadamesh UI from a phone or desktop browser over Wi-Fi. Two new apps, VNC and REMOTE.
+# One user-facing note per non-blank, non-# line; # lines are section comments.
+
+# --- New ---
+New VNC app (in the app drawer, between Advertise and Signal): it mirrors the live device screen into a web browser over Wi-Fi and lets you drive it. Taps and typing in the browser control the device, and anything that changes on the device shows up in the browser. Turn it on, then open http://<device-ip>:8765/ from any browser on the same network. The app page itself is scrollable.
+New REMOTE app: a headless mode that renders the whole UI at a larger, browser-friendly resolution and serves it over Wi-Fi, while the device's own screen drops to a placeholder showing the address to open. Meant for driving a device as a web client, and as groundwork for screenless hardware. Turning it on or off reboots the device. On the web page a Rotate button flips between landscape (desktop) and portrait (phone); on the device, double-tap the space bar to leave remote mode.
+Both features are served by the device itself over plain Wi-Fi - no phone app, no account, no cloud, just a browser on the same network.
+
+# --- Note ---
+This is an experimental first cut, and an honest heads-up from Kaj: for me the remote UI still feels too slow, and I will most likely move toward a dedicated, lighter remote client instead of streaming the entire live UI. It is in this test build mainly because community feedback on it would be genuinely useful - if you try it, let us know how it runs for you and what you would actually want from a web or remote client.

release-notes/beta_42.txt

@@ -0,0 +1,9 @@
+# beta_42 (TEST) - fixes for the beta_41 REMOTE mode: it works on the Heltec V4 now, and keyboard-less boards can leave it.
+# One user-facing note per non-blank, non-# line; # lines are section comments.
+
+# --- Fixed ---
+REMOTE mode now works on the Heltec V4 TFT (and other 2 MB-PSRAM boards) instead of showing a black screen in the browser. Its off-screen renderer needed more free memory than those boards had, so nothing was streamed; the buffers are sized to fit now, and the render is a bit smaller and faster as a result. VNC was never affected and already worked.
+Keyboard-less touch boards (Heltec V4, RAK WisMesh Tap) can leave REMOTE mode again: touch and hold the device screen for about 3 seconds. Those boards have no SPACE key, which used to be the only way out on the device.
+
+# --- New ---
+The web page has an "Exit remote" button (with a confirmation) that leaves REMOTE mode from any browser, on any board.

release-notes/beta_43.txt

@@ -0,0 +1,24 @@
+# beta_43 (TEST) - the browser control panel grows into a full remote app (Chats, Contacts, Discovered, Settings), plus a Heltec V4 map-tile fix.
+# One user-facing note per non-blank, non-# line; # lines are section comments.
+
+# --- New: web control panel ---
+The browser control panel is now a full remote app - you can run the device from your phone or laptop without ever picking up the T-Deck. Proper Chats, Contacts, Terminal and Settings tabs.
+Contacts tab: search, sort and filter your contacts, see each one's distance, coordinates and last-heard age, and tap a contact for the same actions you get on the device (favourite, block, reset path, remove).
+Discovered nodes show up in the browser too, each with a one-tap "Add" to save it as a contact - so you can build your whole contact list from the web app.
+Chats tab: pop-up notifications (with an optional beep) when a message arrives, and the open chat refreshes on its own as replies come in - no manual reload.
+Acknowledgements and repeats-heard now show for messages you send from the web app, the same as on the device.
+A Settings page for the everyday options that make sense remotely, including live radio changes.
+A quick-command button in the Terminal that drops common commands straight into the input box.
+
+# --- New: device ---
+Map options has a "Tile debug overlay" toggle (off by default) that shows a live read-out of the map-tile pipeline, for diagnosing tile problems.
+
+# --- Fixed ---
+Heltec V4: map tiles downloaded but only the top of the map rendered and the rest stayed black. The 2 MB-PSRAM V4 was running out of contiguous memory for the tile grid; tiles now reuse a small fixed pool and only load what is on screen, so the whole map fills in smoothly again.
+Heltec V4 in remote/VNC mode: typing from a physical keyboard in the browser now works (it previously only worked on the T-Deck).
+The remote-access screen on the device is clearer: the IP address is shown at the top, the explanation is shorter and more accurate, the toggles sit above it, and the address box only appears once remote access is on.
+The Terminal "help" command now lists every command, on both the device and the web terminal (it was missing a lot).
+
+# --- Changed ---
+The web app header now shows the same signal, Wi-Fi, Bluetooth and battery icons as the device status bar, and the title reads WADAMESH.
+The contact and chat sort/filter controls open a menu to pick an option instead of cycling through them on each tap.

release-notes/beta_44.txt

@@ -0,0 +1,15 @@
+# beta_44 (TEST) - an on-device text web browser, tappable links in chat, and a French-keyboard spacebar fix.
+# One user-facing note per non-blank, non-# line; # lines are section comments.
+
+# --- New: on-device web browser ---
+New "Web" app: open a URL and read the page as plain text - articles, wikis, docs, plain sites - right on the device. No proxy, no tracking, no JavaScript or images; just the words. Links are tappable, and there are back, forward and refresh buttons.
+The Web app needs the memory only the 8 MB boards have (T-Deck, Tanmatsu), so it is hidden on the 2 MB Heltec V4 - that board can't complete an on-device HTTPS handshake.
+
+# --- New: links in chat ---
+Links in a chat are now tappable. Tap one for a small menu: "Open in web" loads the page in the on-device browser, and "Create QR" shows a scannable QR code so you can open the link on your phone.
+Create QR works on every board, including the Heltec V4 - so even where the browser isn't available you can still bounce a link to your phone.
+
+# --- Fixed ---
+French (AZERTY) on-screen keyboard: the spacebar is back in the normal letter view (along with the OK and keyboard-switch keys). You no longer have to switch to the symbols page just to type a space.
+Heltec V4: web page fetching and map tiles are more resilient when memory is tight.
+Home signal & traffic box: the "tap for details" cue is back at the top of the box.

release-notes/beta_45.txt

@@ -0,0 +1,29 @@
+# beta_45 (STABLE) — everything since the last stable (beta_40): browser-based remote control, an on-device web browser, three new boards, and a batch of fixes.
+# One user-facing note per non-blank, non-# line; # lines are section comments.
+
+# --- New: control wadamesh from a browser (over Wi-Fi — no app, account or cloud) ---
+New web control panel: run the device from a phone or laptop browser over Wi-Fi, with full Chats, Contacts, Discovered, Terminal and Settings tabs — served by the device itself. Turn on the VNC app, then open http://<device-ip>:8765/ from any browser on the same network.
+VNC app: mirrors the live device screen into the browser and lets you drive it — taps and typing in the browser control the device, and anything that changes on the device shows up in the browser.
+REMOTE app: a headless mode that renders the whole UI at a larger, browser-friendly resolution over Wi-Fi while the device screen shows the address to open; a Rotate button flips between desktop (landscape) and phone (portrait) layouts.
+Web Contacts: search, sort and filter contacts, see each one's distance, coordinates and last-heard age, and get the same per-contact actions as on the device (favourite, block, reset path, remove). Discovered nodes appear too, each with a one-tap "Add".
+Web Chats: pop-up notifications (with an optional beep) when a message arrives, the open chat auto-refreshes as replies land, and acknowledgements + repeats-heard show for messages you send from the browser.
+
+# --- New: on-device web browser + links in chat ---
+New "Web" app (8 MB boards — T-Deck, Tanmatsu): open a URL and read the page as plain readable text — no proxy, tracking, JavaScript or images — with tappable links and back/forward/refresh.
+Links in a chat are now tappable: "Open in web" loads the page in the on-device browser, and "Create QR" shows a scannable QR to open the link on your phone (works on every board, including the Heltec V4).
+
+# --- New boards ---
+LilyGo T-LoRa Pager (ESP32-S3): a QWERTY-keyboard handheld with a rotary encoder and no touchscreen, fully driven from the keyboard + encoder; both radio variants (LR1121 and SX1262) supported. Contributed by @codemonkeybr (PR #149) — thank you!
+LilyGo T-Display P4 (ESP32-P4): an AMOLED touchscreen handheld. Early port ("partially supported") — LoRa mesh, chat, map, GPS and the phone-app companion over Wi-Fi/USB work; Bluetooth pairing isn't available on this board (stock radio-coprocessor limitation — pair over Wi-Fi or USB).
+Heltec WiFi LoRa 32 V4-R8 (8 MB PSRAM) with Expansion Kit V2 (microSD): "partially supported" while hardware testing finishes.
+
+# --- Fixed ---
+Heltec V4: map tiles now fill the whole map instead of only the top — the 2 MB-PSRAM V4 was running out of contiguous memory for the tile grid, so tiles now reuse a small fixed pool and only load what's on screen.
+Heltec V4-R8: fixed random hard-freezes that needed a reset (the touch controller was wedging the shared I2C bus).
+Tanmatsu and other keyboard-only boards: you can now select and edit the Wi-Fi name and password fields in Wi-Fi settings.
+T-Display P4: the clock sets itself over Wi-Fi even where NTP is blocked, and won't get stuck on a bad date from the hardware clock.
+French (AZERTY) on-screen keyboard: the spacebar is back in the normal letter view.
+REMOTE mode now works on the Heltec V4 TFT (and other 2 MB-PSRAM boards); keyboard-less boards can leave REMOTE by holding the screen ~3 s, and the web page has an "Exit remote" button.
+
+# --- Also ---
+The flasher site shows a support badge on every board (fully vs partially supported); hover it to see what works.

release-notes/beta_46.txt

@@ -0,0 +1,12 @@
+# beta_46 — control-center redesign, Do Not Disturb, contact safety + board fixes
+
+# New
+Redesigned control center: round quick-toggle buttons that spread to fill the panel, a frosted-glass look, real lock/bell icons, and a confirmation popup on every toggle.
+Do Not Disturb: set quiet hours in Settings > Sound to silence the incoming-message chime during a daily window, with a bell in the status bar while it's active. (community contribution by Tesso Codemonkey)
+Do Not Disturb quick-toggle in the control center — a bell that gains a slash while quiet hours are on.
+
+# Fixed
+Contacts no longer go missing between reboots on microSD devices: saves are now atomic (written then swapped in) and the card is mounted far more reliably at boot.
+Heltec V4-R8: the microSD card now mounts, and the freeze when waking the device from sleep is fixed.
+LilyGo T-Pager: the map no longer shows a "storage error" under the launcher — it caches tiles to the microSD card, like the T-Deck.
+Heltec V4 in portrait: the Bluetooth icon no longer overlaps the clock in the status bar, and the control-center buttons no longer clip when tapped.

release-notes/beta_47.txt

@@ -0,0 +1,17 @@
+# beta_47 — Discover app (find + map nearby nodes, wardriving), a new Attaky board, pager + P4 additions
+# One user-facing note per non-blank, non-# line; # lines are section comments.
+
+# New
+New Discover app: actively sweep for nearby nodes and list everything that answers — repeaters, companions and room servers — ranked by signal, with live RSSI/SNR, a "direct" badge for anything in RF range, and a last-heard age. It's in the app drawer (the ⟳ tile, next to Map).
+Tap any node in Discover to add it straight to your contacts — it keeps the right type (repeater, companion or room).
+Wardriving: with a GPS fix, Discover logs every node it hears against your position to a CSV on the SD card as you move, and plots your RF coverage on the map as a signal-coloured track (green = strong, red = weak) — a standalone, on-device coverage mapper, no phone needed.
+
+# New boards
+Attaky Core (ESP32-S3, 16 MB flash / 8 MB PSRAM): a new board, contributed by @attakygit (#158). Experimental — on the beta channel while it finishes hardware verification.
+LilyGo T-Display P4 (TFT-LCD screen variant): early support for the LCD screen model (the AMOLED variant was already supported). Experimental — if you have the LCD screen, grab the wadamesh-tdisplay-p4-lcd build from the release assets.
+
+# Fixed
+LilyGo T-LoRa Pager: the rotary encoder now keeps its focus inside the chat message list, and the composer navigation keys are remapped so moving around and typing a message no longer fight each other. (community contribution by @codemonkeybr, #162)
+
+# Boards
+T-Deck · Heltec V4 TFT · Heltec V4-R8 · ThinkNode M9 · RAK TAP v2 · T-LoRa Pager (LR1121 / SX1262) · Attaky Core · T-Display P4.

release-notes/beta_48.txt

@@ -0,0 +1,14 @@
+# beta_48 - stability and fixes: crash, boot-stuck, MQTT, message times, keyboard and more
+# One user-facing note per non-blank, non-# line; # lines are section comments.
+
+# Fixed
+Fixed a crash that could reboot the device while you were typing in a chat.
+Fixed devices getting stuck on the boot screen after an update when a microSD card is fitted. The boot-time copy of your data to the card could hang on a slow or damaged card; it is now guarded and the device always boots.
+MQTT bridge settings now save and survive a reboot. They were being written to the wrong storage and getting lost.
+Message times now match the clock at the top of the screen, instead of showing 1910 or other wrong dates.
+Dutch keyboard: the "1" and "!" keys were typing "ij" and "IJ". Fixed.
+The message box now stops you at the real send limit instead of quietly dropping the end of a long message when you send.
+Copy and paste no longer cuts off long text.
+The quick messages list now scrolls when there are more entries than fit on screen.
+Room server names that start with an unusual character no longer show an empty box on the Join screen.
+Tanmatsu: you can now reach every emoji in the picker, not just the first half.

release-notes/beta_49.txt

@@ -0,0 +1,13 @@
+# beta_49 - T-Display P4 only
+# One user-facing note per non-blank, non-# line; # lines are section comments.
+
+This beta only has T-Display P4 fixes. If you run any other board there is nothing new for you here, stay on beta_48.
+
+# Fixed (T-Display P4)
+The Snake game no longer traps you. Tap the top bar to leave it. Before, the only way out was a reset.
+The full-screen tools (Monitor, Spectrum, Discover, Web mirror, Advert) can now be left by tapping the top bar, so they no longer trap you either.
+The screen timeout now works. The display turns off after your idle time and wakes on touch. This also fixes standby and burn-in dimming.
+Text no longer overflows its boxes. The interface is pinned to the 100% size that fits the panel.
+GPS: the L76K module is now found reliably and read at 9600 baud. You still need the GPS antenna connected and a clear view of the sky to get a fix.
+The control center dropdown is taller so the GPS status line sits below the buttons instead of behind them.
+P4 LCD model only: fixed the black screen. The backlight now turns on. Please test and report.

release-notes/beta_50.txt

@@ -0,0 +1,13 @@
+# beta_50 - on-device updates for every board, plus pager and Attaky fixes
+# One user-facing note per non-blank, non-# line; # lines are section comments.
+
+# On-device updates
+Fixed the on-device updater downloading the wrong firmware on several boards. The V4-R8, ThinkNode M9, RAK Tap V2, T-LoRa Pager and Attaky now each pull their own build instead of the Heltec V4 TFT one.
+T-Display P4: the "Get test builds (beta)" toggle and the on-device update now appear. They were hidden before, so the P4 could only be updated over USB. Newly enabled, please test and report.
+
+# T-LoRa Pager (codemonkeybr)
+Lock screen fixed: tap Backspace to peek the screen without unlocking, hold Backspace to unlock. The clock and text are repositioned to fit the wide screen and stay readable.
+
+# Attaky Mesh Series (attakygit)
+On-screen keyboard now works with the detachable keyboard module: the keys stay down while the module is attached, and the module's # key brings them back up for symbols. The POWER button toggles the screen and wakes the board.
+Board fixes: correct LoRa clock (no false TCXO), GPS baud, and sensor probing that was colliding with the touch and keyboard chips.

release-notes/beta_51.txt

@@ -0,0 +1,14 @@
+# beta_51 - chat layout, an Airtime tool, and a lockscreen fix
+# One user-facing note per non-blank, non-# line; # lines are section comments.
+
+A community drop. Thanks to Yazutsu, scratchdiver and jacobpretorius.
+
+# Chat
+Message bubbles now show the time on the top row next to the sender, so more messages fit on screen. Applies to channels, DMs and room-server threads. (scratchdiver)
+
+# New: Airtime tool
+New Airtime tool in the Apps drawer measures how busy the LoRa channel really is, so you can check congestion instead of guessing. It shows channel use over time, packets lost at the radio, live signal and noise, the LoRa preset, and a plain verdict on whether congestion is likely. (jacobpretorius)
+
+# Fixed
+Lockscreen wallpaper no longer turns into coloured noise after you use the map. A custom JPG wallpaper could show garbage until a reboot. (Yazutsu, fixes #127)
+T-Display P4: the text size setting works again. It was stuck at 100% no matter what you picked.

release-notes/beta_52.txt

@@ -0,0 +1,13 @@
+# beta_52 - major SD chat-history storage rework (community) - RISKY, NEEDS TESTING
+# One user-facing note per non-blank, non-# line; # lines are section comments.
+
+WARNING - RISKY TEST BUILD. This beta reworks how chat history is stored on the SD card. It has NOT been tested over long uptime yet and may have data-loss bugs.
+WARNING - The chat-history format CHANGES and the change is ONE-WAY. If you flash an older firmware after running this, your saved chat history is lost. Back it up first if it matters to you.
+WARNING - Do not run this as your only or daily device unless you are OK risking your chat history. We specifically need people to run it for hours or days and report any SD errors or history-not-saving problems.
+
+# What changed
+Major SD storage rework, contributed by the community (Vybo): the device now recovers from an SD card that wedges or is pulled at runtime instead of needing a reboot; the About page shows chat-store health (backend, save time, failures); and chat history is now written as small append-friendly segment files instead of rewriting the whole file on every save.
+Fixed the follow-on bug where SD writes started failing after a few hours of uptime once the segment store's table filled up.
+
+# Everything from beta_51 is also included
+Chat bubbles show the time on the top row, the new Airtime channel-utilization tool, the lockscreen wallpaper corruption fix, and the T-Display P4 text-size fix.

release-notes/beta_53.txt

@@ -0,0 +1,36 @@
+# beta_53 - speed with a big chat history, blocking that actually works, T-Display P4 fixes
+# One user-facing note per non-blank, non-# line; # lines are section comments.
+
+# --- Read this first -------------------------------------------------------------------
+HEADS UP - chats now keep the newest 250 messages each by default. If you have a chat with more than that, the older ones are dropped the next time it receives a message. Change it or turn it off under Settings > Chats > "Keep per chat (messages)" BEFORE you let a busy channel run, if you want to keep a deep backlog.
+
+# --- Speed ----------------------------------------------------------------------------
+Fixed the big one: a large chat history no longer slows the whole interface down. With a busy channel the chat list was re-scanning the entire message store once for every chat, every time it refreshed - so the more history you had, the slower everything got. A device with 3800 messages in one channel was crawling. That work is now done once instead of once per chat.
+New setting: "Keep per chat (messages)" under Settings > Chats. Choose 100, 250, 500, 1000, 2000 or No limit. The default is 250. Older messages in a chat are dropped past the limit, which stops one busy channel filling the whole message store and starving your other chats of history.
+Turning the limit off asks you to confirm first, because an unlimited history is exactly what made things slow.
+
+# --- Blocking -------------------------------------------------------------------------
+Blocking someone now actually works. Three separate bugs: blocking a sender in a channel never saved properly so it did not stick, blocking a person inside a room server silenced the ENTIRE room instead of that one person, and blocked names were only filtered in channels so room posts still came through. Thanks to D-Melhede for reporting.
+Unblocking now fully clears a block. Blocks were stored in two places and only one was being removed, so someone could stay silently blocked after you unblocked them.
+
+# --- Chats ----------------------------------------------------------------------------
+Fixed the chat list preview showing an old message and never updating. It picked the "newest" message by timestamp, which goes wrong on a device whose clock restarts at boot - so a message from an earlier session could outrank everything new forever. It now uses the actual arrival order. Mostly seen on the T-Display P4.
+Notification sound works again. A failed map-tile fetch could leave an internal counter stuck, and that counter was silently muting every chime. Thanks to ropafiro for reporting (#184).
+
+# --- Stability + connection ------------------------------------------------------------
+Fixed multi-second freezes on Heltec V4 units in a busy mesh. Every advert heard was triggering a redundant write to internal flash, and contact saves were not rate-limited, so the interface could lock up for seconds at a time with nothing obviously happening. Thanks to Raph for the detailed report and video.
+Wi-Fi scanning no longer gets stuck off. If the connection dropped at the wrong moment the scan gate stayed shut for good; it now clears itself and re-enables auto-reconnect (#171).
+The phone app gets its replies again. Ping and telemetry responses could be swallowed before reaching the app (#124).
+Typing into the web control panel no longer drops characters. Thanks to VE2CCK for reporting.
+
+# --- Apps -----------------------------------------------------------------------------
+The Airtime and Snake apps now work like the Spectrum app: a proper "< back" title bar, and you can no longer accidentally tap or swipe through to the screen behind them. They also no longer risk a crash when closing.
+Swiping inside any full-screen app (Airtime, Spectrum, RF Monitor, Discover, Web, VNC, Remote) no longer jumps you to another tab.
+Fixed three older reports from dreirund: the crash-restart dialog text overlapping its buttons (#97), the settings sheet opened from "Discovered" being cut off (#109), and room servers now showing their own icon in the contacts list (#106).
+
+# --- T-Display P4 ----------------------------------------------------------------------
+The clock is fixed. The P4 showed the wrong time on screen while sent messages carried the correct one, and using "Sync clock from system" then broke the good clock too. Its real-time-clock chip was being set but the system clock never was.
+New: LoRa antenna setting under Settings > Radio. The on-board antenna is selected on every boot, and switching to the external socket asks you to confirm an antenna is actually connected first - transmitting into an empty connector can damage the radio.
+If sending has been much weaker than receiving on your P4, this is why: the firmware was transmitting on the on-board antenna while listening on the external one. Pick the antenna you actually have fitted.
+Reduced a source of the whole-screen flicker (#167) by keeping the display's working buffer off the shared memory bus. Please report whether you still see it.
+Text size and the control-centre layout fixes from earlier betas also apply.

release-notes/beta_54.txt

@@ -0,0 +1,19 @@
+# beta_54 - T-Display P4 screen flash fixed, P4 GPS fixed, Romanian, V4-R8 landscape rescue
+# One user-facing note per non-blank, non-# line; # lines are section comments.
+
+# --- T-Display P4 ----------------------------------------------------------------------
+The whole-screen blue flash (#167) is fixed. It was never the display: writing to the SD card delays the interrupt that restarts the screen's frame timer, and the panel shows the late frame as a flash. The fix moves your contacts, channels and chat history to fast internal storage - the SD card now carries only map tiles, backups and exports. Your data migrates across automatically on first boot; the card is not modified and everything on it stays as a backup.
+Because the card no longer holds your identity, swapping or removing the SD card can never again change who your node is or lose your contacts.
+GPS is really fixed this time: the firmware never actually read what the GPS module was saying (the sensor loop was missing on this board). It reads it now - fixes confirmed outdoors, and the T-Deck-style quick fix behaviour returns after the module has had sky time.
+The GPS settings page now shows live satellite info (in view, in use, signal strength) and updates while open, so "Searching" is no longer a black box.
+Storage writes now run on a dedicated background worker, so a big contact save cannot make the interface stutter.
+
+# --- Romanian (community) ---------------------------------------------------------------
+Romanian is the 13th interface language, with its own keyboard layout: ă on the home row, ş/ţ on the deck, â/î via the accent popups. Contributed by @jcyrio (#188, #189) - mulţumim!
+
+# --- Heltec V4-R8 -----------------------------------------------------------------------
+Fixed landscape mode registering every touch in the wrong place, which could leave the device stuck in landscape. The R8's screen sits rotated differently from the V4's, and the touch mapping assumed the V4. If you were stuck: this build boots back to portrait automatically.
+For safety the R8 returns to portrait on every boot for now; landscape can be re-tested from Settings and we will make it stick once a tester confirms the fix.
+
+# --- General ----------------------------------------------------------------------------
+The Airtime and Snake apps got a crash fix when closing.

release-notes/beta_55.txt

@@ -0,0 +1,17 @@
+# beta_55 - settings that stay put, fast SD boots, Pager text sizes, R8 sound
+# One user-facing note per non-blank, non-# line; # lines are section comments.
+
+# --- Reliability (community) -----------------------------------------------------------
+Settings can no longer silently reset themselves. An interrupted settings write could truncate the settings file - the sound toggle turning itself back on, the setup wizard reappearing, a mystery #unknown channel. Settings now save through paired snapshots with checksums, written in the background: a torn write can only lose the very last change, never your configuration. By @PixPMusic (#195, #196).
+Settings changes also no longer cause interface hitches - saves happen off the interface thread.
+Note if you downgrade after running this build: the older firmware reads the settings file which can be one save behind.
+Fixed the 3-minute boot with an SD card inserted (T-Deck, mostly Launcher installs). A card that woke up at a low speed kept that speed for the whole session, so contacts and history loaded at ~25 KB/s - and the file manager showed the card as 0KB/empty. The mount now raises the clock back to full speed after a slow wake, the standard way. Thanks to scsirob for the report and testing (#194).
+
+# --- T-Pager (community) ---------------------------------------------------------------
+New UI size presets for the T-Pager: Small (current look, default), Medium and Large - bigger text without pushing controls off the short screen, with encoder scrolling for tall content. By @PixPMusic (#197). Please try Medium/Large and report anything that clips.
+
+# --- Heltec V4-R8 -----------------------------------------------------------------------
+The buzzer works. The Expansion Kit V2's buzzer sat behind a driver chip whose wiring was unconfirmed, so it shipped disabled - R8 users have never heard a chime. Heltec's schematic settled it. If it is still silent on your kit, check the small SW1 switch on the expansion board: it is a hardware mute.
+
+# --- General ----------------------------------------------------------------------------
+Long-pressing the GPS tile in the control centre now opens the GPS settings page instead of the radio page.

release-notes/beta_56.txt

@@ -0,0 +1,13 @@
+# beta_56 - duty-cycle fix (important), Pager SD storage, issue-sweep fixes
+# One user-facing note per non-blank, non-# line; # lines are section comments.
+
+# --- Read this first -------------------------------------------------------------------
+IMPORTANT - if you ever picked a region preset, your radio was transmitting at roughly 9x the duty limit (about 91% instead of 10%). The preset math set the airtime limit 10x too loose; the home-screen meter showing "91% max duty cycle" was correctly reporting it (#161). This build fixes the presets AND automatically corrects devices whose settings exactly match a preset. If you tuned your airtime factor by hand, nothing is touched.
+
+# --- T-Pager ----------------------------------------------------------------------------
+The SD card is now actually used (#193). The card mounted and browsed fine but nothing stored to it - the storage feature was never enabled for this board. The Pager now gets the same "Store data on SD" option, boot storage selection and migration as the T-Deck.
+
+# --- Fixes across boards ----------------------------------------------------------------
+Message details now show the region scope for scoped direct messages, and no longer show "Scope 0000" for senders that carry the region in the alternate slot (#157).
+The Discover app keeps the last-heard time on screen with long node names - names are trimmed and node types shown as single letters (#191).
+The screen-unlock animation says WADAMESH instead of the old MESHCOMOD (#165).

release-notes/beta_57.txt

@@ -0,0 +1,20 @@
+# beta_57 - sends retry until heard, SD settings-save fix, Pager radio fix
+# One user-facing note per non-blank, non-# line; # lines are section comments.
+# Community beta: PixPMusic (storage + Pager) and mikecarper (send retry).
+
+# --- Sending --------------------------------------------------------------------------
+Sends now retry until the mesh has actually heard them. Until now a message was transmitted exactly once - if that one transmission collided or a repeater was mid-hop, it was gone while the app showed it as sent. The device now listens for its own message coming back (a repeater echo or the delivery ACK) and retransmits with a growing backoff until something confirms it was heard. Works for direct and flood sends, including sends from the phone app. Built by mikecarper (PR #207).
+New toggle under Settings > Radio & Mesh: "Retry sends until heard" (on by default) - turn it off if you want the old single-shot behaviour.
+
+# --- Storage --------------------------------------------------------------------------
+Saving settings on SD storage works again. On devices that keep their data on the SD card (T-Deck, V4-R8, Pager, Launcher installs) every settings save failed with "Couldn't save name to storage" - the commit step renamed a file onto itself, so it could never succeed. Found and fixed by PixPMusic (PR #211).
+Watchdog state is preserved around long SD and flash work instead of being blindly re-armed afterwards - removes a cause of spurious watchdog reboots (PixPMusic, PR #213).
+Settings reads no longer hand out pointers into a shared cache another task could invalidate mid-read (PixPMusic, PR #212).
+
+# --- Pager ----------------------------------------------------------------------------
+T-Lora Pager (SX1262): the radio oscillator is now driven at the 3.0 V LilyGo's own reference code uses, instead of a generic 1.6 V fallback. Weak transmissions and missing ACKs on this board came down to this - confirmed on hardware by PixPMusic (PR #209).
+
+# --- Fixes ----------------------------------------------------------------------------
+Discover no longer freezes when a node's name contains an emoji or a "#". A name cut mid-emoji broke the list's colour markup for every row after it, so the list looked frozen from that point on. Names are cleaned and escaped before display, here and in the message-info repeat list. Thanks to 4nuts for reporting with the exact culprit name (#223).
+Formatting an SD card on the V4-R8 or ThinkNode M9 no longer hangs forever. The Format button existed on both boards but the code doing the format was only compiled for the T-Deck, so the notice stayed up with nothing running behind it. Thanks to TrustYourTechnoLust (#172).
+Files app: Copy and Paste now work on every board - outside the T-Deck they showed the busy overlay forever for the same reason as the format hang.

release-notes/beta_58.txt

@@ -0,0 +1,16 @@
+# beta_58 - fixes the beta_57 upgrade bug (remote mode / frozen logo), Hungarian, auto-retry now opt-in
+# One user-facing note per non-blank, non-# line; # lines are section comments.
+
+# --- The beta_57 upgrade bug ----------------------------------------------------------
+Fixes the beta_57 update bug: updating from beta_56 corrupted part of the stored settings, booting devices into remote mode (screen frozen on the boot logo while the device kept running headless), switching on the map debug overlay, and quietly disabling a chat-history safety flush. A new settings field had been inserted in the middle of the stored layout instead of at the end, shifting every later value. Found, analysed and fixed by PixPMusic (#229, PR #230). Affected devices repair themselves on this update - a normal install, no erase needed.
+On devices that ran beta_57 the repaired settings (web panel, remote mode and its orientation, web terminal, map debug overlay, history flush tuning) return to their defaults - the old values could not be recovered. Everything else is preserved.
+
+# --- Sending --------------------------------------------------------------------------
+Auto-retry ("Retry sends until heard") is now OFF by default. Turn it on under Settings > Radio & Mesh if you want sends retried until the mesh confirms them - beta_57 enabled it for everyone, and that choice should be yours.
+
+# --- Language -------------------------------------------------------------------------
+Hungarian translation, contributed by pisti87 (PR #227). Existing language choices are preserved across the update. Köszönjük!
+
+# --- Fixes ----------------------------------------------------------------------------
+The lock screen finally says WADAMESH. The old MESHCOMOD was baked into the wallpaper image itself rather than the text, so the earlier branding fix missed it - both the built-in wallpaper and the copy seeded to storage are replaced (#228, thanks smhawkes).
+T-Display P4: profile export and backups work again. The writer still pointed at the storage system beta_54 retired, so every save failed with "can't open file" (#231, thanks D-Melhede).

scripts/build/add-emoji.py

@@ -26,6 +26,23 @@ SINGLE = [
     (0x26BD,  "26bd"),    # soccer ball   âš½
     (0x1F3C8, "1f3c8"),   # american football  ðŸ
     (0x1F5FF, "1f5ff"),   # moai  🗿
+    # objects/food listed in the picker (k_emoji_items) but never baked -> they
+    # rendered as the notdef box on-device (the beta_38 "emoji tofu"). Bake them.
+    (0x2614,  "2614"),    # umbrella with rain
+    (0x2615,  "2615"),    # hot beverage
+    (0x1F355, "1f355"),   # pizza
+    (0x1F382, "1f382"),   # birthday cake
+    (0x1F680, "1f680"),   # rocket
+    (0x1F4F7, "1f4f7"),   # camera
+    (0x1F4F1, "1f4f1"),   # mobile phone
+    (0x1F4BB, "1f4bb"),   # laptop
+    (0x1F310, "1f310"),   # globe with meridians (Web app icon)
+    (0x1F4C5, "1f4c5"),   # calendar
+    (0x1F4E1, "1f4e1"),   # satellite antenna
+    (0x1F4E7, "1f4e7"),   # e-mail
+    (0x1F3E0, "1f3e0"),   # house
+    (0x1F697, "1f697"),   # car
+    (0x231A,  "231a"),    # watch (sat between car + bulb in the picker, still tofu)
 ]
 # ZWJ sequences baked as ONE combined image, keyed on the lead codepoint, with the
 # trailing visible symbol(s) mapped to the zero-width glyph so the whole UTF-8

scripts/build/gen-flasher-meta.py

@@ -1,21 +1,27 @@
 #!/usr/bin/env python3
 # Generate the web-flasher metadata that must roll with every release:
-#   - version.json            : {tag, notes[]} — the site shows this ("what's new")
+#   - version.json            : {tag, channel, notes[]} — the site shows this ("what's new")
 #   - manifest-tdeck.json      : esp-web-tools manifest (its "version" drives the
 #   - manifest-heltec-v4-tft.json   install dialog, so it must equal the tag)
 #
-# These live next to the rolling bins at firmware.wadamesh.com/latest/, so the
-# flasher always reflects the current release without a site redeploy. The
-# manifests themselves point at the IMMUTABLE per-tag bins (see below) to dodge
-# the latest/*.bin 4h edge cache.
+# These live next to the rolling bins in a per-channel feed dir on
+# firmware.wadamesh.com (latest/ for stable, latest-beta/ for the test channel),
+# so the flasher always reflects the current release without a site redeploy. The
+# manifests themselves point at the IMMUTABLE per-tag bins (releases/TOUCH for
+# stable, releases/BETA for beta) to dodge the latest/*.bin 4h edge cache.
 #
-# Usage: gen-flasher-meta.py <tag> <outdir> [notes_file]
-#   notes_file: one note per non-empty line (plain text); optional.
+# Usage: gen-flasher-meta.py <tag> <outdir> [notes_file] [channel]
+#   notes_file: one note per non-empty line (plain text); optional ("" to skip).
+#   channel:    "stable" (default) or "beta" — picks the immutable archive dir
+#               (releases/TOUCH vs releases/BETA) the manifests point at, and is
+#               recorded in version.json so the site/flasher can label the channel.
 import sys, json, os
 
 tag = sys.argv[1]
 outdir = sys.argv[2]
-notes_file = sys.argv[3] if len(sys.argv) > 3 else None
+notes_file = sys.argv[3] if len(sys.argv) > 3 and sys.argv[3] else None
+channel = sys.argv[4] if len(sys.argv) > 4 else "stable"
+archive = "BETA" if channel == "beta" else "TOUCH"
 
 notes = []
 if notes_file and os.path.exists(notes_file):
@@ -24,29 +30,38 @@ if notes_file and os.path.exists(notes_file):
 os.makedirs(outdir, exist_ok=True)
 
 with open(os.path.join(outdir, "version.json"), "w") as f:
-    json.dump({"tag": tag, "notes": notes}, f, indent=2)
+    json.dump({"tag": tag, "channel": channel, "notes": notes}, f, indent=2)
 
+# manifest filename -> (display name, merged-bin filename, chipFamily).
+# chipFamily is ESP32-S3 for every board except the P4-class T-Display P4.
 BOARDS = {
-    "manifest-tdeck.json":         ("wadamesh — LilyGo T-Deck", "wadamesh-tdeck-merged.bin"),
-    "manifest-heltec-v4-tft.json": ("wadamesh — Heltec V4 TFT", "wadamesh-heltec-v4-tft-merged.bin"),
+    "manifest-tdeck.json":            ("wadamesh — LilyGo T-Deck", "wadamesh-tdeck-merged.bin", "ESP32-S3"),
+    "manifest-heltec-v4-tft.json":    ("wadamesh — Heltec V4 TFT", "wadamesh-heltec-v4-tft-merged.bin", "ESP32-S3"),
+    "manifest-thinknode-m9.json":     ("wadamesh — ThinkNode M9", "wadamesh-thinknode-m9-merged.bin", "ESP32-S3"),
+    "manifest-rak-tap-v2.json":       ("wadamesh — RAK WisMesh Tap V2", "wadamesh-rak-tap-v2-merged.bin", "ESP32-S3"),
+    "manifest-heltec-v4-r8-tft.json": ("wadamesh — Heltec V4-R8 (experimental)", "wadamesh-heltec-v4-r8-tft-merged.bin", "ESP32-S3"),
+    "manifest-tlora-pager-lr1121.json": ("wadamesh — LilyGo T-LoRa Pager (LR1121)", "wadamesh-tlora-pager-lr1121-merged.bin", "ESP32-S3"),
+    "manifest-tlora-pager-sx1262.json": ("wadamesh — LilyGo T-LoRa Pager (SX1262)", "wadamesh-tlora-pager-sx1262-merged.bin", "ESP32-S3"),
+    "manifest-attaky.json":           ("wadamesh — Attaky Core (experimental)", "wadamesh-attaky-merged.bin", "ESP32-S3"),
+    "manifest-tdisplay-p4.json":      ("wadamesh — LilyGo T-Display P4", "wadamesh-tdisplay-p4-merged.bin", "ESP32-P4"),
 }
-for fn, (name, binf) in BOARDS.items():
+for fn, (name, binf, chip) in BOARDS.items():
     manifest = {
-        "name": name,
+        "name": name + ("" if channel == "stable" else " (beta)"),
         "version": tag,
         "new_install_prompt_erase": True,
         "builds": [{
-            "chipFamily": "ESP32-S3",
-            # Point at the IMMUTABLE per-tag bin, NOT latest/. The latest/*.bin URLs
-            # are stable filenames cached 4h (max-age=14400) and overwritten in place,
-            # so for up to 4h after a release the flasher could hand out the PREVIOUS
-            # beta's bytes while version.json already advertised the new tag. The
-            # per-tag path is never overwritten, so its (24h) cache is always correct.
-            # The manifest itself is max-age=300, so this new path propagates in <=5min.
-            "parts": [{"path": f"https://firmware.wadamesh.com/releases/TOUCH/{tag}/{binf}", "offset": 0}],
+            "chipFamily": chip,
+            # Point at the IMMUTABLE per-tag bin, NOT the rolling feed bin. The feed
+            # *.bin URLs are stable filenames cached 4h and overwritten in place, so
+            # for up to 4h after a release the flasher could hand out the PREVIOUS
+            # build's bytes while version.json already advertised the new tag. The
+            # per-tag path is never overwritten, so its cache is always correct. The
+            # manifest itself is max-age=300, so the new path propagates in <=5min.
+            "parts": [{"path": f"https://firmware.wadamesh.com/releases/{archive}/{tag}/{binf}", "offset": 0}],
         }],
     }
     with open(os.path.join(outdir, fn), "w") as f:
         json.dump(manifest, f, indent=2)
 
-print(f"wrote version.json + 2 manifests for {tag} -> {outdir}  (notes: {len(notes)})")
+print(f"wrote version.json + {len(BOARDS)} manifests for {tag} ({channel}) -> {outdir}  (notes: {len(notes)})")

scripts/build/patch_radiolib_lr11x0.py

@@ -0,0 +1,52 @@
+# Patches the vendored RadioLib so LR11x0::config() tolerates old LR1110
+# transceiver firmware that predates DriveDiosInSleepMode (opcode 0x012A,
+# added in the 0x0308 firmware release). RadioLib >= 7.x sends it
+# unconditionally during begin(); older chip firmware answers CMD_PERR,
+# which turns an otherwise healthy radio.begin() into -706
+# (RADIOLIB_ERR_SPI_CMD_INVALID). Preproduction Elecrow ThinkNode M9 units
+# ship with such firmware (Meshtastic works on them only because it pins an
+# older RadioLib that doesn't send the command).
+#
+# The command is an optional nicety (stops DIO glitches in sleep mode), so
+# skipping it on old firmware is safe.
+#
+# Idempotent. Each PlatformIO env has its own libdeps copy, so this only
+# affects envs that list this script in extra_scripts (the M9 env).
+# NOTE: on a completely fresh checkout the first build may run before
+# RadioLib is downloaded - the script then warns and the patch lands on the
+# next build. Re-run `pio run` once if you see the warning.
+Import("env")
+import os
+
+MARKER = "wadamesh-lr1110-oldfw-patch"
+OLD = """  state = this->driveDiosInSleepMode(true);
+  RADIOLIB_ASSERT(state);"""
+NEW = """  state = this->driveDiosInSleepMode(true);
+  // wadamesh-lr1110-oldfw-patch: LR1110 transceiver FW older than 0x0308
+  // doesn't implement DriveDiosInSleepMode (0x012A) and answers CMD_PERR,
+  // which would abort init (-706) on an otherwise healthy radio. The command
+  // only stops DIO glitches in sleep mode - safe to skip on old firmware.
+  if(state == RADIOLIB_ERR_SPI_CMD_INVALID) {
+    RADIOLIB_DEBUG_BASIC_PRINTLN("DriveDiosInSleepMode unsupported (old LR11x0 FW), skipping");
+    state = RADIOLIB_ERR_NONE;
+  }
+  RADIOLIB_ASSERT(state);"""
+
+path = os.path.join(env.subst("$PROJECT_LIBDEPS_DIR"), env.subst("$PIOENV"),
+                    "RadioLib", "src", "modules", "LR11x0", "LR11x0.cpp")
+
+if not os.path.isfile(path):
+    print("[patch_radiolib_lr11x0] WARNING: %s not found (libdeps not fetched yet?)" % path)
+    print("[patch_radiolib_lr11x0] WARNING: RadioLib NOT patched - re-run the build once libdeps exist")
+else:
+    with open(path) as f:
+        src = f.read()
+    if MARKER in src:
+        print("[patch_radiolib_lr11x0] already patched")
+    elif OLD in src:
+        with open(path, "w") as f:
+            f.write(src.replace(OLD, NEW, 1))
+        print("[patch_radiolib_lr11x0] patched LR11x0::config() for old-FW tolerance")
+    else:
+        print("[patch_radiolib_lr11x0] WARNING: pattern not found - RadioLib version drift?")
+        print("[patch_radiolib_lr11x0] WARNING: check LR11x0::config() by hand, NOT patched")

scripts/doc/capture.py

@@ -0,0 +1,84 @@
+#!/usr/bin/env python3
+"""
+Documentation screenshot capture for the DOC_CAPTURE firmware build.
+
+Build the firmware with -DDOC_CAPTURE, flash it to the T-Deck, then run:
+
+    python3 scripts/doc/capture.py /dev/cu.usbmodemXXXX [outdir]
+
+The device waits for a 'G' byte, then walks every screen and streams each
+framebuffer over USB as a 16-bit BMP wrapped in <<<WMSHOT ...>>> / <<<WMEND>>>
+markers. This script sends 'G', reads each frame, and writes a PNG per screen
+(via macOS `sips`; falls back to leaving the .bmp if sips is unavailable).
+"""
+import sys, os, re, time, subprocess
+
+try:
+    import serial
+except ImportError:
+    sys.exit("pyserial not found. Try: /Library/Developer/CommandLineTools/usr/bin/python3 -m pip install pyserial")
+
+if len(sys.argv) < 2:
+    sys.exit("usage: capture.py <serial-port> [outdir]")
+port = sys.argv[1]
+outdir = sys.argv[2] if len(sys.argv) > 2 else "doc-shots"
+os.makedirs(outdir, exist_ok=True)
+
+ser = serial.Serial(port, 115200, timeout=2)
+print(f"listening on {port} -> {outdir}/")
+
+hdr_re = re.compile(rb"<<<WMSHOT name=(\S+) w=(\d+) h=(\d+) bytes=(\d+)>>>")
+
+def read_exact(n):
+    data = bytearray()
+    while len(data) < n:
+        chunk = ser.read(n - len(data))
+        if not chunk:
+            break
+        data += chunk
+    return bytes(data)
+
+count = 0
+started = False
+last_go = 0.0
+deadline = time.time() + 90        # give the device up to 90s to start
+while time.time() < deadline:
+    if not started and time.time() - last_go > 0.4:
+        ser.write(b"G")            # nudge the device to begin the tour
+        ser.flush()
+        last_go = time.time()
+    line = ser.readline()
+    if not line:
+        continue
+    if b"WMTOUR START" in line:
+        started = True
+        print("tour started")
+        continue
+    if b"WMTOUR END" in line:
+        print("tour ended")
+        break
+    m = hdr_re.search(line)
+    if not m:
+        continue
+    name = m.group(1).decode()
+    nbytes = int(m.group(4))
+    data = read_exact(nbytes)
+    if len(data) != nbytes:
+        print(f"  ! {name}: short read {len(data)}/{nbytes}")
+        continue
+    bmp = os.path.join(outdir, name + ".bmp")
+    png = os.path.join(outdir, name + ".png")
+    with open(bmp, "wb") as f:
+        f.write(data)
+    try:
+        subprocess.run(["sips", "-s", "format", "png", bmp, "--out", png],
+                       check=True, capture_output=True)
+        os.remove(bmp)
+        count += 1
+        print(f"  [{count:2d}] {name}.png  ({nbytes} bytes)")
+    except Exception as e:
+        count += 1
+        print(f"  [{count:2d}] {name}.bmp  ({nbytes} bytes; sips convert failed: {e})")
+
+ser.close()
+print(f"done: {count} screenshots in {outdir}/")