51 lines
2.3 KiB
Markdown
51 lines
2.3 KiB
Markdown
# 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. |
|