release: v1.4.1 — Telegram nav (windowed, own back button, debug panel) #129

Merged

developer merged 7 commits from development into master 2026-06-23 13:27:31 +00:00

Conversation 1 Commits 7 Files Changed 8

+156 -166

developer commented 2026-06-23 13:17:23 +00:00

Owner

Copy Link

Copy Source

Promote development → master for the v1.4.1 release.

Highlights — Telegram Mini App navigation (after on-device testing on Pixel 10 / Android 17 + iOS)

• Own back chevron on every platform (Header). The native Telegram BackButton is dropped — it does not render in the windowed Mini App (backVisible=false on iOS and Android), so relying on it lost back navigation (iOS had none).
• No more immersive fullscreen — requestFullscreen removed. It hid the native header (and its BackButton) and the Android system swipe-back minimised the app. The app uses expand() (bot full-size / max-height) only.
• No closing-confirmation guard — move drafts auto-save, so the generic "changes may not be saved" prompt on closing the board was pure noise.
• Hidden debug panel (components/DebugPanel) — ten quick taps on the header title open a privacy-safe client diagnostic snapshot (app version, locale, online, userId, Telegram chrome / viewport / SDK state — no secrets, no IP) with Share; a tap anywhere except Share dismisses it. A support aid for client-specific issues.

Telegram exposes no native non-modal notification API (only modal showPopup/showAlert), so in-app toasts stay ours.

Carries #128. Tests: 321 unit + full e2e green; CI green on development (#544). Docs: UI_DESIGN.md.

Promote `development` → `master` for the **v1.4.1** release. ## Highlights — Telegram Mini App navigation (after on-device testing on Pixel 10 / Android 17 + iOS) - **Own back chevron on every platform** (Header). The native Telegram BackButton is dropped — it does not render in the windowed Mini App (`backVisible=false` on iOS and Android), so relying on it lost back navigation (iOS had none). - **No more immersive fullscreen** — `requestFullscreen` removed. It hid the native header (and its BackButton) and the Android system swipe-back minimised the app. The app uses `expand()` (bot full-size / max-height) only. - **No closing-confirmation guard** — move drafts auto-save, so the generic "changes may not be saved" prompt on closing the board was pure noise. - **Hidden debug panel** (`components/DebugPanel`) — ten quick taps on the header title open a privacy-safe client diagnostic snapshot (app version, locale, online, userId, Telegram chrome / viewport / SDK state — no secrets, no IP) with **Share**; a tap anywhere except Share dismisses it. A support aid for client-specific issues. Telegram exposes no native non-modal notification API (only modal `showPopup`/`showAlert`), so in-app toasts stay ours. Carries #128. Tests: **321** unit + full e2e green; CI green on `development` (#544). Docs: `UI_DESIGN.md`.

developer added 7 commits 2026-06-23 13:17:24 +00:00

fix(ui): Android Telegram nav — windowed mode, no close guard ... 6aa5023b24

Three Android Mini App issues, all in the Telegram chrome:

- Entering a game showed no native back button, and the Android system
  swipe-back minimised the app instead of navigating. Root cause: immersive
  fullscreen (requestFullscreen). On Android, fullscreen replaces the native
  header — and its BackButton, which also captures the system back — with a bare
  close/menu pill, so back navigation has no control to land on. Request
  fullscreen on iOS only; Android stays windowed, keeping the native header +
  BackButton (and the system swipe-back that routes to it). iOS is unchanged.

- Closing the game board always prompted "changes that you made may not be
  saved", even on a board just opened and untouched. The close-confirmation was
  armed unconditionally on game mount. Remove it entirely: move drafts auto-save
  (debounced during play + flushed on destroy), so nothing is lost on close.

Drops the now-unused telegramClosingConfirmation + isMobilePlatform helpers and
their SDK interface fields. Docs: UI_DESIGN.md.

chore(ui): TEMP lobby diagnostic for the Android fullscreen issue ... 79766438a2

Renders Telegram viewport/fullscreen state (isFullscreen, isExpanded, viewport
heights, innerH vs screenH, safe-area insets) in the lobby, inside Telegram
only, to diagnose why the app still opens fullscreen on Android with
requestFullscreen now iOS-only and no persisted state (fresh TG + test account).
REVERT before merge.

chore(ui): TEMP disable fullscreen for testing + Android back chevron + BackButton diag ... 6f00c2f41d

WIP for the Android nav investigation (TEMP bits reverted before merge):
- telegramRequestFullscreen: temporarily a no-op (incl. iOS) so the owner can
  confirm the Android "fullscreen look" is Telegram's own Mini App presentation,
  not our requestFullscreen (isFullscreen is already false on Android).
- Header: show the app's own back chevron in Telegram on Android, where the
  native BackButton does not render — a reliable tap-back. [keep]
- Diagnostic overlay moved app-wide (pointer-events:none) and now reports
  BackButton state (req/present/visible) + viewport geometry, to see whether the
  native BackButton can capture the Android system swipe-back.

test(ui): TEMP-skip the iOS fullscreen unit test (requestFullscreen is a no-op for the owner test; restore with the iOS path) 93c57b3558

fix(ui): own back chevron in Telegram on all platforms; drop the native BackButton ... 53d6883ffd

The Telegram native BackButton does not render in the windowed Mini App (the
owner's emulator + a fresh beta TG report backVisible=false on both iOS and
Android), so relying on it lost back navigation — iOS had no back affordance at
all. Show the app's own back chevron whenever there is a back target, on every
platform (Header showBack = !!back), and drop the now-dead native BackButton
effect (App.svelte). The native close control stays — a windowed Mini App
cannot hide it (no Telegram API).

WIP: the temp lobby diagnostic overlay and the requestFullscreen no-op remain
for the owner's emulator test; finalize after confirmation.

feat(ui): drop Telegram fullscreen; own back chevron everywhere; hidden debug panel ... 37070c3cb7

Finalises the Telegram Mini App navigation work after on-device testing (Pixel
10 / Android 17 + iOS, fresh beta clients):

- Remove requestFullscreen entirely. Immersive fullscreen hid Telegram's native
  header (and its BackButton) and the Android system swipe-back minimised the
  app; the owner prefers the windowed full-size (expand) presentation, so the
  app never requests fullscreen on any platform now.
- The app's own back chevron (Header, showBack = !!back) drives back-navigation
  on every platform; the native Telegram BackButton is dropped — it does not
  render in the windowed Mini App (backVisible=false on iOS and Android), so
  relying on it lost back navigation (notably none on iOS).
- Replace the temporary always-on diagnostic overlay with a hidden debug panel
  (components/DebugPanel): ten quick taps on the header title open it; it shows a
  privacy-safe client diagnostic snapshot (app version, locale, online, userId,
  Telegram chrome / viewport / SDK state — no secrets, no IP) and shares it via
  the OS share sheet / clipboard; a tap anywhere except Share dismisses it.
- Drop the now-dead telegramRequestFullscreen / telegramBackButton /
  isTelegramAndroid helpers and the iOS-fullscreen unit test.

Telegram has no native non-modal notification API (only modal showPopup /
showAlert), so in-app toasts stay ours. Docs: UI_DESIGN.md.

Merge pull request 'fix(ui): Android Telegram nav — windowed mode, no close guard' (#128) from feature/telegram-android-nav-fixes into development e6277dcd43

owner approved these changes 2026-06-23 13:27:06 +00:00

developer merged commit f1b8769c89 into master 2026-06-23 13:27:31 +00:00

Sign in to join this conversation.

Reviewers

No Reviewers

owner

Labels

No items

No Label

Milestone

No items

No Milestone

Projects

Clear projects

No project

Assignees

Clear assignees

owner (Ilia) developer

No Assignees

2 Participants

Notifications

Subscribe

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: developer/scrabble-game#129