For AI agents: the complete documentation index is available at /react-native-arrangement-view/v0.1/llms.txt, the full documentation bundle is available at /react-native-arrangement-view/v0.1/llms-full.txt, and this page is available as Markdown at /react-native-arrangement-view/v0.1/guide/installation.md.

Installation

npm
yarn
pnpm
bun
deno
npm install react-native-arrangement-view@0.1

Then install the iOS pods:

cd ios && pod install
Warning

Use a native build in Expo (npx expo run:ios or a development build). Expo Go does not include this library.

iOS 27 also requires the host app to adopt the scene lifecycle. The example enables ios.enableSceneSupport through expo-build-properties on Expo SDK 57. See Expo’s scene migration guide for host-app configuration.

Requirements

RequirementSupport
React NativeNew Architecture; development and validation on 0.86.3 / React 19.2.3
Native adaptive arrangements and hinge eventsiOS 27.1+, built with Xcode 27.1 / iOS 27.1 SDK or newer
Older iOS, down to 16.4Deterministic SwiftUI fallback
Older Xcode SDKCompiles the fallback; rebuild and rerun CocoaPods with the new SDK to enable native arrangements
Android / webNot implemented; rendering the component throws an explicit unsupported-platform error

These Apple APIs are from a beta SDK and may change.

Usage

import { ArrangementView } from 'react-native-arrangement-view';

export function PlayerScreen() {
  return (
    <ArrangementView style={{ flex: 1 }} arrangement="split" axes="both">
      <ArrangementView.Primary>
        <Player />
      </ArrangementView.Primary>
      <ArrangementView.Secondary>
        <Transcript />
      </ArrangementView.Secondary>
    </ArrangementView>
  );
}

See ArrangementView for its props.