What is this?
@onekeyfe/app-modules is the native package monorepo behind the OneKey wallet.
It wraps the platform capabilities the app depends on — cryptography, secure
storage, networking, push, OTA bundle updates, NFC cards, cloud backup and the
wallet's list, pager, tab bar, image and overlay views — as Nitro
Modules and Fabric views.
Every package is published to npm as @onekeyfe/react-native-* with one
synchronized version (currently 6.7.0-46), so the app upgrades the whole
native layer at once. Packages are built for OneKey's own app; the ones with an
upstream project keep an Upstream attribution section in their README and the
upstream license notice in their LICENSE.
The stable and test badges above follow the npm latest and next dist-tags of
@onekeyfe/react-native-native-list, which shares the synchronized version.
Packages
Native modules (32)
| Package |
What it does |
Spec |
| react-native-native-logger |
Native file logging with redaction, repeat suppression, bounded rotation and log export. |
— |
| react-native-aes-crypto |
Native AES-CBC/CTR/GCM, PBKDF2, HMAC, hashing and secure random values. |
— |
| react-native-app-update |
Android APK download, signature verification and installation (iOS stubs). |
✓ |
| react-native-async-storage |
AsyncStorage-compatible string storage with cross-runtime write forwarding. |
— |
| react-native-background-thread |
A second JS runtime plus a shared store/RPC bridge and targeted restarts. |
— |
| react-native-bundle-crypto |
Update signature verification, file/directory hashing and safe file operations. |
✓ |
| react-native-bundle-update |
OTA bundle download, verification, install/switch and runtime bundle paths. |
✓ |
| react-native-capture-protection |
Screenshot, recording and app-switcher protection without media permissions. |
✓ |
| react-native-check-biometric-auth-changed |
Detects changes to the stored iOS biometric authentication state. |
✓ |
| react-native-cloud-fs |
iCloud (iOS) and Google Drive (Android) file access through one API. |
— |
| react-native-cloud-kit-module |
CloudKit account status and private-record storage (iOS). |
— |
| react-native-device-utils |
Host integration helpers: launch options, device tokens, dual-screen/iPadOS windows, nav-bar styling, boot recovery and a bounded in-memory store. |
✓ |
| react-native-dns-lookup |
Native hostname resolution returning resolver addresses only, with no transport decision. |
— |
| react-native-get-random-values |
Native-backed crypto.getRandomValues polyfill plus getRandomBase64. |
— |
| react-native-image-crop-picker |
System single-photo picker and shared cropper without photo-library permission. |
✓ |
| react-native-jpush |
Clean-room JPush/JCore client with a jpush-react-native-compatible JS API. |
✓ |
| react-native-keychain-module |
iOS Keychain string storage with optional iCloud synchronization. |
— |
| react-native-lite-card |
OneKey Lite NFC card info, mnemonic backup/restore, PIN change and reset. |
✓ |
| react-native-network-info |
Read-only IP/gateway/subnet and Wi-Fi query getters. |
✓ |
| react-native-network-throttle |
Latency/throughput throttling for React Native's own HTTP stack, for diagnostics. |
— |
| react-native-pbkdf2 |
Native PBKDF2 derivation (CommonCrypto / SpongyCastle) with Base64 inputs and output. |
— |
| react-native-perf-memory |
On-demand native process memory sample, in bytes. |
— |
| react-native-perf-stats |
Native CPU/RAM/UI-FPS/JS-FPS sampling with a draggable overlay and memory-pressure hooks. |
— |
| react-native-photo-library |
Add-only photo saving without whole-library read access. |
✓ |
| react-native-ping |
One-shot ICMP ping that resolves the round-trip time in milliseconds. |
— |
| react-native-range-downloader |
Resumable multi-connection HTTP range downloads with typed fallback outcomes and firmware artifact staging. |
✓ |
| react-native-sni-connect |
HTTPS requests to a pinned IP that keep real-hostname SNI and certificate validation. |
✓ |
| react-native-splash-screen |
Retains and hides the legacy Android splash overlay until startup is ready; iOS is a no-op. |
— |
| react-native-split-bundle-loader |
Resolve, verify and evaluate split JS bundle segments in the running runtime. |
— |
| react-native-tcp-socket |
One-shot TCP connection probes with a measured connect time. |
— |
| react-native-webview-cleaner |
Fire-and-forget clearing of app-wide WebView website data. |
✓ |
| react-native-zip-archive |
Native ZIP extraction/creation with size inspection and iOS password support. |
— |
Native views (13)
Each package README follows the README guide and links
its behavior contract (docs/SPEC.md) where one exists. The spec is authoritative;
the README is the quick path in.
Requirements
| Requirement |
Version |
| React Native |
0.88, new architecture |
react-native-nitro-modules |
0.37.0 |
| Node.js |
>= 20 |
| Yarn |
4.1.0 |
| iOS |
16.4+ |
| Android |
minSdk 24, compile/target SDK 36 |
| Build tools |
Xcode, CocoaPods, the Ruby in example/react-native/.ruby-version |
Getting started
Install one package together with the Nitro runtime, then rebuild the native app:
yarn add @onekeyfe/react-native-skeleton react-native-nitro-modules
(cd ios && pod install) # iOS
import { SkeletonView } from '@onekeyfe/react-native-skeleton';
<SkeletonView style={{ width: 160, height: 24, borderRadius: 6 }} />;
Every package needs the new architecture and a native rebuild — installing the
JavaScript package alone does not register its native object or view. Android
links packages through autolinking; iOS needs pod install.
Repository layout
app-modules/
├── native-modules/ # 32 Nitro modules (headless native APIs)
├── native-views/ # 13 Fabric views (native UI)
├── chain-runtimes/ # Rust Zcash and Monero runtimes, built separately
├── example/react-native/ # example app consuming every package via workspace:*
├── docs/ # development requirements, release process, README guide
├── scripts/ # generators, versioning and publishing tooling
└── CHANGELOG.md
Development
yarn install # install the workspace
yarn lint:test-integrity # repository test-integrity check
# Example app (iOS also needs the gems and pods first)
(cd example/react-native && bundle install && bundle exec pod install)
yarn workspace @onekeyfe/app-modules-example start
yarn workspace @onekeyfe/app-modules-example ios # or: android
Each package exposes its own scripts; run one through the workspace name:
yarn workspace @onekeyfe/react-native-native-list typecheck
yarn workspace @onekeyfe/react-native-native-list lint
yarn workspace @onekeyfe/react-native-native-list test
Native work must follow the
Native Module Development Requirements:
initialize new packages from the checked-in template (yarn create:module /
yarn create:view), define the public contract in the package docs/SPEC.md
before implementing it, and keep the spec and code in the same change.
Releases
All publishable packages share one version tied to the target App baseline:
- A merged PR to
main publishes a stable latest release automatically.
- Development branches publish
alpha.N previews with next only when the
package-publish workflow is run manually.
The current stable release is 6.7.0-46 (2026-11-11). The full process —
version commands, revision selection, dist-tag validation and single-workspace
recovery — lives in docs/RELEASE.md; per-release notes live in
CHANGELOG.md.
Documentation
| Document |
Contents |
| Native Module Development |
Required workflow for modules and views, including the spec-first contract. |
| Releases |
Synchronized versioning, publish automation and recovery. |
| README guide |
Required structure for package READMEs. |
| Changelog |
Notable changes for each published release. |
docs/SPEC.md (per package) |
Authoritative behavioral contract, limits and platform differences. |
Chain runtimes
Rust chain libraries for Zcash and Monero live in
chain-runtimes, separately from the React Native
workspaces; see that README for build and test commands.
License
MIT. Each package ships its own LICENSE
file; forked packages keep their upstream notices and attribution.