Release 2.30.0

2.30.0 (2025-02-19)

This release brings several stability improvements for branch 2.0.

• Ensure Unistyles 2.x fully supports React Native 0.78
• Unblock Reanimated's useAnimatedKeyboard when transitioning from the background
• Ensure iOS insets are correct during background transitions
• Improve TypeScript variants with enhancements from the 3.x branch

Commits

• bump example to RN 0.78 (6b2431d)
• pause inset listener while in background (66e1998)
• replace deprecated window retrieval in objc (7580a2d)
• ts imporve union to intersection for variants (662236c)

Release 3.0.0-beta.7

3.0.0-beta.7 (2025-02-11)

Hello Unistylers! 🦄

This beta brings improved stability. Your bug reports are becoming more sophisticated and harder to reproduce, which means we're getting closer to the first RC. Thank you for all the tests and reproducers, we're truly shaping the next-gen styling library for React Native!

Breaking

• This release likely requires you to install react-native-nitro-modules >= 0.22.0.

Features

• [Babel] - rewrite logic for dependencies detection with babel scopes a189f2b
• [Core] Add Unistyles cache 🚀 dbdbf83
• [CI] Add biome check for precommit 634bf72 by @jeremybarbet

Bug fixes

• Fix BAD_ACCESS crash for breakponts b8035ff
• Generate style hashes based on style key AND stylesheet id 98c08f9
• Pressables regression, bind "this" correctly 26ff0ce
• Babel - process any file that contains react-native-unistyles import 8468e1f
• Bind "this" on JSI side for Pressables 2385bdb
• Pressables - regression 97ee1a6
• Update to Nitro 0.22.1 98f2ea6
• Bring back ability to build Android SDK 24-26 cffb74
• Web fix typo for withUnistyles that fixes contentContainerStyles 47f0aa by @Brentlok
• filer not own properties in babel plugin eb85c3 by @pas-n
• rename unistyles secrets to avoid expo router warnings 2ebef1e by @Brentlok
• fix ScopedThemes for withUnistyles 79977da
• fix initial insets Android ce4955

Release 3.0.0-beta.6

3.0.0-beta.6 (2025-01-30)

Hello Unistylers!
In this beta release, we’ve fixed most issues and added support for several new features.
Here’s a TL;DR of the most important changes:

New Features

• Added support for React Native 0.77
• Babel: Added a new option, autoProcessRoot docs
• Babel: Added a new option, autoRemapImports docs
• Babel: Improved detection of inline object dependencies in StyleSheet.create
• Added support for the React Native Animated module
• Added support for raw RCTView and RCTText
• Introduced a new Unistyles setting: nativeBreakpointsMode docs

Bug Fixes

• Fixed a crash on Android hard reload
• Fixed an issue with Scrollables: Could not find shadow node for one of your components of type unknown
• Fixed passing nested style arrays on Web
• Ensured all statics are copied from Unistyles factories
• Fixed a race condition when detecting dependencies for variants
• Fixed screen.width and screen.height values returned from UnistylesRuntime while in the background

Release 3.0.0-beta.5

3.0.0-beta.5 (2025-01-20)

Bug Fixes

• add fallback getClassName for native (9f282e5)
• append style tag to head (7a92b55)
• aspect-ratio parsing (5350990)
• browser exception if no theme or settings provided to configure (7c8a14a)
• crash for unbound parser (b709b4d)
• disable multiple runs of configure on SSR (7440910)
• docs typo (c3b5da8)
• fix removing styles from static (e047841)
• handle cssvars in native settings (64d2098)
• improve multiple style warnings (19f914f)
• native components unmount (91ced41)
• pr code style feedback (ed568ca)
• regression image background (d090b1f)
• regression shadow node for keyboard avoiding view (3bd65d0)
• remove styles from mq (129690a)
• static (415cb5d)
• typo on parameter name (fd822f5)
• unmount native elements (043fb9e)
• useUnistyles theme type (9fa26ff)
• web css stylesheet missing @media prefix (90e63db)
• withUnistyles style types (1b0c2f3)

Features

• accept any styles in shadow registry (2e01a5a)
• add types definitions for the babel plugin + extra docs (3c60b1c)
• align withUnistyles (089b7d6)
• allow for passing nested array (738b4f3)
• allow user to specify own imports for babel plugin (ca416d4)
• auto detect geture handler components (533f784)
• auto process gesture handler components, add api to add own paths (7dc2ca5)
• bring back basic reanimated support (02ac0e1)
• copy variants to stylesheet (b3b10c4)
• css vars (a58a72d)
• deletect dependencies withUnistyles (548df50)
• dispose listeners when removing class (25f2583)
• expose ssr utils, allow for external RNW css control, removed dependency on nextjs (cd1bf8a)
• hydrate mq state (f7ef8b1)
• ignore react-native like imports (f19f9d6)
• imageBackground web (0b36079)
• inject rnw styles (6e3e362)
• mark unmounted unistyles as dirty to be recomputed later (1b13f23)
• move unistyles web to singleton (6178892)
• pass variants to shadow registry (dfa2a31)
• prevent double init with expo router (8076168)
• redesign variants (ee7d92d)
• redesign web variants (c3ec7aa)
• Regenerate specs (nitrogen) (072e895)
• regression for unistyles not bound warning (46ba6c6)
• regression useVariants (0ead677)
• remove arrays from babel (58eb4eb)
• remove arrays from babel (8ab8f15)
• remove unistyle not bound crash, replace it with warning (d40e26d)
• remove Variants deprecated logic (8d49b77)
• resolve unistyle not bound (f8a137e)
• restore babel style arrays (90b2de8)
• static ImageBackground (2a9ffc7)
• static ssr (0f88220)
• static ssr (cb84623)
• static ssr (b95bd70)
• static ssr (256df2e)
• static ssr (407cdf1)
• static ssr (028b3c2)
• static ssr (f03158b)
• static ssr (1976ac0)
• Update implementations for new Nitro (no need for HybridContext) (fc0f722)
• update native pressable and imageBackground implementations (262712e)
• Update Nitro from 0.18.2 to 0.21.0 (a1414b9)
• upgrade nitro to 0.21 (bd211cb)
• useUnistyles (5be1d3e)

Release 3.0.0-beta.4

3.0.0-beta.4 (2024-12-16)

This fixes the Codegen package.json resolution issue that affected beta.3!
If you've encountered the following error, simply upgrade to beta.4:

❌  (node_modules/react-native-unistyles/ios/UnistylesModuleOnLoad.h:8:9)

   6 | 
   7 | #import <React/RCTEventEmitter.h>
>  8 | #import "TurboUnistyles/TurboUnistyles.h"
     |         ^ 'TurboUnistyles/TurboUnistyles.h' file not found
   9 | #import <React/RCTSurfacePresenter.h>
  10 | #import <React/RCTScheduler.h>
  11 | #import <React/RCTRuntimeExecutorModule.h>

Bug Fixes

• codegen path (e36eb18)

Release 3.0.0-beta.3

3.0.0-beta.3 (2024-12-16)

Bug Fixes

• add check for secrets (42c4cc7)
• components exports (bae7a62)
• components exports (2d903be)
• issue with useVariants and conditional children (37bc297)
• mergin exotic styles with unistyles (1f09e4a)
• module exports (3c6b3c7)
• nested variants (5b5f1cd)
• override web types with native (d888339)
• pressable path for native (23cc9e0)

Features

• convert ternary to jsx if else (cad94e7)
• include components (8b8f270)
• pressable nested variants (9876ad6)
• regression (214a44f)
• text nested variants (898a5e3)
• withUnistyles - accept variants before any native evnet (65011af)

Release 3.0.0-beta.2

What a ride! 🦄

Based on the initial beta release and your feedback, we had plenty of work to do! Thank you for all the reports, private messages, and Discord discussions. You are truly helping us catch all the edge cases!

The most important features and improvements:

• Thinner Babel plugin: We removed almost 50% of it!
• Build with Android: Now fully supported
• Use iOS with USE_FRAMEWORKS: No more errors
• withUnistyles:

We’ve deprecated createUnistylesComponent in favor of withUnistyles. This allows you to access external props and functions!
Read more: https://www.unistyl.es/v3/references/with-unistyles

• ScopedTheme:

The most requested feature since Unistyles 2.0 is here! You can now enforce a specific theme for certain screens or components.
Read more: https://www.unistyl.es/v3/references/scoped-theme

• First-class support for the ImageBackground component

---

If you used beta.1, we recommend clearing your Metro and Android cache.

// expo
yarn expo prebuild --clean
yarn start -c

// bare RN
cd android && rm -rf .cxx build
yarn start --reset-cache

Commits

Bug Fixes

• bug report (a3dde15)
• bug report (1d7a6e0)
• bug report template (bf89d0e)
• circular dependency fail (a5e11fb)
• docs lp background color (49ca985)
• identifiers in pressables (b740ea0)
• invalid redirection paths (83df317)
• nested variants in pressables (119166c)
• no default variant is picked if user didnt pass any variant at all (2a0bdb5)
• pressable web (e327688)
• pressable web (a55653e)
• redirections (a804a53)
• typings (82b5bf9)
• withStyle types (10d231c)
• withUnistyles ref type (1e32680)

Features

• add missing components (1dedd25)
• add og tags for main page, fix seo component (247791d)
• add required dependencies (8d375e6)
• add stylesheet dependencies to native withUnistyles (98862fe)
• add support for dynamic unistyles imports (af888e2)
• add support for image background (c31cbad)
• add support for nesting scoped themes (b16c248)
• add support for scoped themes (9401105)
• add support for shadow updates (a276840)
• add support from refs passed via forwardRef (612a54c)
• adjust scoped themes in cxx (a30b6a6)
• attempt to build with use frameworks (92ee8b4)
• cleanup web (5467198)
• correctly detect dependencies in arrays (c28dd24)
• create useDependencies hook with shared logic (cac0c53)
• downgrade required node to 18 as EAS still relies on it (029264e)
• dynamic function with rt withunsityles (234aa4d)
• finish new variants (aac752b)
• finish poc (8696659)
• get rid of dynamic function arguments while linking (9cb672a)
• get rid of variants while linking node (8df0cbb)
• handle correctly styles in pressable (d0d0f30)
• improve pressables (265e510)
• improve variants (057bd9c)
• improve withUnistyles on mobile (fa51f0f)
• make android compile (7077434)
• new ci (04824e7)
• pass miini runtime to withUnityles (25acded)
• poc of components (399bc36)
• prevent traspiling components in node modules (652285b)
• remove altering ref (bb3712b)
• remove babel pressable style modifiction (cd124aa)
• remove hacks from pressable wrapper (b8e36c0)
• remove inline styles (3c2c8f2)
• remove inline styles (1052498)
• simplify pressable (97f666d)
• simplify pressable (752e87d)
• stop processing unistyle in host object (ec23a42)
• support detecting dependencies in multiple ifelse statements (5b6522b)
• swap pressable implementation even for multiple imports from react-native (1217f2d)
• test call cases, remove unsuported components (dc72388)
• upgrade nitro to 0.18.2 (0a09d02)
• web scoped themes (ac47fa0)
• withUnistyles 🦄 (a7d67aa)

Full Changelog: v3.0.0-beta.1...v3.0.0-beta.2

Release 3.0.0-beta.1

Introducing Unistyles 3.0!

Read more: https://www.reactnativecrossroads.com/posts/unistyles-3-preview
Migration guide: https://www.unistyl.es/v3/start/migration-guide
New docs: https://www.unistyl.es
Check changelog: Changelog

Release 2.20.0

2.20.0 (2024-11-22)

Features

• Introduce UnistylesProvider (7e3e7d8) by @yousefelgoharyx

Docs:

https://www.unistyl.es/reference/unistyles-provider/

Release 2.12.0

2.12.0 (2024-11-12)

Features

• [Android] exclude React Native so (1266451)