v3.1.0
hexgrad/kokorov3.1.0May 26, 2026by wingkwong
AI Summary
Introduces comprehensive localization for Chinese users, enhances the design system with accessible soft foreground tokens and shared scrollbars, and improves accessibility features like link underlines and RTL support.
Key Highlights
- Chinese localization for docs and localized demos
- Accessible soft foreground tokens with vibrant palette
- Shared scrollbar utilities
- Improved RTL support for components
- Fixes for useTheme SSR and focus behavior
New Features
- Chinese React docs and localized demos
- Accessible soft foreground tokens with vibrant palette
- Shared scrollbar utilities with data-scrollbar attributes
- Link underline appears on hover
- Better RTL support for Table, pickers, ListBox and Menu items
Full Release Notes
## What's inside - 🌐 Chinese React docs, release notes & localized demos - 🎨 Accessible soft foreground tokens with a vibrant palette opt-in - 📜 Shared scrollbar utilities with data-scrollbar="thin" | "default" | "none" - 🔗 Link underline now appears on hover, with pressed-state decoration updates - ⌨️ Toast tab order cleanup and height measurement fixes - 🧭 Better RTL support for Table, pickers, ListBox and Menu items - 🔧 Fixes for useTheme SSR, Fieldset disabled propagation, overlays, Modal and Dialog focus behavior ## What's Changed * feat(docs): SEO improvements, blog content rebalancing, and AI discoverability by @jrgarciadev in https://github.com/heroui-inc/heroui/pull/6536 * chore(.github): revise bug_report template content by @wingkwong in https://github.com/heroui-inc/heroui/pull/6539 * fix(styles): define calculated theme tokens on .dark for nested dark regions by @wingkwong in https://github.com/heroui-inc/heroui/pull/6542 * fix(demo): update Google and Apple icons in login demo by @diegonzs in https://github.com/heroui-inc/heroui/pull/6543 * fix(docs): Add missing variant props in Modal example by @DarkstarXDD in https://github.com/heroui-inc/heroui/pull/6464 * chore(docs): add missing init cmd options & add agents-md content by @wingkwong in https://github.com/heroui-inc/heroui/pull/6541 * feat(docs): wire HeroUI Native Universal Links and download fallback by @vvv-sss in https://github.com/heroui-inc/heroui/pull/6540 * fix(fieldset): forward disabled state to descendant fields by @wingkwong in https://github.com/heroui-inc/heroui/pull/6547 * feat(styles): add soft foreground tokens and migrate components by @jrgarciadev in https://github.com/heroui-inc/heroui/pull/6548 * feat(styles): add shared scrollbar system with per-component utilities by @diegonzs in https://github.com/heroui-inc/heroui/pull/6545 * docs(native-showcase): add privacy policy page by @vvv-sss in https://github.com/heroui-inc/heroui/pull/6551 * Agent readiness features by @jrgarciadev in https://github.com/heroui-inc/heroui/pull/6553 * fix(docs): sync home iframe demo themes by @jrgarciadev in https://github.com/heroui-inc/heroui/pull/6554 * fix(docs): use white accent for uber dark theme by @jrgarciadev in https://github.com/heroui-inc/heroui/pull/6556 * fix(docs): move mobile design theme selector to header by @jrgarciadev in https://github.com/heroui-inc/heroui/pull/6555 * fix(styles): prevent body focus ring clipping by @jrgarciadev in https://github.com/heroui-inc/heroui/pull/6557 * fix(styles): prevent overlay placement miscalculation during enter animation by @Emiyaaaaa in https://github.com/heroui-inc/heroui/pull/6549 * fix(styles): prevent Dialog from being programmatically scrolled by focus by @anobaka in https://github.com/heroui-inc/heroui/pull/6448 * fix(table): use logical border-radius for RTL corners by @FZ1010 in https://github.com/heroui-inc/heroui/pull/6568 * fix(toast): move tabindex from style object to HTML attribute by @aosmcleod in https://github.com/heroui-inc/heroui/pull/6510 * fix(toast): clean up stale toastHeights entries when toasts are dismissed by @aosmcleod in https://github.com/heroui-inc/heroui/pull/6512 * fix(hooks): resolve useTheme SSR crash and circular dependency by @aosmcleod in https://github.com/heroui-inc/heroui/pull/6561 * fix(docs): correct NumberField "With Chevrons" demo layout by @wingkwong in https://github.com/heroui-inc/heroui/pull/6569 * feat(docs): support i18n and add cn pages by @wingkwong in https://github.com/heroui-inc/heroui/pull/6533 * fix(link): update underline hover states by @jrgarciadev in https://github.com/heroui-inc/heroui/pull/6570 * chore(docs): sync with PR6570 by @wingkwong in https://github.com/heroui-inc/heroui/pull/6571 * fix(style): use logical inline-end/start for chevrons, value text and indicators by @FZ1010 in https://github.com/heroui-inc/heroui/pull/6573 * V3.1.0 by @jrgarciadev in https://github.com/heroui-inc/heroui/pull/6576 ## New Contributors * @DarkstarXDD made their first contribution in https://github.com/heroui-inc/heroui/pull/6464 * @Emiyaaaaa made their first contribution in https://github.com/heroui-inc/heroui/pull/6549 * @anobaka made their first contribution in https://github.com/heroui-inc/heroui/pull/6448 * @FZ1010 made their first contribution in https://github.com/heroui-inc/heroui/pull/6568 ## Full Release Note https://heroui.com/docs/react/releases/v3-1-0 **Full Changelog**: https://github.com/heroui-inc/heroui/compare/v3.0.5...v3.1.0