# v1.0.1 **Category**: native **URL**: https://heroui.com/en/docs/native/releases/v1-0-1 **Source**: https://raw.githubusercontent.com/heroui-inc/heroui/refs/heads/v3/apps/docs/content/docs/en/native/releases/v1-0-1.mdx > Toast race condition fix, disabled state styling with disabled modifier, backdrop style variable ***
April 1, 2026
HeroUI Native v1.0.1 is a patch release focused on reliability and developer experience. It resolves a race condition in the Toast provider that caused stale animation values, corrects disabled-state styling across seven components to use the native `disabled:` modifier, and introduces a new `--backdrop` theme variable for overlay components. ## Installation Update to the latest version: ```bash npm i heroui-native ``` ``` bash pnpm add heroui-native ``` ```bash yarn add heroui-native ``` ```bash bun add heroui-native ``` **Using AI assistants?** Simply prompt "Hey Cursor, update HeroUI Native to the latest version" and your AI assistant will automatically compare versions and apply the necessary changes. Learn more about the [HeroUI Native MCP Server](/docs/native/getting-started/mcp-server). ## Try It on Your Device ## API Enhancements ### `--backdrop` Theme Variable A new `--backdrop` top-level style variable has been added to the theme system, providing a dedicated color token for the dimming layer behind overlay components such as Dialog and Bottom Sheet. The default value is `oklch(0% 0 0 / 20%)` for a subtle but visible backdrop effect. **New capability:** ```tsx import { Dialog } from "heroui-native"; // Dialog and Bottom Sheet overlays now use bg-backdrop automatically {/* Content renders over the themed backdrop */} ``` The `--backdrop` variable is included in all built-in themes for both light and dark modes, and the corresponding `bg-backdrop` Tailwind utility is available for use in custom component styles. **Related PR:** [#366](https://github.com/heroui-inc/heroui-native/pull/366) ## Style Fixes ### Disabled State Modifier Updated disabled-state styling across seven components to use the `disabled:` modifier prefix instead of applying styles unconditionally. This ensures disabled styles (`opacity-disabled`, `pointer-events-none`) are only applied when the component is in an actual disabled state, respecting the native `disabled` modifier from Uniwind. **Affected components:** - [Button](/docs/native/components/button) - [Checkbox](/docs/native/components/checkbox) - [Input](/docs/native/components/input) - [Menu](/docs/native/components/menu) - [Switch](/docs/native/components/switch) - [Tabs](/docs/native/components/tabs) - [TagGroup](/docs/native/components/tag-group) All `isDisabled` variant classes now use the `disabled:` modifier prefix (e.g., `disabled:opacity-disabled disabled:pointer-events-none`), ensuring proper scoping to the disabled pseudo-state and eliminating styling conflicts when the disabled state is toggled dynamically. **Related PR:** [#361](https://github.com/heroui-inc/heroui-native/pull/361) ## Bug Fixes This release includes fixes for the following issues: - **[Issue #359](https://github.com/heroui-inc/heroui-native/issues/359)**: Fixed a race condition in the Toast provider where the `total` SharedValue could drift out of sync with the actual toast count. The manual increment/decrement approach was prone to stale-closure mismatches when `hide` and `show` ran in the same tick or when auto-dismiss raced with a manual hide. The `total` value is now derived from `toasts.length` via a `useEffect`, ensuring animated interpolations (opacity, scale, translateY) always reflect the real toast count. - **[Issue #356](https://github.com/heroui-inc/heroui-native/issues/356)**: Resolved disabled-state styles being applied unconditionally when `isDisabled` was true, preventing developers from theming or customizing the disabled appearance. All seven affected components now use the `disabled:` modifier prefix, correctly scoping styles to the disabled pseudo-state. **Related PRs:** - [#360](https://github.com/heroui-inc/heroui-native/pull/360) - [#361](https://github.com/heroui-inc/heroui-native/pull/361) ## Updated Documentation The following documentation pages have been updated to reflect the changes in this release: - [Colors](/docs/native/getting-started/colors) - Added the new `--backdrop` variable to the color reference - [Theming](/docs/native/getting-started/theming) - Updated theming guide with the new `--backdrop` variable documentation ## Links - [Component Documentation](../components) - [GitHub Repository](https://github.com/heroui-inc/heroui-native) ## Contributors Thanks to everyone who contributed to this release!