MicrosoftDocs · SuzanneTocco · May 27, 2026 · May 28, 2026 · May 28, 2026 · May 28, 2026
diff --git a/msteams-platform/TOC.yml b/msteams-platform/TOC.yml
@@ -877,6 +877,17 @@
       - name: Use dialogs from bots
         href: task-modules-and-cards/task-modules/task-modules-bots.md
         displayName: create dialogue box, invoke dialog, submit action 
+  - name: Build HTML widgets
+    items:
+    - name: Overview
+      href: html-widgets/integrate-web-apps-overview.md
-      href: html-widgets/integrate-web-apps-overview.md
+      href: html-widgets/overview.md
-      href: html-widgets/integrate-web-apps-overview.md
+      href: html-widgets/overview.md
+      displayName: widgets
+    - name: User experience guidelines
+      href: html-widgets/user-experience-guidelines.md
+      displayName: widgets
+    - name: Accessibility guidelines
+      href: html-widgets/accessibility-guidelines.md
+      displayName: widgets, WCAG, MCP apps, iframe, assistive, ARIA, fluent, screen reader, contrast
   - name: Integrate with Teams
     items:
     - name: Web app integration

diff --git a/msteams-platform/html-widgets/accessibility-guidelines.md b/msteams-platform/html-widgets/accessibility-guidelines.md
diff --git a/msteams-platform/html-widgets/images/ThemeModes.png b/msteams-platform/html-widgets/images/ThemeModes.png
diff --git a/msteams-platform/html-widgets/images/borderRadiusStyles.png b/msteams-platform/html-widgets/images/borderRadiusStyles.png
diff --git a/msteams-platform/html-widgets/images/borderShapeExamples.png b/msteams-platform/html-widgets/images/borderShapeExamples.png
diff --git a/msteams-platform/html-widgets/images/cardAnatomy.png b/msteams-platform/html-widgets/images/cardAnatomy.png
diff --git a/msteams-platform/html-widgets/images/container_accent.png b/msteams-platform/html-widgets/images/container_accent.png
diff --git a/msteams-platform/html-widgets/images/container_attention.png b/msteams-platform/html-widgets/images/container_attention.png
diff --git a/msteams-platform/html-widgets/images/container_default.png b/msteams-platform/html-widgets/images/container_default.png
diff --git a/msteams-platform/html-widgets/images/container_emphasis.png b/msteams-platform/html-widgets/images/container_emphasis.png
diff --git a/msteams-platform/html-widgets/images/container_gallery.png b/msteams-platform/html-widgets/images/container_gallery.png
diff --git a/msteams-platform/html-widgets/images/container_good.png b/msteams-platform/html-widgets/images/container_good.png
diff --git a/msteams-platform/html-widgets/images/container_warning.png b/msteams-platform/html-widgets/images/container_warning.png
diff --git a/msteams-platform/html-widgets/images/expanded_surface.png b/msteams-platform/html-widgets/images/expanded_surface.png
diff --git a/msteams-platform/html-widgets/images/icon-arrow.png b/msteams-platform/html-widgets/images/icon-arrow.png
diff --git a/msteams-platform/html-widgets/images/icon-arrowUp.png b/msteams-platform/html-widgets/images/icon-arrowUp.png
diff --git a/msteams-platform/html-widgets/images/icon-button.png b/msteams-platform/html-widgets/images/icon-button.png
diff --git a/msteams-platform/html-widgets/images/icon-conversastion-bubble.png b/msteams-platform/html-widgets/images/icon-conversastion-bubble.png
diff --git a/msteams-platform/html-widgets/images/icon-magnifyingGlass.png b/msteams-platform/html-widgets/images/icon-magnifyingGlass.png
diff --git a/msteams-platform/html-widgets/images/icon-mouse.png b/msteams-platform/html-widgets/images/icon-mouse.png
diff --git a/msteams-platform/html-widgets/images/icon-puzzle.png b/msteams-platform/html-widgets/images/icon-puzzle.png
diff --git a/msteams-platform/html-widgets/images/icon-shield.png b/msteams-platform/html-widgets/images/icon-shield.png
diff --git a/msteams-platform/html-widgets/images/icon_colorBrush.png b/msteams-platform/html-widgets/images/icon_colorBrush.png
diff --git a/msteams-platform/html-widgets/images/icon_icon.png b/msteams-platform/html-widgets/images/icon_icon.png
diff --git a/msteams-platform/html-widgets/images/icon_shapes.png b/msteams-platform/html-widgets/images/icon_shapes.png
diff --git a/msteams-platform/html-widgets/images/icon_spacing.png b/msteams-platform/html-widgets/images/icon_spacing.png
diff --git a/msteams-platform/html-widgets/images/icon_text.png b/msteams-platform/html-widgets/images/icon_text.png
diff --git a/msteams-platform/html-widgets/images/icons.png b/msteams-platform/html-widgets/images/icons.png
diff --git a/msteams-platform/html-widgets/images/icontext.png b/msteams-platform/html-widgets/images/icontext.png
diff --git a/msteams-platform/html-widgets/images/input_examples.png b/msteams-platform/html-widgets/images/input_examples.png
diff --git a/msteams-platform/html-widgets/images/progressiveDisclosure.png b/msteams-platform/html-widgets/images/progressiveDisclosure.png
diff --git a/msteams-platform/html-widgets/images/responsive.png b/msteams-platform/html-widgets/images/responsive.png
diff --git a/msteams-platform/html-widgets/images/spacing.png b/msteams-platform/html-widgets/images/spacing.png
diff --git a/msteams-platform/html-widgets/images/textColorExamples.png b/msteams-platform/html-widgets/images/textColorExamples.png
diff --git a/msteams-platform/html-widgets/images/textColor_accent.png b/msteams-platform/html-widgets/images/textColor_accent.png
diff --git a/msteams-platform/html-widgets/images/textColor_attention.png b/msteams-platform/html-widgets/images/textColor_attention.png
diff --git a/msteams-platform/html-widgets/images/textColor_dark.png b/msteams-platform/html-widgets/images/textColor_dark.png
diff --git a/msteams-platform/html-widgets/images/textColor_default.png b/msteams-platform/html-widgets/images/textColor_default.png
diff --git a/msteams-platform/html-widgets/images/textColor_good.png b/msteams-platform/html-widgets/images/textColor_good.png
diff --git a/msteams-platform/html-widgets/images/textColor_light.png b/msteams-platform/html-widgets/images/textColor_light.png
diff --git a/msteams-platform/html-widgets/images/textColor_subtle.png b/msteams-platform/html-widgets/images/textColor_subtle.png
diff --git a/msteams-platform/html-widgets/images/textColor_warning.png b/msteams-platform/html-widgets/images/textColor_warning.png
diff --git a/msteams-platform/html-widgets/images/themes.png b/msteams-platform/html-widgets/images/themes.png
diff --git a/msteams-platform/html-widgets/images/typography.png b/msteams-platform/html-widgets/images/typography.png
diff --git a/msteams-platform/html-widgets/overview.md b/msteams-platform/html-widgets/overview.md
@@ -0,0 +1,9 @@
+---
+title: TODO
+author: SuzanneTocco
+description: TODO
+ms.topic: article
+ms.date: 05/27/2026
+---
+
+TODO
diff --git a/msteams-platform/html-widgets/playground.md b/msteams-platform/html-widgets/playground.md
diff --git a/msteams-platform/html-widgets/ux-guidelines.md b/msteams-platform/html-widgets/ux-guidelines.md