> ## Documentation Index
> Fetch the complete documentation index at: https://docs.uniwind.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Changelog

> Latest updates and improvements to Uniwind Pro

> [card] [Try Uniwind Pro Demo](https://github.com/uni-stack/uniwind-pro-demo)
>
> See the C++ engine, ShadowTree updates, Reanimated animations, and native transitions in action. Clone the demo app (Uniwind Pro v1.6.0, Expo SDK 56 / RN 0.85.3) and run it on your iOS simulator. No account required.

**November 5, 2026**

1.9.2

## Uniwind Pro 1.9.2

* **React Native 0.89 support** - Added compatibility with React Native 0.89, including apps that build every library with `RN_STRICT_API` (`RN_STRICT_API=1 pod install` or Gradle `strictCxxApiEnabled=true`). React Native headers are now included through their `<React/...>` umbrellas when they exist, so React Native 0.83 - 0.88 build exactly as before. See [Compatibility](https://docs.uniwind.dev/pro/compatibility.md)
* **Nitro Modules upgrade** - Updated to `react-native-nitro-modules` 0.37.2, which is now the minimum supported version. See [Compatibility](https://docs.uniwind.dev/pro/compatibility.md)
* **Native trace spans** - Each step of a theme change, from the Shadow Tree update and commit to the style patch, native updates and the cleanup of unmounted views, now also shows up as a `Uniwind::<name>` slice in Perfetto / systrace on Android and as a signpost in Instruments on iOS, next to React Native's own slices. The `Uniwind` track in React Native DevTools is unchanged
* **RTL matches `I18nManager.isRTL`** - The `rtl:` / `ltr:` variants now use React Native's own RTL check on both platforms, so they always agree with `I18nManager.isRTL`. Before, Uniwind ignored `I18nManager.allowRTL(false)`, Android's `android:supportsRtl` and RTL languages the app ships no iOS localization for, so `rtl:` classes could apply while React Native laid the app out left to right
* **Multiple surfaces fix** - Apps with several surfaces now get theme changes on every surface, and each surface's commit applies only its own views. Before, a commit on another surface during a theme change crashed in Reanimated's commit hook on React Native 0.85+ and threw an error on older versions
* **Faster interactions after a theme change** - A theme change no longer keeps its pending commit until the next React commit, which cloned every themed view a second time and added 1 to 26 ms on the JS thread before the next render
* **Modal theming on React Native 0.86+ fix** - From React Native 0.86, `Modal` passes its `style` to a container View inside the native modal host. Theme changes now update that container, so an open modal no longer keeps the old theme, and padding or borders from its `className` no longer push the content inward
* **OS theme changes on Android fix** - Uniwind now applies OS appearance changes right away from `onConfigurationChanged`. It used to re-read the app's resources 25 ms after the configuration broadcast, which was sometimes too early, so the change was lost, and always later than React Native's own appearance event, so React could commit old theme styles over it
* **`setTheme` before the first render fix** - Runtime changes sent by native before the first Uniwind component renders are no longer lost. A `Uniwind.setTheme` called that early made `useUniwind()` report the new theme while every `className` kept the old one, and the safe area insets of an Android app started with the screen off never updated
* **Stale theme after a slow mount fix** - Uniwind now drops unmounted views by checking them against the latest React commit instead of the last mounted tree. Rows registered while a slow mount was in progress were dropped by mistake and kept the old theme on every later theme change
* **Window resize during a style update fix** - A rotation, window resize or fold that lands during a theme, `className` or state change no longer leaves the layout at the old size. The new size constraints were kept since 1.9.0, but React Native skipped the relayout
* **Text clipping on React Native 0.85+ fix** - A plain `Text` now gets React Native's default `overflow: hidden`, the same as a `Text` with `onPress` or nested text, so glyphs no longer draw over borders or outside a `borderRadius`
* **Metro rebuild loop with a linked Uniwind fix** - When Uniwind is linked (a workspace package, `npm link` or a `file:` install), development entries no longer require the generated `uniwind.css`. Metro no longer rebuilds the entry an extra time at startup, and two Metro servers with different theme lists no longer rewrite the file for each other in an endless loop
* **Fewer false theme transition warnings** - The `Theme transition was cancelled` warning in development now appears only for a `setTheme` call that found no registered views right after views were unmounted

**October 28, 2026**

1.9.1

## Uniwind Pro 1.9.1

* **Faster scrolling in long lists** - Uniwind now scans the Shadow Tree for unmounted views only after the number of registered views has doubled since the last scan, instead of after every commit that can remove views. Long `FlatList`s that mount and unmount rows on every scroll batch no longer pay for this scan on every batch
* **Faster theme changes** - Views that share the same `className`, state, data attributes and scoped theme now get one resolved style per theme change, so a theme change crosses JSI once per unique style instead of once per view
* **Single-frame theme changes without a transition** - `setTheme` with `ThemeTransitionPreset.None` now shows JS re-renders, the Shadow Tree commit, native updates and the appearance change in the same frame, so no partly themed frame appears in between
* **Uniwind track in React Native DevTools** - In development on React Native 0.86+, the Performance panel of React Native DevTools now has a `Uniwind` track that shows how long each part of a theme change takes, from notifying listeners and updating the Shadow Tree to applying native updates. Tracing costs nothing when DevTools is not recording
* **Faster `ScopedVariables` on Android** - The cache key for `ScopedVariables` is no longer sorted with `localeCompare`, which creates a Java collator on every call on Hermes for Android. On low-end Android devices, building it for 60 variables went from about 10 ms to 0.4 ms
* **Faster `ScopedVariables` on web** - On web, `ScopedVariables` no longer writes unchanged variables again on every render, and lookups of matching CSS rules are cached
* **React Native 0.89 readiness** - The C++ layer now builds against React Native 0.89 (`main`), and code paths for React Native versions below 0.83 were removed. The `react-native` peer dependency is now `>= 0.83.0`, matching the [Compatibility](https://docs.uniwind.dev/pro/compatibility.md) table
* **`setTheme` freeze fix** - `setTheme` no longer blocks the JS thread on a synchronous wait for the main thread, which could deadlock the app when the main thread was itself waiting on the JS runtime
* **iOS system theme on multi-screen devices fix** - The OS color scheme is now read from the app's window scene instead of the main screen, so adaptive themes follow the OS appearance on devices with more than one screen, such as iPhone Duo
* **`rotate-x` / `rotate-y` / `rotate-z` fix** - 3D rotate utilities keep their angle in native transforms
* **Tailwind import options fix** - Theme generation now works when `global.css` imports Tailwind with options like `source()`, `prefix()` or `theme()`
* **`useUniwind` with React Compiler fix** - `useUniwind` now returns the current theme after `Uniwind.setTheme` when Uniwind's source is compiled by React Compiler, for example a workspace-linked copy or a compiler `sources` option that includes `node_modules`

**October 19, 2026**

1.9.0

## Uniwind Pro 1.9.0

* **Expo SDK 58 support** - Added compatibility with Expo SDK 58. See [Compatibility](https://docs.uniwind.dev/pro/compatibility.md)
* **CSS cascade order on native** - Conflicting utilities now resolve the way they do in the browser: by `!important`, cascade layer, selector specificity and CSS source order, regardless of the order of classes in `className`. Important declarations keep their importance after conversion to React Native styles. See [Style Specificity](https://docs.uniwind.dev/style-specificity.md)
* **Height media queries** - Media queries on `height` now work on native, including `min-height` / `max-height`, ranges like `(300px <= height < 500px)`, and conditions combined with `width`, `orientation` or platform. Styles update when the screen size changes. See [Height Media Queries](https://docs.uniwind.dev/breakpoints.md#height-media-queries)
* **Exact media query bounds** - Width and height comparisons (`>`, `>=`, `<`, `<=`, `=`) are evaluated exactly, fractional bounds like `390.1px` no longer drift, and nested media blocks and comma-separated queries keep their logic. Unsupported conditions, including negated ones like `not-hover:`, are ignored while the rest of the query still applies
* **All React Native exports forwarded** - `react-native` imports now pass through every export of React Native, fixing `undefined` values for exports like `AssetRegistry` on React Native 0.88, which broke `expo-asset` 58 and `expo-font`
* **Hot reload for imported CSS** - Editing a stylesheet imported from your `global.css`, such as a file with theme tokens, now triggers a hot reload on native
* **Theme flip during resize fix** - A theme change that lands during a window resize, rotation or fold no longer leaves the app at the old window size
* **List theming on Android fix** - Fixed list content containers, column wrappers and headers randomly keeping the previous theme on Android when a state update landed during a theme change
* **Suspense content after theme change fix** - Content revealed by `Suspense` or `Activity` after a theme change while it was hidden no longer stays invisible
* **ActivityIndicator theming fix** - Theme changes now update the View wrapping `ActivityIndicator`, where its `className` styles like background and padding apply, instead of the native indicator
* **Smoother animations** - Uniwind no longer scans the Shadow Tree for unmounted views after every Reanimated frame, and drops all registered views when a surface stops
* **Text truncation fix** - `Text` with `numberOfLines` defaults `ellipsizeMode` to `tail` again
* **`fontVariant` fix** - Utilities like `tabular-nums` no longer produce empty `fontVariant` entries
* **Published `uniwind.css` fix** - The `uniwind.css` shipped since 1.8.0 no longer ends with a test `@theme` block that set `--color-background` and `--app-foreground` to `unset`

**October 5, 2026**

1.8.1

## Uniwind Pro 1.8.1

* **React Native 0.88 support** - Added compatibility with React Native 0.88. 1.8.0 fails to build there because `ImageProps::tintColor` became optional. See [Compatibility](https://docs.uniwind.dev/pro/compatibility.md)
* **`:root` parsing fix** - Classes that follow a `:root` block, including inside `@layer`, `@supports`, and `@media`, no longer have their declarations parsed as CSS variables instead of styles
* **Web styles on late CSS load fix** - JS-resolved styles like `useCSSVariable` and `useResolveClassNames` now refresh when CSS loads after module initialization, such as during Metro web development startup
* **InputAccessoryView circular dependency fix** - Fixed a circular dependency on web, where React Native Web's internal imports resolved to Uniwind's styled components instead of the originals
* **Vite Reanimated import fix** - On Vite 8, `react-native` imports from dependencies in `node_modules` now resolve to `react-native-web`, preventing Reanimated from cycling through Uniwind's animation wrappers before its exports initialize

**October 1, 2026**

1.8.0

## Uniwind Pro 1.8.0

* **Faster mounts** - Fixed a mount performance regression introduced in 1.7.0. Fiber tracking now uses a different algorithm, and unmounted nodes are unlinked in a single batch
* **`font-variation-settings` support** - Added support for `font-variation-settings`. React Native applies it from 0.88
* **`text-start` / `text-end` support** - `text-align: start` and `end` now pass through as `textAlign`. React Native resolves `end` from 0.87, and older versions fall back to natural alignment
* **InputAccessoryView on web** - Added web support for `InputAccessoryView`, including styling through `className`
* **No more View and Text remounts** - Toggling `aria-*` props on `View`, or props like `numberOfLines`, `disabled`, `accessibilityState`, `selectionColor` or `style` on `Text`, no longer swaps the underlying component
* **Stale theme after navigating back fix** - Fixed screens showing the previous theme after navigating back following a theme change. After each flip, Uniwind now points React's node references at the committed Shadow Tree, so later React commits no longer rebuild from pre-flip nodes
* **Theme transitions on 120Hz fix** - Fixed theme transitions being skipped on 120Hz displays, where the snapshot cleanup could fire before the theme flip. Orphaned transition snapshots are now always removed
* **setTheme on mount fix** - Calling `Uniwind.setTheme` from a screen's mount effect now updates that screen. Affected components are resolved when the Shadow Tree update is committed, not when the flip is requested
* **Gradients after theme updates fix** - Gradients like `bg-linear-to-r`, `to-l`, `to-t` and `to-b` are no longer dropped after Shadow Tree updates, and inline `backgroundImage` without the `experimental_` prefix (React Native 0.87+) keeps its gradient
* **`vw` / `vh` and safe area after rotation fix** - Viewport units and safe area classes (`w-[50vw]`, `pt-safe`) now update after rotation, Split View resize, or inset changes instead of keeping their launch values
* **Activity and Suspense reveal fix** - Content revealed by `Activity` or Suspense now picks up theme and style changes that happened while it was hidden
* **Media query blocks fix** - Fixed only the first utility of a shared media block keeping its media query, which caused `android:` utilities to apply on iOS (and vice versa), and breakpoint utilities to apply below their breakpoint
* **Exclusive breakpoint boundaries fix** - Exclusive media query bounds no longer match at the exact boundary value
* **React Native below 0.86.1 build fix** - The native props mutex added in 1.7.0 is now only used on React Native 0.86.1+, where it exists
* **Aliased package resolution fix** - Fixed Metro resolving a hoisted public `uniwind` instead of Pro when it is installed under an alias (`"uniwind": "npm:uniwind-pro"`) and Expo autolinking resolution is enabled
* **Metro entry fallback fix** - Added `main` and `react-native` fields to `package.json`, fixing `Unable to resolve "uniwind"` when Metro doesn't use `exports`
* **Expo tree shaking fix** - Uniwind's injected JS is no longer optimized away by Expo's tree shaking
* **Resolver rewrite fix** - The Metro resolver no longer rewrites unrelated imports when a parent directory is named `react-native`
* **Atomic CSS artifact writes** - `uniwind.css` and the type declarations are now written atomically, fixing random `Missing closing } at @theme` errors in CI
* **Component subpath types fix** - Fixed `no-types.d.ts` not being published
* **Vite 8 deprecation warning fix** - Removed the deprecated `customResolver` alias option, which triggered a warning on Vite 8 and is removed in Vite 9

**September 4, 2026**

1.7.0

## Uniwind Pro 1.7.0

* **Origin-based theme transitions** - Three new presets start the animation from the point you pressed: `CircleFromOrigin`, `SlideFromOrigin`, and `BlurFromOrigin`. Pass `origin: { x, y }` from a press event's `pageX` / `pageY`, or omit it to reveal from the screen center. Works on iOS, Android, and Web. See [Theme Transitions](https://docs.uniwind.dev/pro/theme-transitions.md)
* **Blurred views in Android transitions** - Android now snapshots the window with `PixelCopy`, so views using `filter: blur()` keep their blur in the transition overlay instead of rendering sharp
* **`drop-shadow` filter** - Added support for Tailwind's `drop-shadow-*` utilities, including preset sizes, arbitrary values, and color modifiers. They compile to native filters and combine with other filters like `blur-*`. See [Filters](https://docs.uniwind.dev/faq.md#how-do-i-enable-filters-blur-grayscale-on-native)
* **Best-in-class support for suspended and frozen screens ❄️** - Uniwind Pro now tracks React fibers and performs correct Shadow Tree updates on screens frozen by `react-freeze` or suspended by React, such as inactive tabs in React Navigation
* **Faster style resolution** - Improved caching of theme updates, and components with static class names no longer register with the Shadow Tree
* **Tailwind 4.3.3 support** - Tailwind 4.3.3 emits flattened variant selectors (`.active\:x:active`) instead of nested ones. Variants like `active:`, `disabled:`, `dark:`, `dir()`, and `data-*` now compile correctly on both selector shapes, and flattened theme roots are handled on web
* **Nitro Modules upgrade** - Updated to `react-native-nitro-modules` 0.37.1. See [Compatibility](https://docs.uniwind.dev/pro/compatibility.md)
* **Faster dev reloads** - The native runtime skips stylesheet reinitialization when the generated styles and themes haven't changed
* **Default styles regression fix** - Fixed components such as `TouchableOpacity` losing theme updates with `experimental.defaultStyles` enabled, and fixed accent targets like a `ScrollView` content container not resolving through the Shadow Tree synchronizer
* **iOS dimensions fix** - Screen dimensions and pixel ratio now fall back to the main screen when no window is presented, and refresh when the app becomes active
* **Pressable remount fix** - Animated `Pressable` no longer remounts when the theme changes during an active press, which could leave it stuck in the pressed state
* **Web lazy components hot reload fix** - CSS changes now hot reload for lazily loaded components on web
* **Symlinked packages fix** - The Metro resolver now keeps Uniwind's internal imports internal when the package is symlinked, as with pnpm and monorepos
* **Native props thread safety** - Access to native props is now guarded by a mutex. This mutex only exists in React Native 0.86.1+, so 1.7.0 fails to build on older React Native versions. Use 1.8.0 instead

**August 17, 2026**

1.6.0

## Uniwind Pro 1.6.0

* **Scoped variables** - New `ScopedVariables` component overrides CSS variables for a single subtree, with nested scopes resolving nearest-first
* **Prebuilt XCFramework for React Native 0.85.3** - The [Uniwind Pro Demo](https://github.com/uni-stack/uniwind-pro-demo) now ships a prebuilt XCFramework for React Native 0.85.3, so you can run Pro on the iOS Simulator without a license
* **Filter support** - Added `filter` support on iOS and React Native 0.87 canary
* **React Native 0.87 type alignment** - Aligned Uniwind types with the latest React Native 0.87
* **React Native 0.87 color scheme handling** - Updated color scheme handling for React Native 0.87 compatibility
* **dataSet resolution fix** - `dataSet` now resolves to `undefined` when no `data-set` prop was provided
* **Web bundling fix** - Fixed React Native web bundling by adding a `browser` exports field

**August 3, 2026**

1.5.1

## Uniwind Pro 1.5.1

* **React Native 0.87 support** - Added compatibility with React Native 0.87. See [Compatibility](https://docs.uniwind.dev/pro/compatibility.md)
* **Nitro Modules upgrade** - Updated to `react-native-nitro-modules` 0.36.5
* **Touchable type removed** - Removed the `Touchable` type reference from package types to align with React Native's [Strict TypeScript API](https://reactnative.dev/docs/strict-typescript-api)
* **Expo transform worker fix** - Fixed monorepos containing both an Expo app and a plain React Native app, where the plain RN app could resolve Expo's transform worker and fail to build
* **Vite 8 prebundling fix** - Fixed Vite 8 not prebundling `react-native-web`
* **Web theme initialization fix** - Web themes now initialize from an existing theme class on the page, preventing theme flicker on server-rendered pages
* **Multiline class names fix** - Fixed styling for native components when class names are separated by newlines or other whitespace
* **withUniwind web props fix** - `withUniwind` no longer forwards `className` props to wrapped components on web after converting them

**July 1, 2026**

1.5.0

## Uniwind Pro 1.5.0

* **Expo SDK 57 support** - Added compatibility with Expo SDK 57. See [Compatibility](https://docs.uniwind.dev/pro/compatibility.md)
* **Precompiled headers** - Added precompiled headers for Android and iOS, speeding up native Uniwind compilation by up to 30%. Enabled by default. See [Precompiled Headers](https://docs.uniwind.dev/pro/precompiled-headers.md)
* **Safe area RTL classes** - Added RTL-aware safe area utilities (`ps-safe`, `pe-safe`, `ms-safe`, `me-safe`, `start-safe`, `end-safe`) for the logical start and end edges. See [Safe Area Classes](https://docs.uniwind.dev/class-names.md#safe-area-classes)
* **`min()` CSS function** - Added support for the `min()` CSS function in your styles
* **React Native 0.86 converters** - Aligned all CSS C++ converters with React Native 0.86
* **C++ converter tests** - Added 85 new C++ test cases covering every converter, running on each CI build
* **Nitro Modules upgrade** - Updated to `react-native-nitro-modules` 0.36.1
* **AGENTS.md refresh** - Refreshed the `AGENTS.md` guidance for AI-assisted development
* **`!important` specificity fix** - Fixed `!important` specificity when combined with state variants

**June 11, 2026**

1.4.0

## Uniwind Pro 1.4.0

* **SHA-256 payload verification** - The CLI now verifies every downloaded payload against a published checksum before extracting it, and re-verifies the local cache on every restore. If verification fails, nothing is installed. Checksums are publicly available per version. See [Verifying Downloads](https://docs.uniwind.dev/pro/cicd-license.md#verifying-downloads)
* **CDN integrity headers** - Download responses now include an RFC 9530 `Repr-Digest` header and honor `If-None-Match` conditional requests
* **LayoutDirection component** - Force RTL or LTR for a subtree without changing the global device RTL state. See [Layout Direction](https://docs.uniwind.dev/api/layout-direction.md)
* **C++ converter tests** - Added 42 C++ test cases for the converters: pure `folly::dynamic` conversions plus JSI marshalling against a real Hermes runtime, running on every CI build
* **Combined variants fix** - Fixed combined variants overriding each other
* **Bundler infinite loop fix** - Fixed an infinite bundler loop when multiple Uniwind instances are installed
* **Web variant condition fix** - Fixed the web variant resolution condition

**June 3, 2026**

1.3.0

## Uniwind Pro 1.3.0

* **Vite 8 support** - Added support for Vite 8 in the Uniwind Vite plugin
* **Nitro Modules as peer dependency** - Moved `react-native-nitro-modules` to peer dependencies so apps control the installed Nitro version
* **Isolated install fix** - Fixed phantom dependencies so isolated installs work correctly
* **CLI improvements** - Added a more verbose error reason for stack traces

**June 1, 2026**

1.2.1

## Uniwind Pro 1.2.1

* **Nitro Modules upgrade** - Updated to `react-native-nitro-modules` 0.35.9
* **Examples updated** - Updated example apps to Expo SDK 56 and React Native 0.85+
* **Functions instead of computed values** - Replaced computed values with functions in style for more predictable resolution
* **Artifact generation script** - Added a script to generate artifacts for Uniwind
* **Better uniwind-pro CLI error handling** - The `uniwind-pro` CLI now shows stacktraces, HTTP error codes, and other details for easier debugging

**May 21, 2026**

1.2.0

## Uniwind Pro 1.2.0

* **Default styles for React Native components** - Added experimental default styles support for styling built-in React Native components directly from CSS. Enable it with `experimental.defaultStyles`. See [Default Styles](https://docs.uniwind.dev/pro/default-styles.md)
* **Nitro Modules upgrade** - Updated to `react-native-nitro-modules` 0.35.7
* **Silent CSS variable warning for SSR** - CSS variable warnings are now silenced during server-side rendering
* **Improved hot reload** - Hot reload is now more reliable during development
* **Flex shorthand parsing fix** - Fixed `flex: 1` being parsed into separated styles
* **Major bundler refactor** - Refactored the bundler internals to improve maintainability and prepare for future CSS processing features

**May 14, 2026**

1.1.3

## Uniwind Pro 1.1.3

* **Metro variable dependency fix** - Added missing variable metro dependency to the C++ side so CSS variable updates resolve correctly
* **Cache wipe on CSS variables update** - Cache is now wiped after CSS variables update to prevent stale values from being applied
* **!important support** - Tailwind `!important` modifier is now respected (e.g., `!bg-red-500`)
* **Deeply themed variables fix** - Fixed lookup for deeply nested themed variables

**May 11, 2026**

1.1.2

## Uniwind Pro 1.1.2

* **Logical inset utilities fix** - Fixed `inset-s` and `inset-e` class names in Uniwind Pro by bumping Tailwind to 4.2.1 for the new syntax
* **line-clamp respected** - Fixed `line-clamp-*` classes not being respected in Uniwind Pro

**May 5, 2026**

1.1.1

## Uniwind Pro 1.1.1

* **getCSSVariable function** - New `Uniwind.getCSSVariable` reads CSS variable values from outside of React components, perfect for event handlers, async callbacks, and utility modules. See [getCSSVariable](https://docs.uniwind.dev/api/get-css-variable.md)
* **Logical border utilities** - `border-s` and `border-e` now correctly map to `inline-start` and `inline-end` border properties for RTL-aware layouts
* **Joined border radius parsing** - Fixed border radius parsing so combined corner classes apply correctly across affected components
* **Nitro Modules upgrade** - Updated to `react-native-nitro-modules` 0.35.6
* **Removed deprecated PushNotificationIOS getter** - Dropped the deprecated `PushNotificationIOS` getter to align with current React Native versions

**April 23, 2026**

1.1.0

## Uniwind Pro 1.1.0

* **Group Tailwind selectors** - Added support for Tailwind's `group` variants (`group-active:*`, `group-focus:*`) with named groups. State propagates through the C++ shadow tree with no React re-renders. See [Group Variants](https://docs.uniwind.dev/pro/group-variants.md)
* **Nitro Modules upgrade** - Updated to `react-native-nitro-modules` 0.35.5
* **Node resolver for escaped paths** - Switched to the Node resolver to prevent escaped traversal errors
* **oxlint migration** - Replaced ESLint with `oxlint` for faster linting
* **Config attributes and lint rules** - Updated config attribute naming conventions and lint rule set
* **updateCSSVariable inside scoped themes** - Fixed CSS variable propagation across scoped themes when theme switches
* **CJS injection fix** - Inject CJS instead of ESM at initialization so debug Metro builds without tree shaking don't break

**April 7, 2026**

1.0.1

## Uniwind Pro 1.0.1

> [!TIP]
>
> Uniwind Pro is now stable! After months of beta testing and seven release candidates, the C++ engine is production-ready. Thank you to every team that helped us get here.

* **Dev warnings for color props** - Uniwind now warns in dev mode when you pass a regular Tailwind class (e.g., `bg-blue-500`) to a color prop that expects the `accent-` prefix (e.g., `thumbColorClassName`, `trackColorOnClassName`). This helps catch styling mistakes early
* **Nitro Modules upgrade** - Updated to `react-native-nitro-modules` 0.35.3
* **Metro transformer path fix** - Fixed reading absolute `cssPath` instead of relative one in `metro-transformer`
* **CSS file transforming fix** - Fixed CSS file transforming for special setups

> [accordion] Show release candidate history
>
> **March 26, 2026**
>
> 1.0.0-rc.7
>
> ## Suspended Subtrees & Pre-build Prep
>
> Birds are chirping. This could be the last RC before the grand finale 🎵
>
> * **Suspended subtrees support** - Suspended subtrees now correctly receive shadow tree updates, enabling proper usage with React's `<Freeze>` and similar patterns
> * **XCFramework pre-build preparation** - Prepared the codebase to support XCFramework pre-builds in upcoming releases
> * **withUniwind data attributes fix** - Fixed `withUniwind` not respecting data attributes
> * **P3 color parsing fix** - Fixed Display P3 color parsing
> * **Reanimated circular dependency fix** - Fixed a circular dependency issue with Reanimated
> * **tar security fix** - Updated `tar` package to address a security vulnerability
>
> **March 19, 2026**
>
> 1.0.0-rc.6
>
> ## Custom Animations & Native Transitions
>
> * **Custom animations** - Added support for custom keyframe animations via `className`. See [Reanimated Animations](https://docs.uniwind.dev/pro/reanimated-animations.md)
> * **Entering and exiting animations** - New built-in entering and exiting animation presets. See [Reanimated Animations](https://docs.uniwind.dev/pro/reanimated-animations.md)
> * **Native blur theme transitions** - Added new blur-based theme transition effects. See [Theme Transitions](https://docs.uniwind.dev/pro/theme-transitions.md)
> * **border-continuous and border-circular** - Added `border-continuous` and `border-circular` border curve utilities
> * **Filter unserializable tokens** - Unserializable tokens are now filtered out gracefully instead of causing a parsing failure
> * **React Native 0.85 support** - Added compatibility with React Native 0.85
> * **ThemeName type export** - Exported the `ThemeName` type for easier typed theme usage
> * **Transition animation for single node** - Ensure transition animation is triggered even for components with a single node
> * **Native transition warnings** - Warn when there is no active shadow node available for transitions
> * **getWebStyles fix** - Fixed `getWebStyles` not returning default HTML styles
> * **Data attributes fix** - Fixed passing data attributes correctly to React Native Web
> * **CSS parser transforms fix** - Fixed CSS parser not handling multiple transforms correctly
> * **Custom utilities guide** - Added a guide for creating custom utilities. See [Custom Utilities](https://docs.uniwind.dev/theming/custom-utilities.md)
> * **Nitro Modules upgrade** - Updated to `react-native-nitro-modules` 0.35.2
> * **E2E testing** - Added automated end-to-end tests to the repository
>
> **March 5, 2026**
>
> 1.0.0-rc.5
>
> ## Theme Transitions & TV Support
>
> * **New theme transitions** - Added `SlideLeftToRight`, `CircleTopLeft`, `CircleBottomRight`, `CircleBottomLeft`, and `CircleCenter` transition animations
> * **Web theme transitions ✨** - Added theme transition support for web using the View Transition API
> * **TV and focus selectors** - Added support for tvOS platform, `tv:`, `android-tv:`, `apple-tv:`, and `focus:` selectors
> * **Nitro Modules upgrade** - Migrated to `react-native-nitro-modules` 0.35.0
> * **Official Uniwind skill** - Added official [Uniwind skill](https://skills.sh/uni-stack/uniwind/uniwind) for AI-assisted development
> * **Pinned lightningcss** - Pinned `lightningcss` version to 1.30.1
> * **Line clamp fix** - Fixed guard against `display: box` from `line-clamp-*` classes
>
> **March 2, 2026**
>
> 1.0.0-rc.4
>
> ## Nitro Upgrade & Fixes
>
> * **Nitro Modules upgrade** - Upgraded to `react-native-nitro-modules` 0.34.1
> * **Web bundling fix** - Fixed a web bundling issue introduced in rc.3
> * **Theme selector fix** - Moved theme selector out of the root and removed nulls
>
> **February 26, 2026**
>
> 1.0.0-rc.3
>
> ## Scoped Themes & Stability Fixes
>
> * **Scoped Themes 🎉** - Added `ScopedTheme` support for applying themes to a subtree without changing the global app theme. See [Scoped Themes](https://docs.uniwind.dev/api/scoped-themes.md)
> * **Migration skill update** - Updated the Nativewind-to-Uniwind migration skill to include `ScopedTheme` guidance
> * **JS expression fallback fix** - Invalid JavaScript expressions are now treated as plain strings instead of failing parsing
> * **Gradient parsing fix** - Fixed gradient parsing with `%` values and CSS variables
> * **Border opacity shadow tree fix** - Fixed missing shadow tree updates for borders with opacity
> * **Android hard reload memory leak fix** - Resolved an Android memory leak during hard reloads
> * **Reanimated theme transition crash fix** - Fixed app crashes when repeatedly switching themes with reanimated transitions
>
> **February 18, 2026**
>
> 1.0.0-rc.2
>
> ## New Utilities & Fixes
>
> * **Start/end spacing properties** - Added support for `ps`, `pe`, `ms`, and `me` logical spacing utilities by @khaled-hamam
> * **fontScale and pixelRatio without arguments** - Both `fontScale()` and `pixelRatio()` functions can now be called without arguments
> * **FlatList crash fix** - Fixed a crash for undefined ShadowNode while unmounting components in nested `FlatList` and `VirtualizedList`
> * **Android IME insets** - Android now ignores IME insets and correctly respects system bars
>
> **February 13, 2026**
>
> 1.0.0-rc.1
>
> ## Public Release
>
> > [!TIP]
> >
> > We're thrilled to announce the first public release of Uniwind Pro. Battle-tested by dozens of companies and ready to be used in your unique project.
>
> * **Insets safety with keyboard management** - Bottom safe area insets are now protected from IME insets when using keyboard management packages
> * **Nitro Modules upgrade** - Upgraded to `react-native-nitro-modules` 0.33.9
> * **Migration skill released** - Added a migration skill from Nativewind to Uniwind. Give it a try in [Skills](https://docs.uniwind.dev/skills.md)
> * **Metro config cleanup** - Removed `.mjs` export from Metro config
> * **Hermes v1 fix** - Insets updates now subscribe before triggering listeners

> [accordion] Show beta history
>
> **February 9, 2026**
>
> 1.0.0-beta.11
>
> ## Cache & Fixes
>
> This release focuses on download efficiency, platform fixes, and improved package manager compatibility:
>
> * **Local cache for worktrees** - Implemented local cache to reduce repeated downloads when working across Git worktrees
>
> * **Android color scheme fix** - Fixed an issue where the initial color scheme could be locked to light on Android
>
> * **Nitro Modules support update** - Support `react-native-nitro-modules` 0.33.7
>
> * **FlashList and LegendList safety fix** - Prevented nullable `__nativeTag` for FlashList and LegendList
>
> * **pnpm installation fix** - Added a `uniwind-pro` postinstall script to fix an issue in pnpm environments
>
> * **Animated Pressable restored** - Brought back Animated Pressable after a regression in beta.10
>
> * **RNW + Vite Tailwind fix** - Fixed Tailwind classes not applying to React Native Web and Vite by @dannyhw
>
> > [!NOTE]
> >
> > This is most likely the latest beta release. Uniwind Pro is expected to become generally available for everyone with the first RC release.
>
> **February 2, 2026**
>
> 1.0.0-beta.10
>
> ## Data attributes
>
> This release includes engine upgrades, rendering fixes, and improved web compatibility:
>
> * **Data attribute selectors** - Added support for styling with `data-*` attributes. See [Data Selectors](https://docs.uniwind.dev/api/data-selectors.md)
> * **Nitro Modules upgrade** - Upgraded to `react-native-nitro-modules` 0.33.3
> * **hairlineWidth support** - Add missing implementation on the C++ side
> * **Nested Text classNames** - Fixed missing `className` propagation for nested `Text` components
> * **CSS variables isolation** - Fixed an issue with `updateCSSVariables` while updating the current theme
> * **React Native Web fixes** - Resolved minor issues where some styles didn't apply correctly on the web
> * **Insets parsing** - Fixed an issue with parsing insets values
>
> **January 27, 2026**
>
> 1.0.0-beta.9
>
> ## Features & Bug Fixes
>
> This release brings iOS static frameworks support and important web platform fixes:
>
> * **iOS static frameworks support** - Full compatibility with `useFrameworks: "static"`
> * **Simpler CI/CD setup** - `libsecret` installation is no longer needed to verify the license on cloud platforms
> * **React Native Web CSS layer fix** - Patched React Native Web to wrap default styles with CSS layer for better style isolation
> * **Vite Animated components fix** - Fixed resolution of Animated components in Vite builds
> * **ColorSchemeName compatibility** - Added support for both new and old ColorSchemeName types in React Native
>
> **January 22, 2026**
>
> 1.0.0-beta.8
>
> ## Bug Fixes
>
> This release includes important fixes for build and path resolution:
>
> * **Resolver internal path check** - Fixed internal path resolution in the custom resolver that was causing errors on the web platform
> * **CMakeLists.txt autolinking** - Corrected the autolinking file path in CMakeLists.txt for better build compatibility
>
> **January 22, 2026**
>
> 1.0.0-beta.7
>
> ## More Power, More Flexibility
>
> This release brings exciting new features and important fixes to make your development experience even smoother.
>
> * **Custom safe area spacings** - You can now combine safe area utilities with custom spacing values (e.g., `pt-safe-[20px]`, `pb-safe-4`) for pixel-perfect layouts
>
> * **parseColor runtime support** - New `parseColor` function lets you parse Tailwind colors at runtime, perfect for dynamic theming and color manipulation
>
> * **Linux build fix** - Fixed a case-sensitive filename issue that caused Android builds to fail on Expo EAS (Linux environments)
>
> * **Improved Metro stability** - Resolved a "maximum call stack size exceeded" error that could crash the Metro bundler
>
> * **Better path resolution** - Fixed React Native directory resolution for non-standard project structures
>
> > [!NOTE]
> >
> > **Experimental iOS Static Frameworks Support**: If you're using `useFrameworks: "static"` in your Expo config, try the experimental version `uniwind-pro-1.0.0-beta.7-22012026`. This build includes fixes for iOS static framework compatibility.
>
> **January 20, 2026**
>
> 1.0.0-beta.6
>
> ## Bug Fixes & CLI Improvements
>
> * **numberOfLines fix** - Fixed an issue where `numberOfLines` prop didn't work correctly
> * **Uniwind.updateInsets noop** - Added noop function for `Uniwind.updateInsets` for better compatibility with open source version
> * **CLI light theme support** - The CLI now supports light terminal themes
>
> **January 19, 2026**
>
> 1.0.0-beta.5
>
> ## Welcome Waitlist Users!
>
> This is the first release available to users from the waitlist. We're excited to have you on board!
>
> * **Team license package name support** - You can now use package names with `/` in team licenses (e.g., `@repo/example`)
>
> ### Under the hood
>
> * Changed imports for some Nitro headers to be found in different C++ environments
>
> **January 19, 2026**
>
> 1.0.0-beta.4
>
> ## CLI Improvements
>
> * **pnpm support** - The `uniwind-pro` CLI now supports pnpm package manager
>
> **January 18, 2026**
>
> 1.0.0-beta.3
>
> ## Smoother Than Ever
>
> We've been obsessing over the small details that make a big difference. This release focuses on making Uniwind Pro feel buttery smooth.
>
> * **Revamped Shadow Tree algorithm** - We've rewritten how style updates propagate through the Shadow Tree. The result? Even snappier UI updates with less overhead
> * **Smarter snapshot handling** - Pending snapshots are now canceled when no Shadow Tree update occurs, avoiding unnecessary UI blocks
> * **Theme transitions fixed on iOS** - Native props now update correctly when theme transition is set to `none`
> * **One-line upgrade** - Transitioning from Uniwind to Uniwind Pro is now a single line change in your `package.json`. Less config, more building
>
> ### Under the hood
>
> * Upgraded to `react-native-nitro-modules` >= 0.33.2
>
> **January 15, 2026**
>
> 1.0.0-beta.2
>
> ## Bug Fixes & Improvements
>
> This release includes all fixes from Uniwind Free v1.2.4:
>
> * **Animated components now work correctly** - Fixed an issue where Animated components were incorrectly skipped by the custom resolver
> * **Improved CSS class parsing** - Fixed whitespace handling around dots in class names
> * **Theme change API improvements** - The `onThemeChange` callback is now properly protected
> * **Nitro Modules upgrade** - Now requires `react-native-nitro-modules` >= 0.33.0
> * **CLI dependencies update** - Moved CLI packages from `devDependencies` to `dependencies` for better compatibility
>
> **January 11, 2026**
>
> 1.0.0-beta.1
>
> ## Uniwind Pro Beta
>
> We're thrilled to announce the first beta release of Uniwind Pro! This release is powered by the brand new **Unistyles 2nd generation C++ engine** with full **Fabric** support.
>
> All Pro features are now available:
>
> * **Zero re-renders** - Shadow Tree updates happen directly in C++ without triggering React re-renders
>
> * **Built-in safe area insets** - Automatically injected from the native layer, no setup required
>
> * **Reanimated 4 support** - Use Tailwind classes for animations via `className`
>
> * **Full Fabric support** - Built from the ground up for the new React Native architecture
>
> > [!NOTE]
> >
> > All features listed on the [pricing page](https://uniwind.dev/pricing) have been implemented in this beta release.
>
> ### What's next?
>
> We're doing final checks before removing the waitlist and inviting subscribers. It's a matter of days rather than weeks now.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.