# react-native-uuid > react-native-uuid is a zero-dependency TypeScript implementation of RFC4122. Latest version **2.0.4** (published 2026-03-20) · MIT license · 0 weekly downloads ## Install ```sh npm install react-native-uuid pnpm add react-native-uuid yarn add react-native-uuid bun add react-native-uuid ``` ## Health **Score 60/100 (C)** — status: active. Positive: has types; no vulnerabilities; high maintenance score; high quality score. Warnings: low downloads; no esm support. ## Facts | | | |---|---| | Version | 2.0.4 | | Published | 2026-03-20 | | First published | 2016-06-20 | | Weekly downloads | 0 | | License | MIT | | TypeScript types | bundled | | Module format | CommonJS | | Node | >=18.0.0 | | Dependencies | 0 | | Unpacked size | 68.4 KB | | Known vulnerabilities | 0 | | Install scripts | no | | GitHub stars | 293 | | Author | Eugene Hauptmann | | Maintainers | eugenehp | | Keywords | uuid, rfc4122, react-native, reactivelions | ## Links - npm: https://www.npmjs.com/package/react-native-uuid - Repository: https://github.com/eugenehp/react-native-uuid - Homepage: https://github.com/eugenehp/react-native-uuid#readme - Issues: https://github.com/eugenehp/react-native-uuid/issues - npm.io page: https://npm.io/package/react-native-uuid ## Alternatives - [@sindresorhus/slugify](https://npm.io/package/@sindresorhus/slugify.md) — 3.7M weekly downloads - [solid-js](https://npm.io/package/solid-js.md) — 2.7M weekly downloads - [expo-glass-effect](https://npm.io/package/expo-glass-effect.md) — 2.5M weekly downloads - [nanoassert](https://npm.io/package/nanoassert.md) — 780.8K weekly downloads - [@ffmpeg/ffmpeg](https://npm.io/package/@ffmpeg/ffmpeg.md) — 529.5K weekly downloads ## Recent versions - 2.0.4 (latest) — 2026-03-20 - 2.0.3 — 2024-11-11 - 2.0.2 — 2024-03-14 - 2.0.1 — 2021-04-10 - 2.0.0 — 2021-03-31 - 1.4.9 — 2016-11-18 - 1.4.8 — 2016-06-20 - 1.4.7 — 2016-06-20 ## README # react-native-uuid [![GitHub license](https://img.shields.io/github/license/eugenehp/react-native-uuid.svg?color=blue&style=for-the-badge)](./LICENSE) [![npm](https://img.shields.io/npm/v/react-native-uuid.svg?color=green&style=for-the-badge)](https://www.npmjs.com/package/react-native-uuid) [![npm downloads](https://img.shields.io/npm/dw/react-native-uuid.svg?label=npm%20downloads&style=for-the-badge)](https://npmcharts.com/compare/react-native-uuid?minimal=true) [![total npm downloads](https://img.shields.io/npm/dt/react-native-uuid.svg?label=total%20npm%20downloads&style=for-the-badge)](https://npmcharts.com/compare/react-native-uuid?minimal=true) [![GitHub watchers](https://img.shields.io/github/watchers/eugenehp/react-native-uuid.svg?style=for-the-badge)](https://github.com/eugenehp/react-native-uuid/watchers) [![GitHub stars](https://img.shields.io/github/stars/eugenehp/react-native-uuid.svg?label=GitHub%20stars&style=for-the-badge)](https://github.com/eugenehp/react-native-uuid/stargazers) [![GitHub forks](https://img.shields.io/github/forks/eugenehp/react-native-uuid.svg?style=for-the-badge)](https://github.com/eugenehp/react-native-uuid/network/members) [![open bugs](https://img.shields.io/github/issues-raw/eugenehp/react-native-uuid/bug.svg?color=d73a4a&label=open%20bugs&style=for-the-badge)](https://github.com/eugenehp/react-native-uuid/issues?utf8=%E2%9C%93&q=is%3Aissue+is%3Aopen+label%3Abug) [![total open issues](https://img.shields.io/github/issues-raw/eugenehp/react-native-uuid.svg?label=total%20open%20issues&style=for-the-badge)](https://github.com/eugenehp/react-native-uuid/issues) [![GitHub pull requests](https://img.shields.io/github/issues-pr-raw/eugenehp/react-native-uuid.svg?style=for-the-badge)](https://github.com/eugenehp/react-native-uuid/pulls) [![Packagephobia](https://badgen.net/packagephobia/install/react-native-uuid)](https://packagephobia.com/result?p=react-native-uuid) [![Bundlephobia](https://badgen.net/bundlephobia/min/react-native-uuid)](https://bundlephobia.com/result?p=react-native-uuid@2.0.0) [![CI Status](https://github.com/eugenehp/react-native-uuid/actions/workflows/ci.yml/badge.svg)](https://github.com/eugenehp/react-native-uuid/actions/workflows/ci.yml) [![Node.js Version](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen)](https://nodejs.org/en/) [![TypeScript](https://img.shields.io/badge/typescript-%3E%3D5.3.0-blue)](https://www.typescriptlang.org/) `react-native-uuid` is a zero-dependency TypeScript implementation of [RFC4122](https://tools.ietf.org/html/rfc4122) standard **A Universally Unique IDentifier (UUID) URN Namespace**. Please note, this library uses pseudo random generator based on top of `Math.random`. New version with hardware support is WIP. **Heavily inspired by:** - [uuid](https://github.com/uuidjs/uuid) - [pure-uuid](https://github.com/rse/pure-uuid) - [nanoid](https://www.npmjs.com/package/nanoid) Huge thanks to [Randy Coulman](https://github.com/randycoulman) for the early version of a code. ## Getting started ### Requirements - **Node.js**: 18.0.0 or higher (16.x also supported) - **npm**: 9.0.0 or higher ### Installation ```shell npm install react-native-uuid ``` ### Creating a UUID ```javascript import uuid from 'react-native-uuid'; uuid.v4(); // ⇨ '11edc52b-2918-4d71-9058-f7285e29d894' ``` ## Development ### Available Scripts ```bash # Install dependencies npm install # Run tests npm test npm test -- --watch # Watch mode npm test -- --coverage # With coverage report # Linting and formatting npm run lint # Lint TypeScript and JavaScript npm run prettier:write # Format all files npm run prettier:check # Check formatting without changes # Building npm run build # Build TypeScript to JavaScript npm run prepublishOnly # Build before publishing (auto on npm publish) # Benchmarking npm run bench:rn # Generate benchmark matrix for RN 0.71 - 0.77 npm run bench:security # Run security benchmark with pass/fail thresholds # Documentation npm run docs # Generate TypeDoc documentation ``` ## Benchmarking We keep a baseline benchmark matrix for major React Native versions: - React Native: 0.71, 0.72, 0.73, 0.74, 0.75, 0.76, 0.77 - Cases: `v1`, `v3`, `v4`, `v5`, `validate`, `parse`, `unparse` - Stored benchmark results: `benchmarks/results/rn-version-benchmark.md` - Stored benchmark data: `benchmarks/results/rn-version-benchmark.json` - Stored test report: `benchmarks/results/test-results.json` Generate fresh results locally: ```bash npm run bench:rn npm test -- --runInBand --json --outputFile benchmarks/results/test-results.json npm run bench:security npm run bench:figures ``` ### Charts ![React Native Benchmark Chart](./figures/rn-benchmark-chart.svg) ![Security Benchmark Chart](./figures/security-benchmark-chart.svg) ![Test Results Chart](./figures/test-results-chart.svg) ## Security Benchmarking The security benchmark is designed as a pass/fail gate for randomness quality and misuse safety checks. - Command: `npm run bench:security` - Stored report: `benchmarks/results/security-benchmark.md` - Stored data: `benchmarks/results/security-benchmark.json` - CI workflow: `.github/workflows/security-benchmark.yml` Current threshold gates: - v4 sample collisions: `0` - Cross-batch overlap (restart proxy): `0` - Monobit test z-score: `<= 4` - Runs test z-score: `<= 4` - RNG chi-square score (256 bins): `<= 420` - Malformed input crashes: `0` The CI job fails if any threshold is exceeded. ## Documentation Methods documentation is available [here](./docs/modules.md) ## Troubleshooting Previous version has been based on `randombytes` that is not compatible with react-native out of the box. Please submit an [issue](https://github.com/eugenehp/react-native-uuid/issues) if you found a bug. ## Contributing See the [contributing guide](CONTRIBUTING.md) to learn how to contribute to the repository and the development workflow. ## Sponsorship Thank you to our sponsors: [Reactive Lions™](https://www.reactivelions.com) ## License [MIT](./LICENSE) Copyright (c) 2016-2026 Eugene Hauptmann --- _Source: https://npm.io/package/react-native-uuid · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._