Glass Engine

BlurSurface

Glass-aware blur surface for elevated, translucent UI regions.

Import

typescript

import { BlurSurface } from 'reactnatively';

Installation

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

bash

pnpm add reactnatively

Interactive preview

Glass primitive

BlurSurface

Glass-aware blur surface for elevated, translucent UI regions.

childrenstyletestIDaccessibilityLabel

BlurSurfaceExample.tsx

1import { Text } from 'react-native';2import { BlurSurface } from 'reactnatively';34export function Example() {5  return (6    <BlurSurface elevation={2}>7      <Text>BlurSurface content</Text>8    </BlurSurface>9  );10}

React Native usage example

BlurSurfaceExample.tsx

1import { Text } from 'react-native';2import { BlurSurface } from 'reactnatively';34export function Example() {5  return (6    <BlurSurface elevation={2}>7      <Text>BlurSurface content</Text>8    </BlurSurface>9  );10}

Props

Prop	Type	Default	Description
children	ReactNode	undefined	Content rendered inside the component.
style	StyleProp<ViewStyle>	undefined	Style applied to the outer container.
testID	string	undefined	Identifier used by tests and automation.
accessibilityLabel	string	undefined	Screen-reader label for the component.

Variants and examples

Default

BlurSurfaceDefault.tsx

1import { Text } from 'react-native';2import { BlurSurface } from 'reactnatively';34export function Preview() {5  return (6    <BlurSurface elevation={2}>7      <Text>BlurSurface content</Text>8    </BlurSurface>9  );10}

Composed example

BlurSurfaceComposed.tsx

1import { Text } from 'react-native';2import { BlurSurface, Box } from 'reactnatively';34export function BlurSurfaceComposed() {5  return (6    <Box padding="md">7      <BlurSurface>8        <Text>BlurSurface content</Text>9      </BlurSurface>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.

BlurSurface.types-example.tsx

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

Theme support

BlurSurface 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 BlurSurfaceis interactive. Reactnatively components are designed for React Native apps that need screen-reader support, reduced-motion handling, and consistent touch targets.

Expo compatibility

BlurSurface 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.