> For the complete documentation index, see [llms.txt](https://docs.verygoodsecurity.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verygoodsecurity.com/vault/developer-tools/vgs-show/react-native-sdk/overview.md).

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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.verygoodsecurity.com/vault/developer-tools/vgs-show/react-native-sdk/overview.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.