https://github.com/rajivshah3/react-native-secure-clipboard

Copy sensitive data to the iOS clipboard without making it available to other devices
https://github.com/rajivshah3/react-native-secure-clipboard

clipboard handoff react-native

Last synced: 25 days ago
JSON representation

Copy sensitive data to the iOS clipboard without making it available to other devices

• Host: GitHub
• URL: https://github.com/rajivshah3/react-native-secure-clipboard
• Owner: rajivshah3
• License: mit
• Created: 2018-04-22T03:41:03.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2022-02-11T16:25:07.000Z (almost 3 years ago)
• Last Synced: 2024-10-03T08:27:38.479Z (about 1 month ago)
• Topics: clipboard, handoff, react-native
• Language: Swift
• Homepage:
• Size: 461 KB
• Stars: 4
• Watchers: 4
• Forks: 0
• Open Issues: 16
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

README

        

# react-native-secure-clipboard

[![GitHub version](https://badge.fury.io/gh/rajivshah3%2Freact-native-secure-clipboard.svg)](https://badge.fury.io/gh/rajivshah3%2Freact-native-secure-clipboard)

[![Maintainability](https://api.codeclimate.com/v1/badges/7007ccd5751c6408c3b9/maintainability)](https://codeclimate.com/github/rajivshah3/react-native-secure-clipboard/maintainability)

[![Codacy Badge](https://api.codacy.com/project/badge/Grade/7440485a6dc6427d99185686c615fcb9)](https://app.codacy.com/app/rajivshah3/react-native-secure-clipboard?utm_source=github.com&utm_medium=referral&utm_content=rajivshah3/react-native-secure-clipboard&utm_campaign=badger)

## About

In iOS 10 and macOS Sierra, Apple introduced [Universal Clipboard](https://support.apple.com/kb/PH25168) as part of their Continuity feature set (also known as Handoff). While Universal Clipboard is normally a useful feature, sometimes this can pose a risk to sensitive data. Any sensitive data that is copied on an iOS device is now available on the Mac clipboard as well, allowing the data to be read by various apps and websites on the Mac. This module allows your React Native app to copy data to the iOS clipboard without making it available to the user's Mac by flagging it with the [localOnly option](https://developer.apple.com/documentation/uikit/uipasteboardoption/1829412-localonly).

## Getting started

`$ npm install react-native-secure-clipboard --save`

or

`$ yarn add react-native-secure-clipboard`

### Mostly automatic installation

`$ react-native link react-native-secure-clipboard`

### iOS

#### CocoaPods

1. Add the following line to your `Podfile`:

```

pod 'RNSecureClipboard', :path => '../node_modules/react-native-secure-clipboard'

```

2. Run `pod install`

#### Manual Installation

1. In XCode, in the project navigator, right click `Libraries` ➜ `Add Files to [your project's name]`

2. Go to `node_modules` ➜ `react-native-secure-clipboard` and add `RNSecureClipboard.xcodeproj`

3. In XCode, in the project navigator, select your project. Add `libRNSecureClipboard.a` to your project's `Build Phases` ➜ `Link Binary With Libraries`

4. Run your project (`Cmd+R`)

## Usage

```javascript

import RNSecureClipboard from 'react-native-secure-clipboard';

const str = "Copy this string to the clipboard";

RNSecureClipboard.setString(str);

```