tai/research/tui-framework-design/mini-apps-docs-theming.md

Mini Apps SDK docs — theming samples and re-read discipline

Metadata

Field	Value
Institute	Molodetz Institute — Research & Retrieval Division
Subject	tui-framework-design
Document type	Source Dossier
Tier	1
Source title	Theming documentation (Telegram Mini Apps SDK docs)
Source URL	https://docs.telegram-mini-apps.com/platform/theming
Source publisher / author	Telegram Mini Apps community (docs.telegram-mini-apps.com, over the official protocol)
Source type	vendor docs
Source date (published)	Unknown — not stated
Date researched	2026-10-11
Researched by	tai (agent), model: Muse Spark, on behalf of retoor
Research method	direct page fetch
Confidence	Medium
Status	Active

Summary

Community SDK documentation for Mini App theming: representative dark-theme sample values for the core ThemeParams keys plus accent, section-header, and destructive samples, and the hard rule to never hardcode colors and always re-read theme parameters on change.

Key findings

• Dark-theme samples: bg_color #17212b, text_color #f5f5f5, hint_color #708499, link_color #6ab3f3, button_color #5288c1.
• Further dark samples: accent_text_color #6ab2f2, section_header_text_color #6ab3f3, destructive_text_color #ec3942.
• Apps must never hardcode colors and must never cache them without refresh: re-read theme parameters and color scheme on every themeChanged event.

Pros / strengths

• The only concrete sample values found for the ThemeParams keys, and they agree with the Desktop night theme file (#17212b, #f5f5f5).
• The re-read discipline is stated as a hard rule, not advice, which settles tai's switch contract.

Cons / limitations / caveats

• Dark samples only: exact default light-theme hexes for the section_*, subtitle, and destructive keys are not published officially (open gap).
• Community docs; samples are representative values from a user-themeable system, not constants to bake in.

Relevance to tai

Provides the dark defaults for tai's Telegram-derived theme roles and the never-hardcode/re-read-on-switch rule that set_theme plus full repaint already implements in spirit.

Changelog

Date	Change
2026-10-11	Initial dossier created.