Primitives

PortalProvider

Provider that coordinates portal entries across the app.

Import

typescript
import { PortalProvider } from 'reactnatively';

Installation

Install Reactnatively once in your React Native or Expo application, then import PortalProvider from the framework package.

bash
pnpm add reactnatively

Interactive preview

Base primitive
PortalProvider

Provider that coordinates portal entries across the app.

childrenstyletestIDaccessibilityLabel
PortalProviderExample.tsx
1import { Text } from 'react-native';2import { PortalProvider } from 'reactnatively';34export function Example() {5  return (6    <PortalProvider style={{ padding: 16 }}>7      <Text>PortalProvider content</Text>8    </PortalProvider>9  );10}

React Native usage example

PortalProviderExample.tsx
1import { Text } from 'react-native';2import { PortalProvider } from 'reactnatively';34export function Example() {5  return (6    <PortalProvider style={{ padding: 16 }}>7      <Text>PortalProvider content</Text>8    </PortalProvider>9  );10}

Props

PropTypeDefaultDescription
childrenReactNodeundefinedContent rendered inside the component.
styleStyleProp<ViewStyle>undefinedStyle applied to the outer container.
testIDstringundefinedIdentifier used by tests and automation.
accessibilityLabelstringundefinedScreen-reader label for the component.

Variants and examples

Default

PortalProviderDefault.tsx
1import { Text } from 'react-native';2import { PortalProvider } from 'reactnatively';34export function Preview() {5  return (6    <PortalProvider style={{ padding: 16 }}>7      <Text>PortalProvider content</Text>8    </PortalProvider>9  );10}

Composed example

PortalProviderComposed.tsx
1import { Text } from 'react-native';2import { PortalProvider, Box } from 'reactnatively';34export function PortalProviderComposed() {5  return (6    <Box padding="md">7      <PortalProvider>8        <Text>PortalProvider content</Text>9      </PortalProvider>10    </Box>11  );12}

TypeScript IntelliSense

The component exports typed props, so editors can autocomplete prop names, union values, callbacks, and theme-aware style objects as you type.

PortalProvider.types-example.tsx
1import type { ComponentProps } from 'react';2import { PortalProvider } from 'reactnatively';34type PortalProviderProps = ComponentProps<typeof PortalProvider>;56const exampleProps: PortalProviderProps = {7  style: undefined,8  testID: "reactnatively-example",9  accessibilityLabel: "Example control",10};1112export function TypedPortalProvider() {13  return <PortalProvider {...exampleProps} />;14}

Theme support

PortalProvider participates in the Reactnatively theme system through semantic colors, spacing, radii, typography, motion, and glass tokens where those props apply. Wrap your app in ReactnativelyProvider or ThemeProvider to keep light mode, dark mode, density, and custom tokens consistent.

Accessibility

Use accessible labels, hints, roles, and focus behavior when PortalProvideris interactive. Reactnatively components are designed for React Native apps that need screen-reader support, reduced-motion handling, and consistent touch targets.

Expo compatibility

PortalProvider can be used in Expo apps with TypeScript. Glass and blur behavior depends on platform capability, so production interfaces should keep text contrast and fallback tinting readable when native blur is unavailable.