# react-native-ios-utilities > Utilities for react-native + iOS and wrappers for using swift together with fabric/paper + JSI Latest version **5.2.0** (published 2025-09-28) · MIT license · 138.5K weekly downloads ## Install ```sh npm install react-native-ios-utilities pnpm add react-native-ios-utilities yarn add react-native-ios-utilities bun add react-native-ios-utilities ``` ## Health **Score 70/100 (B)** — status: stable. Positive: moderate downloads; has types; esm support; no vulnerabilities. ## Facts | | | |---|---| | Version | 5.2.0 | | Published | 2025-09-28 | | First published | 2022-04-21 | | Weekly downloads | 138.5K | | License | MIT | | TypeScript types | bundled | | Module format | ESM + CommonJS | | Dependencies | 0 | | Unpacked size | 480.7 KB | | Known vulnerabilities | 0 | | Install scripts | no | | GitHub stars | 77 | | Author | Dominic Go (https://github.com/dominicstop) | | Maintainers | dominicstop | | Keywords | react-native, ios, utilities, utility, fabric, paper, JSI | ## Links - npm: https://www.npmjs.com/package/react-native-ios-utilities - Repository: https://github.com/dominicstop/react-native-ios-utilities - Homepage: https://github.com/dominicstop/react-native-ios-utilities#readme - Issues: https://github.com/dominicstop/react-native-ios-utilities/issues - npm.io page: https://npm.io/package/react-native-ios-utilities ## Alternatives - [lodash.assign](https://npm.io/package/lodash.assign.md) — 2.3M weekly downloads - [lodash.chunk](https://npm.io/package/lodash.chunk.md) — 1.8M weekly downloads - [@technically/lodash](https://npm.io/package/@technically/lodash.md) — 50.9K weekly downloads - [@fluid-topics/ft-icon](https://npm.io/package/@fluid-topics/ft-icon.md) — 20.6K weekly downloads - [@fremtind/jkl-core](https://npm.io/package/@fremtind/jkl-core.md) — 4.2K weekly downloads ## Recent versions - 5.2.0 (latest) — 2025-09-28 - 5.1.8-1 (next) — 2025-07-16 - 5.1.8 — 2025-07-16 - 5.1.8-0 — 2025-07-14 - 5.1.7 — 2025-07-14 - 5.1.6 — 2025-07-14 - 5.1.5 — 2025-04-25 - 5.1.4 — 2025-04-01 - 5.1.3 — 2025-03-27 - 5.1.3-0 — 2025-03-25 - 5.1.2 — 2025-03-04 - 5.1.1 — 2025-01-21 - 5.1.0 — 2025-01-08 - 5.0.0 — 2025-01-05 - 4.5.3 — 2025-01-04 - … 152 more at https://npm.io/package/react-native-ios-utilities/versions ## README # react-native-ios-utilities [![build-example-ios](https://github.com/dominicstop/react-native-ios-utilities/actions/workflows/build-example-ios.yml/badge.svg)](https://github.com/dominicstop/react-native-ios-utilities/actions/workflows/build-example-ios.yml) hello, this is a helper library, and doesn’t really do anything on it’s own. This library is meant to be used as a dependency for some other libraries i am making — i.e. as a way to share code, and prevent duplicated logic. Please see the [version compatibility](#version-compatibility) table for reference.

## 🚧⚠️ Re-Write WIP 🚧⚠️ This library is being re-written to support both the new + old architecture. Please see this is [issue](https://github.com/dominicstop/react-native-ios-context-menu/issues/100#issuecomment-2077986438) for progress 😔 **Overview**: - [`RNIBaseView`](ios/Sources/RNIBaseView): A shared/common “base view” to allow for making native components that work on both fabric (the new architecture) and paper (please see: [`RNIWrapperView`](ios/Sources/RNIWrapperView) for an example implementation). - [`RNIContentViewDelegate`](ios/Sources/RNIContentView/RNIContentViewDelegate.swift): A delegate that let’s the conforming `UIView` (written in swift) to manage + communicate with its associated parent fabric/paper view, and handle layout, receive props + async view commands from JS, and dispatch events from native. - [`RNIViewLifecyleEvent`](ios/Sources/RNIViewLifecycle): a set of delegates for receiving common view lifecycle events between fabric + paper, as well as receiving events that are either fabric-only or paper-only. Please see [`RNIBaseViewEventBroadcaster`](ios/Sources/RNIBaseView/RNIBaseViewEventBroadcaster.swift) for an overview of what events are supported. - [`RNIContentViewParentDelegate`](): Exposes useful properties and methods from the parent paper/fabric view (e.g. controlling size/layout, getting the layout metrics, etc). - [`RNIBaseViewController`](ios/Sources/RNIBaseView/RNIBaseViewController.swift): A base implementation of a view controller that wraps a paper/fabric view and handles its sizing + layout when attached to non-react view. - [`RNIUtilitiesModule`](src/native_modules/RNIUtilitiesModule/RNIUtilitiesModule.ts): A helper JSI module that allows for sharing sync data between swift and js, and sending async commands to either views that conform to `RNIContentViewDelegate`, or objects that conform to [`RNIModuleCommandRequestHandling `](ios/Sources/RNIUtilitiesModule/RNIModuleCommandRequestHandling.swift) (please see the [js](src/native_components/RNIDummyTestView/RNIDummyTestViewModule.ts) + [swift](ios/Sources/RNIDummyTestView/RNIDummyTestViewModuleRequestHandler.swift) impl. of `RNIDummyTestViewModule` for a crude example). - **Types and Parsing**: Contains [typescript definitions](src/types) for native types (e.g. `UIKit`, `CoreGraphics` primitives, etc) so they can be represented in JS, as well as the associated code to parse them in native (e.g. [`InitializableFromDictionary`](ios/Sources/Extensions+InitializableFromDictionary), [`InitializableFromString`](ios/Sources/Extensions+InitializableFromString), dictionary helpers, etc). - **Misc**: Contains a bunch of helpers + extensions for working with RN across swift/objc/c++, and has a dependency to [`DGSwiftUtilities`](https://github.com/dominicstop/DGSwiftUtilities/tree/main/Sources) for more helpers + utilities written in swift.

## Acknowledgements Development and maintenance of this library was generously sponsored by [beatgig](https://beatgig.com/) from `11/15/2023` to ` 04/30/2024` at `$1,535`/month (totaling ≈ `$9,100` over the course of 6 months) 🥁🎸
The initial fabric rewrite (i.e. version `5.x`) was made possible through a generous `$3,750` sponsorship by [tamagui](https://github.com/tamagui/tamagui) over the course of 4 months (from: `05/27/24` to `09/30/24`) 🐦✨
very special thanks to: [junzhengca](https://github.com/junzhengca), [brentvatne](https://github.com/brentvatne), [expo](https://github.com/expo), [EvanBacon](https://github.com/EvanBacon), [corasan](https://github.com/corasan), [lauridskern](https://github.com/lauridskern), [ronintechnologies](https://github.com/ronintechnologies), [gerzonc](https://github.com/gerzonc), and [edencakir](https://github.com/edencakir) for becoming a monthly sponsor, and thank you [fobos531](https://github.com/fobos531) for being a one time sponsor 🥺 (if you have the means to do so, please considering sponsoring [here](https://github.com/sponsors/dominicstop))
Thank you very much for contributing to this library: [SamuelScheit](https://github.com/SamuelScheit) ([`pr-#6`](https://github.com/dominicstop/react-native-ios-utilities/pull/6)), [coolsoftwaretyler](https://github.com/coolsoftwaretyler) ([`pr-#11`](https://github.com/dominicstop/react-native-ios-utilities/pull/11)), [fobos531](https://github.com/fobos531) ([`pr-#18`](https://github.com/dominicstop/react-native-ios-utilities/pull/18), [`pr-#20`](https://github.com/dominicstop/react-native-ios-utilities/pull/20)), [itsramiel](https://github.com/itsramiel) ([`pr-27`](https://github.com/dominicstop/react-native-ios-utilities/pull/27), [`pr-28`](https://github.com/dominicstop/react-native-ios-utilities/pull/28), [`pr-29`](https://github.com/dominicstop/react-native-ios-utilities/pull/29)), [Innei](https://github.com/Innei) ([`pr-25`](https://github.com/dominicstop/react-native-ios-utilities/pull/25)) 💫

## Installation ```sh npm install react-native-ios-utilities@next cd ios && pod install ```
### Optional Extra Steps In your project's `Podfile`, you can also explicitly set `REACT_NATIVE_TARGET_VERSION` env. to your specific RN version (see code snippet below). ```ruby require 'json' reactNativeVersion = '0.0.0' begin reactNativeVersion = `node --print "require('react-native/package.json').version"` rescue reactNativeVersion = '0.0.0' end reactNativeTargetVersion = reactNativeVersion.split('.')[1].to_i ENV['REACT_NATIVE_TARGET_VERSION'] = reactNativeTargetVersion.to_s ```
The `REACT_NATIVE_TARGET_VERSION` env. variable gets passed as a macro constant, and is used for conditional compilation (e.g. to fix code due to changes with the RN API). Alternatively, you can just set `REACT_NATIVE_TARGET_VERSION` env. directly when you invoke `pod install` (e.g. `REACT_NATIVE_TARGET_VERSION=76 pod install`). When you run `pod install`, you should see the following output in the terminal: ``` react-native-ios-utilities - reactNativeTargetVersion: 0.75.2 - reactNativeTargetVersionOverride: 76 - fabric_enabled: true - linkage: static ```

## Version Compatibility | Library Version | Child Libraries / Dependents | | ----------------------------------------------------- | :----------------------------------------------------------- | | `react-native-ios-utilities`
**Version**: `4.3.x` | `react-native-ios-context-menu`
**Version**: `2.4.x`

`react-native-text-input-wrapper`
**Version**: `0.1.x`

`react-native-ios-adaptive-modal`
**Version**: `0.6.x`
| | `react-native-ios-utilities`
**Version**: `4.4.x` | `react-native-ios-context-menu`
**Version**: `2.5.x`

`react-native-text-input-wrapper`
**Version**: `0.1.x`

`react-native-ios-adaptive-modal`
**Version**: `0.7.x`
| | `react-native-ios-utilities`
**Version**: `5.x` | `react-native-ios-context-menu`
**Version**: `3.x`

`react-native-ios-visual-effect-view`
**Version**: `0.x`

`react-native-ios-modal`
**Version**: `3.x` |

## Contributing See the [contributing guide](CONTRIBUTING.md) to learn how to contribute to the repository and the development workflow.

## License MIT --- _Source: https://npm.io/package/react-native-ios-utilities · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._