diff --git a/docs/UI_DESIGN.md b/docs/UI_DESIGN.md
index ace40bd..298f2d2 100644
--- a/docs/UI_DESIGN.md
+++ b/docs/UI_DESIGN.md
@@ -11,7 +11,10 @@ launch by `Telegram.WebApp.initData` — the SDK's `themeParams` override the to
runtime; on that path without sign-in data (no `initData` — outside Telegram, or a Mini App
launch that delivered none, as seen on some Android clients) the app renders a compact,
shareable launch-diagnostic screen (`screens/TelegramLaunchError.svelte`) rather than
-redirecting to the site root.
+redirecting to the site root. `telegram-web-app.js` is loaded **dynamically with a timeout**,
+only on a Telegram entry — not a render-blocking `
+
{
const prefs = await loadPrefs();
app.theme = prefs.theme ?? 'auto';
@@ -584,6 +592,13 @@ export async function bootstrap(): Promise {
window.visualViewport.addEventListener('scroll', syncViewportHeight);
}
+ // Load the Telegram Mini App SDK dynamically, with a timeout, on a Telegram entry — it is no
+ // longer a render-blocking