Feat: React Native Showcase App with Cloud Backup by NirmalPatidar · Pull Request #31 · tetherto/wdk-examples

NirmalPatidar · 2026-07-02T10:50:16Z

This PR builds on top of the React Native Showcase work introduced in #15 by adding a complete Cloud Backup demonstration and testing experience to the showcase application.

The goal is to provide a dedicated UI that allows developers to validate and test the full Cloud Backup workflow end-to-end on both iOS and Android.

What's Included
☁️ Cloud Backup Showcase
Added a new Cloud Backup screen to the React Native Showcase application.
Provides a dedicated interface for testing all Cloud Backup functionality.
🔐 Authentication
Implemented login and logout flows for:
Apple CloudKit (iOS)
Google Drive (Android)
Displays the current authentication status.
📦 Cloud Backup Operations

Implemented support for testing the complete Cloud Backup lifecycle:

Create encrypted cloud backups
Restore backups from the cloud
Delete existing backups
Check backup availability
Display operation status and errors
Validate end-to-end backup and restore flows
🧪 Developer Experience
Added a simple UI for exercising all Cloud Backup APIs.
Makes it easier to validate Cloud Backup functionality during development and QA.
Helps reproduce and debug platform-specific issues.
📚 Documentation
Updated the Showcase documentation.
Added Cloud Backup documentation and setup guide.
Separated general project documentation from Cloud Backup configuration documentation.
Testing

Tested on:

✅ Android (Google Drive)
✅ iOS (CloudKit)

Verified:

Authentication
Backup creation
Backup restoration
Backup deletion
Logout/Login flows
Error handling
UI integration
Related

Builds on top of #15.

claudiovb

Solid showcase overall!
I did a first pass (didn't get to test Google yet, will do on a next run).
From this pass I got minor issues and two problems:

First-time iCloud connect never completes on iOS. The auth hangs after Apple sign-in + 2FA (details in the CloudKitAuthWebView comment).
A fresh clone currently can't build or run and there's four separate causes, each with a fix in the inline comments (the postinstall one is root-caused upstream: tetherto/wdk-worklet-bundler#34).

claudiovb · 2026-07-10T01:21:56Z

+  "main": "expo-router/entry",
+  "description": "Showcase application for WDK (Wallet Development Kit) features in React Native",
+  "scripts": {
+    "postinstall": "wdk-worklet-bundler generate",


On a fresh clone, npm install completes but never generates the worklet bundle: @bitcoinerlab/descriptors (via wdk-wallet-btc) declares @ledgerhq/ledger-bitcoin@^0.3.1 as an optional peer, and the bundler prompts interactively for it this causes the app to fail at runtime with no hint. Root cause is in wdk-worklet-bundler, fixed in tetherto/wdk-worklet-bundler#34:
Verified end-to-end against the fix branch. Fresh install generates the bundle non-interactively and the app runs. No action for now apart from maybe adding ledger-bitcoin dep here so its functional for everyone but once that lands in a release, bump the bundler version here;

claudiovb · 2026-07-10T01:22:48Z

+    "react-native-screens": "~4.23.0",
+    "react-native-svg": "15.15.3",
+    "react-native-webview": "13.16.0",
+    "react-native-worklet": "^0.0.0",


This is an empty npm name-reservation package (no code), looks like a typo alongside react-native-worklets on the next line. Remove

Suggested change

"react-native-worklet": "^0.0.0",

claudiovb · 2026-07-10T01:23:25Z

+    "sonner-native": "^0.21.1",
+    "utf-8-validate": "^5.0.10"
+  },
+  "devDependencies": {


babel.config.js uses babel-preset-expo but it's not declared here... It currently resolves only via hoisting luck from expo's nested copy, and on my install it ended up unresolvable (Metro fails with Cannot find module 'babel-preset-expo'). Please add it to devDependencies pinned to the SDK 55 line (~55.0.23): unpinned installs the SDK 57 preset today, which transforms incompatibly and crashes at startup with ReferenceError: Property 'MessageQueue' doesn't exist.

claudiovb · 2026-07-10T01:24:17Z

+dist/
+ios/
+android/
+package-lock.json


Please stop ignoring the lockfile and commit it, every other example app in this repo commits one.
It causes many deps issues

claudiovb · 2026-07-10T01:25:57Z

+      [
+        "expo-build-properties",
+        {
+          "android": {
+            "minSdkVersion": 29
+          }
+        }
+      ]


A clean expo run:ios fails at pod install: AppCheckCore (google-signin) and the SwiftNIO/gRPC-Swift pods (spark) need modular headers. Since ios/ is gitignored and regenerated by prebuild, the fix has to live in config: please add a small Expo config plugin that injects :modular_headers => true for GoogleUtilities, RecaptchaInterop, the CNIO* pods and CGRPCZlib into the Podfile. Note "useFrameworks": "static" is not a viable alternative (I tried and it breaks the app)

claudiovb · 2026-07-10T01:42:21Z

+## Environment Variables
+
+Create a `.env` file and configure the required values.
+


Missing the opening ``` fence (the closing one is at L136) on GitHub's rendered view the # ── lines display as giant H1 headings.

claudiovb · 2026-07-10T01:43:12Z

+│   └── features/       # Self-contained feature modules
+│       ├── wallet/     # Wallet logic (Balance, Transfer, Mgmt)
+│       ├── cloud/      # Cloud backup logic (upload, download, delete, exist, etc)
+│       └── config/     # Configuration viewers


This directory doesn't exist in the tree (only features/cloud/ and features/wallet/). Please fix the architecture diagram. Also anything else that might be stale on the readME

claudiovb · 2026-07-10T01:43:52Z

+- **UI Smoothness**: Heavy crypto math never blocks the main thread.
+- **Security**: Sensitive key operations are isolated from the main UI context.
+
+## 🏁 Getting Started


Please add a "copy .env.example → .env and fill providers" step, to guide users on how to build it.

claudiovb · 2026-07-10T01:46:57Z

+    setTxHash('');
+    try {
+      const result = await sendPromise;
+      setTxHash(result?.hash);


Failed sends are silently swallowed as successes here. The native path (account.send(...), L63) doesn't throw on failure, it resolves with {success: false, error: ...}, so the catch below never runs: this line sets an empty hash, the form clears, and the user thinks the transfer went through. Please check the result and show a toast/alert with result.error when success is false, instead of treating every resolved promise as a success.

claudiovb · 2026-07-10T01:47:21Z

+          <TouchableOpacity 
+            style={[styles.sendButton, (!account || isSending) && styles.sendButtonDisabled]}
+            onPress={handleSend}
+            disabled={!account || isSending}


Minor: !account never triggers here (nor the guard at L44), useAccount always returns a truthy proxy, so the button isn't actually disabled while the account is loading.

nulllpc · 2026-07-13T15:47:04Z

@@ -0,0 +1,35 @@
+EXPO_PUBLIC_BTC_PROVIDER=https://your-blockbook-instance.example.com


I think we can link to the wdk-docs here on how to retrieve these env vars

NirmalPatidar · 2026-07-14T07:18:41Z

All review comments addressed. Key changes: removed react-native-worklet, added babel-preset-expo, committed lockfile, added withModularHeaders plugin for iOS pod install, fixed CloudKit sign-out WebView clearing, removed ?? '' passphrase fallback, gated recovery material logs behind DEV, fixed TRON BigInt crash, fixed silent send failure, moved payloadEncryption.ts out of app/ router tree, and updated docs.

nulllpc · 2026-07-15T11:39:28Z

I re-approved, but I think you should resolve the comments @NirmalPatidar

claudiovb · 2026-07-16T18:39:54Z

+    "expo-crypto": "~55.0.16"
+  },
+  "dependencies": {
+    "@ledgerhq/ledger-bitcoin": "^0.3.1",


remove ledger dep is not needed anymore

claudiovb · 2026-07-16T18:40:07Z

+    "expo-splash-screen": "~55.0.20",
+    "expo-status-bar": "~55.0.6",
+    "expo-system-ui": "^55.0.17",
+    "ledger-bitcoin": "^0.2.3",


this one too

claudiovb · 2026-07-18T00:05:31Z

+  "author": "Tether",
+  "license": "Apache-2.0",
+  "overrides": {
+    "@tetherto/wdk-worklet-bundler": "github:claudiovb/wdk-worklet-bundler#1faee66fcc03acc172689e5d6a4406714399366a",


Is there a reason for the bundler override ? I think this one could be removed as well, its pinned on dev-deps already different case than the other three below...

claudiovb

LGTM

…the demo .env.example as a faster alternative than setting up a whole env

nulllpc and others added 2 commits June 18, 2026 22:56

Add rn-showcase app

dd8d3ce

feat: Added cloud backup functionality to react native showcase app

be734f3

claudiovb requested changes Jul 10, 2026

View reviewed changes

nulllpc previously approved these changes Jul 13, 2026

View reviewed changes

Addresses all PR review comments from claudiovb and nulllpc

e2ad2b4

NirmalPatidar dismissed nulllpc’s stale review via e2ad2b4 July 14, 2026 07:16

nulllpc previously approved these changes Jul 15, 2026

View reviewed changes

claudiovb reviewed Jul 16, 2026

View reviewed changes

claudiovb mentioned this pull request Jul 16, 2026

fix: don't defer optional peers that are present nested (breaks Spark when BTC's bitcoinerlab marks scure optional) tetherto/wdk-worklet-bundler#38

Merged

1 task

Fix example rn app crashing

786315c

nulllpc dismissed their stale review via 786315c July 17, 2026 14:54

claudiovb reviewed Jul 18, 2026

View reviewed changes

Replaced custom enryption methods with wdk-utils

be25785

nulllpc previously approved these changes Jul 20, 2026

View reviewed changes

NIT updates

3076bf7

claudiovb dismissed nulllpc’s stale review via 3076bf7 July 20, 2026 20:49

Make Android package env-driven so anyone can test Google Drive backup

2d7ae45

claudiovb previously approved these changes Jul 21, 2026

View reviewed changes

Add step 0 as an android quick start - add a published Web Client to …

944be1d

…the demo .env.example as a faster alternative than setting up a whole env

claudiovb dismissed their stale review via 944be1d July 21, 2026 14:41

claudiovb approved these changes Jul 21, 2026

View reviewed changes

jonathunne merged commit 1df6af6 into tetherto:main Jul 22, 2026
7 of 8 checks passed

		## Environment Variables

		Create a `.env` file and configure the required values.

		@@ -0,0 +1,35 @@
		EXPO_PUBLIC_BTC_PROVIDER=https://your-blockbook-instance.example.com

Uh oh!

Conversation

NirmalPatidar commented Jul 2, 2026

Uh oh!

claudiovb left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

NirmalPatidar commented Jul 14, 2026

Uh oh!

nulllpc commented Jul 15, 2026

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

claudiovb left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants