Theme icon animation

[faydesignsstuff]

Documentation changes

Brief description of what's being updated

Closes

---

For Reviewers

When reviewing documentation PRs, please consider:

✅ Technical accuracy

• Code examples work as written
• Commands and configurations are correct
• Links resolve to the right destinations
• Prerequisites and requirements are accurate

✅ Clarity and completeness

• Instructions are clear and easy to follow
• Steps are in logical order
• Nothing important is missing
• Examples help illustrate the concepts

✅ User experience

• A new user could follow these docs successfully
• Common gotchas or edge cases are addressed
• Error messages or troubleshooting guidance is helpful

---

Note

Low Risk
Docs playground UI only; no auth, data, or API changes.

Overview
Adds an animated light/dark theme icon on the assistant widget playground toolbar. Toggling preview theme (or when docs site dark mode changes) applies theme-icon--dark, which rotates the ring and flips the fill via CSS transforms over 0.5s; motion is disabled under prefers-reduced-motion.

The icon is inlined in the toolbar button instead of a nested ThemeIcon component so React keeps stable DOM nodes and transitions can run. docsIsDark state tracks document.documentElement class changes through the existing theme MutationObserver, and isPreviewDark drives the icon class and simplified theme toggle logic.

^{Reviewed by Cursor Bugbot for commit ec81958. Bugbot is set up for automated code reviews on this repo. Configure here.}

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated (UTC)
mintlify	🟢 Ready	View Preview	Aug 3, 2026, 4:12 PM

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated (UTC)
tomee	🟢 Ready	View Preview	Aug 3, 2026, 4:12 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

[cursor]

Cursor Bugbot has reviewed your changes using default effort and found 1 potential issue.

There are 2 total unresolved issues (including 1 from previous review).

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit f230f81. Configure here.}