nick-doc/09 - Audits/Task 5.4 Telegram Mini App Shell Implementation.md

title, tags, created, status

title	tags	created	status
Task 5.4 Telegram Mini App Shell Implementation	taskmaster telegram mini-app frontend	2026-05-24	partial-foundation

Task 5.4 Telegram Mini App Shell Implementation

This document captures the first frontend implementation pass for the Telegram Mini App surface.

Implemented foundation

• Added /telegram route.
• Added src/utils/telegram-webapp.ts for safe Telegram WebApp context parsing.
• Added TelegramMiniAppShell with three first-pass states:
  • unsupported browser context,
  • Telegram detected but unlinked,
  • Telegram detected and authenticated web user present.
• Added basic marketplace/escrow action cards for requests, request creation, payment/escrow, chat, and account.
• Added Telegram chrome attachment helper for MainButton, BackButton, and haptic feedback when available.
• Added safe-area and Telegram theme helpers.

Tests

• frontend/__tests__/utils-test/telegram-webapp.test.ts
• frontend/__tests__/sections/telegram/telegram-mini-app-shell.test.tsx

Coverage includes standard browser fallback, Telegram context parsing, safe-area/theme fallback, start parameter parsing, unsupported state, unlinked state, and linked state rendering.

Remaining work

• Wire Mini App shell to backend Telegram session endpoints.
• Add request/offer/payment/dispute data loading inside the Mini App route.
• Add upload and dispute action surfaces that call canonical backend APIs.
• Add Telegram BackButton routing behavior once final navigation stack is known.
• Add client matrix QA across iOS, Android, Desktop, and Web Telegram clients.