Skip to main content

Overview

No setup required. Safe area insets are automatically injected from the native layer. You don’t need react-native-safe-area-context or any additional configuration.
Uniwind Pro delivers safe area insets directly from C++ to your classNames. The native layer monitors inset changes (orientation, device notches) and updates your components automatically without triggering React re-renders.

Free vs Pro

FeatureFree VersionPro Version
Safe area classNamesSupportedSupported
Setup requiredSafeAreaListener + Uniwind.updateInsets()None
Dependenciesreact-native-safe-area-contextNone
Re-renders on inset changeYesNo

How It Works

  1. Native monitoring - The C++ layer subscribes to safe area inset changes from iOS/Android
  2. Direct updates - When insets change (initial render, orientation changes), values are pushed directly to the shadow tree
  3. No React involvement - Components using safe area classes update without re-rendering
  4. Single frame - All affected components update atomically in the same frame
This is part of Uniwind Pro’s shadow tree update mechanism. See Shadow Tree Updates for more details.

Shadow Tree Updates

Learn how Uniwind Pro updates views without re-renders

Migration Guide

Step-by-step guide to upgrade from Free to Pro