Changelog

​

Suspended Subtrees & Pre-build Prep

• 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

​

Custom Animations & Native Transitions

• Custom animations - Added support for custom keyframe animations via className. See Reanimated Animations
• Entering and exiting animations - New built-in entering and exiting animation presets. See Reanimated Animations
• Native blur theme transitions - Added new blur-based theme transition effects. See Theme Transitions
• 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
• Nitro Modules upgrade - Updated to react-native-nitro-modules 0.35.2
• E2E testing - Added automated end-to-end tests to the repository

​

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 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

​

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

​

Scoped Themes & Stability Fixes

• Scoped Themes 🎉 - Added ScopedTheme support for applying themes to a subtree without changing the global app theme. See Scoped Themes
• 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

​

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

​

Public Release

• 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
• Metro config cleanup - Removed .mjs export from Metro config
• Hermes v1 fix - Insets updates now subscribe before triggering listeners

​

Cache & Fixes

• 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

​

Data attributes

• Data attribute selectors - Added support for styling with data-* attributes. See Data Selectors
• 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

​

Features & Bug 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

​

Bug Fixes

• 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

​

More Power, More Flexibility

• 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

​

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

​

Welcome Waitlist Users!

• 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

​

CLI Improvements

• pnpm support - The uniwind-pro CLI now supports pnpm package manager

​

Smoother Than Ever

• 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

​

Bug Fixes & Improvements

• 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

​

Uniwind Pro Beta

• 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

​

What’s next?