43 lines
1.6 KiB
Markdown
43 lines
1.6 KiB
Markdown
---
|
|
title: Task 5.4 Telegram Mini App Shell Implementation
|
|
tags: [taskmaster, telegram, mini-app, frontend]
|
|
created: 2026-05-24
|
|
status: 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.
|