docs: sync FUNCTIONAL/UI_DESIGN/.claude with the shipped VK + landscape behaviour (#140-#142 follow-up) #145

Merged

developer merged 2 commits from fix/vk-docs-deeplink-and-pan into development 2026-06-30 06:07:37 +00:00

Conversation 3 Commits 2 Files Changed 4

+25 -7

developer commented 2026-06-30 05:51:39 +00:00

Owner

Copy Link

Copy Source

Documentation catch-up from verifying PRs #139-#142 — code changes whose doc edits did not land alongside them.

#142 (VK) — invite link + theme + safe-area

• FUNCTIONAL (+_ru) claimed a friend invitation is shareable as a Telegram or VK deep link "that opens it directly". False on VK: vkShareLink emits a plain vk.com/app<id> link (VK forwards no payload to the Mini App), so the recipient enters the copied code by hand. #142 pivoted off the earlier #f<code> plan (commit d76f1f4); the code Go-doc + .claude/vk-games-integration.md already reflect the plain link, FUNCTIONAL kept the old wording.
• FUNCTIONAL (+_ru) VK paragraph + UI_DESIGN gain the auto-theme-follows-VK-client (VKWebAppUpdateConfig) and home-bar safe-area behaviour (CSS env() max'd with the VK bridge insets VKWebAppUpdateInsets, needed on Android) — parity with the documented Telegram integration.
• .claude/vk-games-integration.md corrected: it said the home bar was handled by env() alone; the code also reads the VK bridge insets.

#141 (landscape UI)

• UI_DESIGN omitted the desktop / landscape-iframe mouse drag-to-pan of the zoomed board (touch scrolls the overflow:auto viewport natively; a mouse cannot, so an explicit drag-to-pan handler moves it). The rack-tile / two-step-zoom fixes restore already-documented behaviour; the block-label string is i18n-only.

Docs only — no code, no wire/behaviour change.

Documentation catch-up from verifying PRs #139-#142 — code changes whose doc edits did not land alongside them. **#142 (VK) — invite link + theme + safe-area** - FUNCTIONAL (+_ru) claimed a friend invitation is shareable as a Telegram *or VK* deep link "that opens it directly". False on VK: `vkShareLink` emits a plain `vk.com/app<id>` link (VK forwards no payload to the Mini App), so the recipient enters the **copied code by hand**. #142 pivoted off the earlier `#f<code>` plan (commit d76f1f4); the code Go-doc + `.claude/vk-games-integration.md` already reflect the plain link, FUNCTIONAL kept the old wording. - FUNCTIONAL (+_ru) VK paragraph + UI_DESIGN gain the **auto-theme-follows-VK-client** (`VKWebAppUpdateConfig`) and **home-bar safe-area** behaviour (CSS `env()` max'd with the VK bridge insets `VKWebAppUpdateInsets`, needed on Android) — parity with the documented Telegram integration. - `.claude/vk-games-integration.md` corrected: it said the home bar was handled by `env()` alone; the code also reads the VK bridge insets. **#141 (landscape UI)** - UI_DESIGN omitted the desktop / landscape-iframe **mouse drag-to-pan** of the zoomed board (touch scrolls the `overflow:auto` viewport natively; a mouse cannot, so an explicit drag-to-pan handler moves it). The rack-tile / two-step-zoom fixes restore already-documented behaviour; the block-label string is i18n-only. Docs only — no code, no wire/behaviour change.

developer added 1 commit 2026-06-30 05:51:39 +00:00

docs: correct VK invite-link reality + note desktop board drag-to-pan ... 4a6fe318be

Two doc edits that did not land alongside their code:

- FUNCTIONAL (+_ru) claimed a friend invitation is shareable as a Telegram
  *or VK* deep link "that opens it directly". On VK that is false: vkShareLink
  emits a plain vk.com/app<id> link (VK forwards no payload to the Mini App),
  so the recipient enters the copied code by hand (#142, commit d76f1f4 pivoted
  off the earlier #f<code> plan; the doc kept the old wording).
- UI_DESIGN omitted the desktop / landscape-iframe mouse drag-to-pan of the
  zoomed board added in #141 (touch scrolls the viewport natively; a mouse
  cannot, so an explicit drag-to-pan handler moves it).

owner approved these changes 2026-06-30 05:54:31 +00:00

Dismissed

developer added 1 commit 2026-06-30 06:05:47 +00:00

docs: sync VK theme-follow + home-bar safe-area into FUNCTIONAL/UI_DESIGN/.claude ... 373aa2aa6d

The #142 polish shipped three VK behaviours the docs never picked up (they were
written for the #140 auth MVP):

- the "auto" theme follows the VK client light/dark (VKWebAppUpdateConfig), not
  the VK webview's prefers-color-scheme;
- the layout clears the VK mobile home bar via CSS env() max'd with the VK bridge
  insets (VKWebAppUpdateInsets) — the bridge value is needed on Android, where the
  VK webview exposes no env() inset (.claude said env() handled it alone);
- share/copy route through the bridge (VKWebAppShare/VKWebAppCopyText).

FUNCTIONAL (+_ru) VK paragraph gains theme+home-bar parity with the Telegram one;
UI_DESIGN gets a VK-integration note beside the Telegram one.

developer dismissed owner's review 2026-06-30 06:05:47 +00:00

Reason:

New commits pushed, approval review dismissed automatically according to repository settings

owner approved these changes 2026-06-30 06:06:10 +00:00

Dismissed

developer changed title from docs: correct VK invite-link reality + note desktop board drag-to-pan to docs: sync FUNCTIONAL/UI_DESIGN/.claude with the shipped VK + landscape behaviour (#140-#142 follow-up) 2026-06-30 06:06:15 +00:00

owner approved these changes 2026-06-30 06:06:32 +00:00

developer merged commit d1ceccf033 into development 2026-06-30 06:07:37 +00:00

developer deleted branch fix/vk-docs-deeplink-and-pan 2026-06-30 06:07:37 +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#145