Overview

The VGS Show React Native SDK (@vgs/show-react-native) securely reveals data for users without passing raw values through your application API surface.

The SDK provides React Native components for showing protected content on iOS and Android:

• VGSShowLabel for text fields

• VGSShowImage for base64 JPEG or PNG image fields

• VGSShowPdf for base64 PDF fields

Each component subscribes to a VGSShow instance and receives content from a field selected by contentPath. A single reveal request can update multiple subscribed components.

Data security

Companies that store, transmit, or process sensitive card data may need to comply with PCI DSS. VGS Show helps reduce exposure by sending revealed data from VGS directly into SDK-managed UI components instead of returning raw values to application code.

Application code should treat the SDK components as the security boundary:

• Do not store revealed values in React state, Redux, local storage, logs, analytics, crash reports, screenshots, or custom callbacks.

• Do not expose the image or PDF base64 outside VGSShowImage or VGSShowPdf.

• Configure masking and copy behavior before users interact with sensitive text.

• Use synthetic example data in code samples, tests, screenshots, and docs.

Features

• Batched reveal requests through one VGSShow instance.

• Text placeholders, masking, regex transformations, clipboard copy formats, and clearing.

• Image reveal for base64 image data.

• PDF reveal through the SDK's bundled native renderer dependencies.

• Stable VGSShowError codes and types for safe error handling.

• Logging disabled by default with explicit diagnostic controls.

• iOS and Android support. Web and other React Native platforms are not supported.