Skip to content
UUID generator for React Native utilizing native iOS and Android UUID classes
Objective-C Java JavaScript Python Ruby
Branch: master
Clone or download
Latest commit f599023 Aug 25, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
android Update build.gradle Jul 10, 2019
example rename java package namespacing to match my personal web domain Jun 4, 2018
ios update for react v0.40 Feb 2, 2017
media Add screen capture and update README Aug 30, 2016
.gitignore ignore android local properties Sep 15, 2017 rename java package namespacing to match my personal web domain Jun 4, 2018
LICENSE add license and package.json description Aug 14, 2016 rename java package namespacing to match my personal web domain Jun 4, 2018
index.js suport promise based interface Sep 17, 2016
react-native-uuid-generator.podspec Add pod support (make autolink work on iOS with react-native >= 0.60.0) Jul 23, 2019


npm version downloads

A simple wrapper around the native iOS and Android UUID classes. Exposes a single method, getRandomUUID.

Example App Screen Capture

Getting started

$ npm install react-native-uuid-generator --save

$ react-native link react-native-uuid-generator


This library supports both callback and promise interfaces.

import UUIDGenerator from 'react-native-uuid-generator';

// Callback interface
UUIDGenerator.getRandomUUID((uuid) => {
// => "42A8A87A-F71C-446B-B81D-0CD16A709625"

// Promise interface
UUIDGenerator.getRandomUUID().then((uuid) => {
// => "BD6120BD-3612-4D56-8957-99F5D6F02C52"

Manual installation

If the react-native link command doesn't work, you can also install the native components of this library manually.


  1. In XCode, in the project navigator, right click LibrariesAdd Files to [your project's name]
  2. Go to node_modulesreact-native-uuid-generator and add RNUUIDGenerator.xcodeproj
  3. In XCode, in the project navigator, select your project. Add libRNUUIDGenerator.a to your project's Build PhasesLink Binary With Libraries
  4. Run your project (Cmd+R)<


  1. Open up android/app/src/main/java/[...]/
  • Add import io.github.traviskn.rnuuidgenerator.RNUUIDGeneratorPackage; to the imports at the top of the file
  • Add new RNUUIDGeneratorPackage() to the list returned by the getPackages() method
  1. Append the following lines to android/settings.gradle:
  include ':react-native-uuid-generator'
  project(':react-native-uuid-generator').projectDir = new File(rootProject.projectDir,   '../node_modules/react-native-uuid-generator/android')
  1. Insert the following lines inside the dependencies block in android/app/build.gradle:
  compile project(':react-native-uuid-generator')


See the changelog for instructions on upgrading to the latest version.


Check out the example app included in the github repo to see the UUID Generator in action! I assume you already have the react-native-cli installed, as well as the required iOS or Android dependencies.

git clone

cd react-native-uuid-generator/example
npm install

Use react-native run-ios or react-native run-android to run the example.

You can’t perform that action at this time.