@hawcx/react-native-sdk 1.0.1

package/CHANGELOG.md

@@ -0,0 +1,10 @@
+# Changelog
+
+## [1.0.1] - 2025-11-17
+- Point native Android/iOS SDKs at new production authentication endpoint
+- Refresh bundled Hawcx Android/iOS binaries for the 1.0.1 cut
+- Harden linting by guarding React imports when running CocoaPods validation
+
+## [0.0.1] - 2025-11-15
+- Initial React Native bridge for Hawcx V5 authentication
+- Added HawcxClient helpers, hooks, push support, and example app

package/HawcxReactNative.podspec

@@ -0,0 +1,25 @@
+require 'json'
+package = JSON.parse(File.read(File.join(__dir__, 'package.json')))
+
+Pod::Spec.new do |s|
+  s.name         = 'HawcxReactNative'
+  s.version      = package['version']
+  s.summary      = 'React Native bindings for the Hawcx V5 mobile authentication framework.'
+  s.description  = <<-DESC
+    Production-grade React Native bridge that wraps HawcxFramework (iOS) to expose
+    V5 authentication, OTP, push, and web session flows to JavaScript callers.
+  DESC
+  s.homepage     = 'https://github.com/hawcx/react-native-sdk'
+  s.license      = { :type => 'MIT', :file => 'LICENSE' }
+  s.author       = { 'Hawcx Engineering' => 'engineering@hawcx.com' }
+  s.source       = { :git => 'https://github.com/hawcx/react-native-sdk.git', :tag => "v#{s.version}" }
+
+  s.platform     = :ios, '17.5'
+  s.swift_version = '5.9'
+
+  s.source_files = 'ios/**/*.{h,m,mm,swift}'
+  s.exclude_files = 'ios/Frameworks/**/*.h'
+  s.vendored_frameworks = 'ios/Frameworks/HawcxFramework.xcframework'
+
+  s.dependency 'React-Core'
+end

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Hawcx
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,109 @@
+# Hawcx React Native SDK (iOS)
+
+This package provides the React Native wrapper for the Hawcx V5 mobile authentication framework. It reuses the production iOS implementation (`dev_ios/ios_sdk/HawcxFramework`) and exposes a typed JavaScript/TypeScript API for React Native applications.
+
+## Repository Layout
+- `src/` – TypeScript entry point and public API surface.
+- `ios/` – Native bridge sources (Swift) plus the Podspec that embeds `HawcxFramework`.
+- `android/` – React Native Android bridge module (Gradle library) plus the bundled Hawcx SDK AAR.
+- `example/` – Runnable React Native demo app using the SDK (`npm install` -> `npm run ios`).
+- `react_mobile_sdk_plan.md` – Detailed delivery plan and progress tracker. **Always read and update this file when working on the SDK.**
+
+## Scripts
+| Command | Description |
+| --- | --- |
+| `npm run clean` | Removes the build output under `lib/`. |
+| `npm run lint` | Runs ESLint using the React Native + TypeScript rules. |
+| `npm run typecheck` | Executes the TypeScript compiler in `--noEmit` mode. |
+| `npm run build` | Builds distributable bundles via `react-native-builder-bob`. |
+
+> Note: Dependencies are declared in `package.json` but not yet installed. Install them once local tooling is in place (`npm install`).
+
+## Android Module (WIP)
+- `android/` hosts the Gradle-based library that React Native autolinks for Android builds. It already references the Hawcx Android SDK via `android/libs/hawcx-5.1.0.aar` and exposes `./gradlew` helpers for linting/publishing.
+- Run Gradle tasks from the repo root with `./gradlew -p android <task>` (for example, `./gradlew -p android :hawcxreactnative:lintRelease`). The first invocation requires network/Gradle cache access for AGP + React Native dependencies.
+- The bridge mirrors the iOS surface: `initialize`, `authenticate`, OTP/session helpers, push lifecycle (`setApnsDeviceToken` on iOS, `setFcmToken` on Android), and emits the same `hawcx.*` events for auth/session/push updates.
+- Android builds require `android/local.properties` pointing at your Android SDK (`sdk.dir=/Users/<you>/Library/Android/sdk`) and target `minSdkVersion` 26 to match the Hawcx AAR.
+
+### Refreshing the Hawcx Android SDK AAR
+1. Build the native Android SDK (`cd ~/dev_android/android_sdk && ./gradlew :app:assembleRelease`).
+2. Copy the generated `app/build/outputs/aar/hawcx-<version>.aar` into `android/libs/`, replacing the existing binary.
+3. Update any documentation or release notes (e.g., `react_mobile_sdk_plan.md`, `CHANGELOG.md`) to reflect the new Hawcx SDK version.
+
+## Usage (WIP)
+
+```ts
+import {
+  initialize,
+  authenticate,
+  submitOtp,
+  addAuthListener,
+  hawcxClient,
+  useHawcxAuth,
+  useHawcxWebLogin,
+} from '@hawcx/react-native-sdk';
+
+await initialize({ projectApiKey: 'YOUR_PROJECT_KEY' });
+
+const subscription = addAuthListener(event => {
+  switch (event.type) {
+    case 'otp_required':
+      // show OTP UI
+      break;
+    case 'auth_success':
+      console.log('Login success', event.payload);
+      break;
+    case 'auth_error':
+      console.error('Auth failed', event.payload.message);
+      break;
+  }
+});
+
+await authenticate('user@example.com');
+await submitOtp('123456');
+
+subscription.remove();
+
+// HawcxClient helper
+const { promise } = hawcxClient.authenticate('user@example.com', {
+  onOtpRequired: () => console.log('show OTP UI'),
+});
+const result = await promise; // -> { accessToken?, refreshToken?, isLoginFlow }
+
+// React hook example
+function AuthScreen() {
+  const { state, authenticate, submitOtp } = useHawcxAuth();
+
+  const start = () => authenticate('user@example.com');
+  const sendOtp = (otp: string) => submitOtp(otp);
+
+  return null;
+}
+
+function WebLoginScreen() {
+  const { state, webLogin, webApprove, getDeviceDetails } = useHawcxWebLogin();
+
+  const validatePin = (pin: string) => webLogin(pin);
+  const approveSession = (token: string) => webApprove(token);
+  const refreshDevices = () => getDeviceDetails();
+
+  return null;
+}
+```
+
+## Example App & E2E
+- `cd example && npm install` to bootstrap the sample app.
+- Edit `example/src/hawcx.config.ts` with your project API key plus the OAuth client ID, token endpoint, and PEM from `dev_ios/ios_demo_dev`, then run `npm run ios` or `npm run android`.
+- Use `example/e2e/hawcx-login.yaml` with [Maestro](https://maestro.mobile.dev/) to drive a smoke test through OTP login. Adjust selectors to match your bundle ID and UI tweaks.
+
+## Release Process
+Review `docs/RELEASE.md` before publishing. In short:
+1. Run `npm run lint && npm run typecheck && npm test && npm run build`.
+2. Update `package.json` + `CHANGELOG.md`.
+3. Smoke test the example app.
+4. `npm publish --access public` and `pod repo push trunk HawcxReactNative.podspec`.
+5. Tag the repo (`git tag vX.Y.Z && git push origin --tags`).
+
+## Next Steps
+1. Follow `react_mobile_sdk_plan.md` Phase 1+ to implement the native bridge and JS API.
+2. Keep this README updated with integration steps and release instructions as the SDK matures.

package/docs/RELEASE.md

@@ -0,0 +1,119 @@
+# Hawcx React Native SDK Release Guide
+
+This document outlines every command, directory, and deliverable required to publish `@hawcx/react-native-sdk` to npm and CocoaPods, tag the release, and hand it off to a customer.
+
+## Prerequisites
+- **npm access**
+  1. Create or use your npmjs.com account.
+  2. Ask an org admin to invite that account to the Hawcx org.
+  3. In the repo root run `npm login` and enter the same username/password + OTP.
+  4. Verify the session any time with `npm whoami`.
+- **CocoaPods trunk access**
+  1. Ensure CocoaPods is installed (`sudo gem install cocoapods`).
+  2. Register once: `pod trunk register you@hawcx.com "Your Name" --description='Hawcx laptop'`.
+  3. Click the verification email from CocoaPods.
+  4. Confirm you’re logged in with `pod trunk me` (shows your sessions).
+- Local environment with Xcode, npm, CocoaPods, and the Hawcx backend dev environment.
+- Clean working tree (`git status` should show no uncommitted changes apart from the release bump you are making).
+
+> All commands are run from the repo root (`~/dev_react`) unless a different directory is explicitly mentioned.
+
+## Step-by-step Release Process
+
+1. **Sync and verify**
+   ```bash
+   git checkout main
+   git pull origin main
+   git status
+   ```
+   Ensure only intentional release edits are showing as modified.
+
+2. **Run quality gates (repo root)**
+   ```bash
+   npm install        # ensures deps are fresh
+   npm run lint
+   npm run typecheck
+   npm test
+   npm run build      # produces lib/
+   ./gradlew -p android clean lintRelease testReleaseUnitTest assembleRelease publishToMavenLocal
+   pod lib lint HawcxReactNative.podspec
+   ```
+   - `./gradlew … publishToMavenLocal` validates the Android bridge (with the bundled Hawcx AAR) builds and can be published.
+   - `pod lib lint` confirms the Podspec + `HawcxFramework.xcframework` remain valid.
+
+3. **Update version + changelog (repo root)**
+   - Edit `package.json` → bump `version` (run `npm install` afterward so `package-lock.json` picks up the new number).
+   - Update `android/build.gradle`’s fallback `version` string and `example/package.json` (re-run `npm install` inside `example/` so its lockfile updates).
+   - Run `pod install` in `example/ios/` to refresh `Podfile.lock` with the new pod version.
+   - Update `CHANGELOG.md` with a new entry (features, fixes, dates, links).
+  - Commit these edits once testing passes:
+     ```bash
+    git add package.json package-lock.json android/build.gradle example/package.json example/package-lock.json example/ios/Podfile.lock CHANGELOG.md
+    git commit -m "chore: release vX.Y.Z"
+     ```
+    Include refreshed native artifacts (`ios/Frameworks/*.xcframework`, `android/libs/*.aar`) in the same commit when they change.
+
+4. **Smoke test the example app**
+   ```bash
+   cd example
+   npm install
+   npm run ios
+   npm run android
+   # Use your dev credentials in example/src/hawcx.config.ts
+   cd ..
+   ```
+   - For Android push validation, drop `google-services.json` under `example/android/app/` and use the push harness card to approve/decline a login request.
+   - Resolve any runtime issues before publishing.
+
+5. **Publish to npm (repo root)**
+   ```bash
+   npm publish --access public
+   ```
+   Share the published version number with the team.
+
+6. **Publish CocoaPods spec (repo root)**
+   ```bash
+   pod repo push trunk HawcxReactNative.podspec --allow-warnings
+   ```
+   Ensure the command finishes without validation errors. If you have trouble with trunk authentication, re-run `pod trunk register`.
+
+7. **Tag and push the release (repo root)**
+   ```bash
+   git tag vX.Y.Z
+   git push origin main
+   git push origin vX.Y.Z
+   ```
+   This creates a signed reference for future diffs.
+
+8. **Customer handoff checklist**
+   - Provide the npm version (`@hawcx/react-native-sdk@X.Y.Z`).
+   - For iOS, instruct them to run `pod install` after adding the dependency (Podspec is available once trunk syncs).
+   - For Android, emphasize that the Hawcx AAR ships inside the npm package—no manual drag/drop is needed. Running `npx pod-install` / Gradle sync is sufficient.
+   - Share `README.md` + `example/src/hawcx.config.ts` as guidance for wiring their project key + OAuth values.
+   - **Maintainer note:** if the native SDKs change, rebuild and copy the binaries before releasing:
+     - **iOS:** rebuild `HawcxFramework.xcframework`, copy it into `ios/Frameworks/`, bump the Podspec version if required, and re-run this release flow.
+     - **Android:** assemble the new `hawcx-*.aar` (`dev_android/android_sdk`), copy it into `android/libs/`, update docs/plan, then re-run this release flow.
+
+## Future updates / redeployments
+- Follow the same steps above for each change: bump the version, re-run quality gates, update changelog, publish to npm + trunk, tag, and notify.
+- If the native iOS SDK is updated (new `HawcxFramework.xcframework`), copy it into `ios/Frameworks/`, update `HawcxReactNative.podspec` if needed, and repeat the release flow.
+- Keep `react_mobile_sdk_plan.md` updated with new tasks/decisions so the next engineer understands why the release was cut.
+
+## How customers consume the SDK
+1. **npm**  
+   In their React Native project root:
+   ```bash
+   npm install @hawcx/react-native-sdk@X.Y.Z
+   ```
+2. **iOS pods**  
+   In their `ios/` folder (after installing npm deps):
+   ```bash
+   cd ios
+   pod install
+   ```
+3. **Initialize the bridge**  
+   Copy the pattern from `example/src/hawcx.config.ts` to pass their project API key + OAuth config into `initialize()`. The README in this repo explains every exported API (`initialize`, hooks, push helpers, etc.).
+
+Following this doc from top to bottom ensures the SDK release, npm publish, Podspec publish, git tagging, and customer delivery are handled consistently.
+
+Capture any issues in the changelog and notify the team once the release is live.

package/example/README.md

@@ -0,0 +1,59 @@
+# Hawcx React Native SDK Example
+
+This example demonstrates the cross-platform APIs exported by `@hawcx/react-native-sdk`. It mirrors the flows in the native reference apps (email/OTP login, web PIN validation, and manual push approvals) so you can validate your Hawcx project keys on both iOS and Android.
+
+## Getting Started
+
+1. Install dependencies:
+   ```bash
+   cd example
+   npm install
+   ```
+2. Configure credentials in `src/hawcx.config.ts`. The file ships with dev defaults—replace the API key and OAuth values with your own.
+3. **iOS only:** install pods:
+   ```bash
+   cd ios && pod install && cd ..
+   ```
+4. **Android (optional push support):**
+   - Create a Firebase project and enable Cloud Messaging.
+   - Download `google-services.json` and drop it into `android/app/`. The Gradle script automatically applies the Google Services plugin when this file exists.
+   - If you want to drive push approvals end-to-end, wire your push provider to send Hawcx payloads (see the push harness card in the app for the expected fields).
+5. Launch the app:
+   ```bash
+   npm run ios
+   # or
+   npm run android
+   ```
+
+## What It Demonstrates
+- `initialize()` via `hawcx.config.ts` so you can flip credentials without editing the UI.
+- `useHawcxAuth` hook for login + OTP entry.
+- `useHawcxWebLogin` to validate QR/PIN flows.
+- Manual push harness that lets you:
+  - Register APNs bytes (iOS) or an FCM token (Android) via `setPushDeviceToken`.
+  - Forward arbitrary push payload JSON to the native SDK and see emitted `hawcx.push.event` logs.
+  - Approve or decline login requests by submitting the `request_id`.
+- Logging card with an on/off switch so you can inspect auth/session/push events directly in the UI.
+
+## Push Harness Tips
+- On Android, paste the FCM token string and tap **Register Token** followed by **Notify Authenticated** once the user completes login. This calls `setFcmToken` + `userDidAuthenticate` so Hawcx can register for approvals.
+- On iOS, enter the APNs device token as a comma-separated list of byte values (e.g., `42, 13, 255, ...`). The helper converts it into the byte array expected by `setApnsDeviceToken`.
+- Use the payload editor to paste the JSON delivered by Hawcx push notifications—at minimum it must include `request_id`, `ip_address`, `deviceInfo`, and `timestamp`.
+
+## E2E Harness (Maestro)
+`e2e/hawcx-login.yaml` is a starting point for automated smoke tests:
+1. Launches the sample app (`appId: com.hawcx.example`)
+2. Types an email address
+3. Taps **Authenticate**
+4. Waits for the OTP prompt to appear
+
+Run it on either platform:
+```bash
+# iOS Simulator example
+maestro test e2e/hawcx-login.yaml
+
+# Android emulator example
+maestro test --device emulator-5554 e2e/hawcx-login.yaml
+```
+
+Customize the selectors, credentials, and OTP handling to match your environment. This same flow can be extended to cover push approvals, PIN validation, and regression checks on error states.

package/example/android/app/build.gradle

@@ -0,0 +1,126 @@
+apply plugin: "com.android.application"
+apply plugin: "org.jetbrains.kotlin.android"
+apply plugin: "com.facebook.react"
+
+/**
+ * This is the configuration block to customize your React Native Android app.
+ * By default you don't need to apply any configuration, just uncomment the lines you need.
+ */
+react {
+    /* Folders */
+    //   The root of your project, i.e. where "package.json" lives. Default is '..'
+    // root = file("../")
+    //   The folder where the react-native NPM package is. Default is ../node_modules/react-native
+    // reactNativeDir = file("../node_modules/react-native")
+    //   The folder where the react-native Codegen package is. Default is ../node_modules/@react-native/codegen
+    // codegenDir = file("../node_modules/@react-native/codegen")
+    //   The cli.js file which is the React Native CLI entrypoint. Default is ../node_modules/react-native/cli.js
+    // cliFile = file("../node_modules/react-native/cli.js")
+
+    /* Variants */
+    //   The list of variants to that are debuggable. For those we're going to
+    //   skip the bundling of the JS bundle and the assets. By default is just 'debug'.
+    //   If you add flavors like lite, prod, etc. you'll have to list your debuggableVariants.
+    // debuggableVariants = ["liteDebug", "prodDebug"]
+
+    /* Bundling */
+    //   A list containing the node command and its flags. Default is just 'node'.
+    // nodeExecutableAndArgs = ["node"]
+    //
+    //   The command to run when bundling. By default is 'bundle'
+    // bundleCommand = "ram-bundle"
+    //
+    //   The path to the CLI configuration file. Default is empty.
+    // bundleConfig = file(../rn-cli.config.js)
+    //
+    //   The name of the generated asset file containing your JS bundle
+    // bundleAssetName = "MyApplication.android.bundle"
+    //
+    //   The entry file for bundle generation. Default is 'index.android.js' or 'index.js'
+    // entryFile = file("../js/MyApplication.android.js")
+    //
+    //   A list of extra flags to pass to the 'bundle' commands.
+    //   See https://github.com/react-native-community/cli/blob/main/docs/commands.md#bundle
+    // extraPackagerArgs = []
+
+    /* Hermes Commands */
+    //   The hermes compiler command to run. By default it is 'hermesc'
+    // hermesCommand = "$rootDir/my-custom-hermesc/bin/hermesc"
+    //
+    //   The list of flags to pass to the Hermes compiler. By default is "-O", "-output-source-map"
+    // hermesFlags = ["-O", "-output-source-map"]
+}
+
+/**
+ * Set this to true to Run Proguard on Release builds to minify the Java bytecode.
+ */
+def enableProguardInReleaseBuilds = false
+
+/**
+ * The preferred build flavor of JavaScriptCore (JSC)
+ *
+ * For example, to use the international variant, you can use:
+ * `def jscFlavor = 'org.webkit:android-jsc-intl:+'`
+ *
+ * The international variant includes ICU i18n library and necessary data
+ * allowing to use e.g. `Date.toLocaleString` and `String.localeCompare` that
+ * give correct results when using with locales other than en-US. Note that
+ * this variant is about 6MiB larger per architecture than default.
+ */
+def jscFlavor = 'org.webkit:android-jsc:+'
+
+android {
+    ndkVersion rootProject.ext.ndkVersion
+    buildToolsVersion rootProject.ext.buildToolsVersion
+    compileSdk rootProject.ext.compileSdkVersion
+
+    namespace "com.hawcx.example"
+    defaultConfig {
+        applicationId "com.hawcx.example"
+        minSdkVersion rootProject.ext.minSdkVersion
+        targetSdkVersion rootProject.ext.targetSdkVersion
+        versionCode 1
+        versionName "1.0"
+    }
+    signingConfigs {
+        debug {
+            storeFile file('debug.keystore')
+            storePassword 'android'
+            keyAlias 'androiddebugkey'
+            keyPassword 'android'
+        }
+    }
+    buildTypes {
+        debug {
+            signingConfig signingConfigs.debug
+        }
+        release {
+            // Caution! In production, you need to generate your own keystore file.
+            // see https://reactnative.dev/docs/signed-apk-android.
+            signingConfig signingConfigs.debug
+            minifyEnabled enableProguardInReleaseBuilds
+            proguardFiles getDefaultProguardFile("proguard-android.txt"), "proguard-rules.pro"
+        }
+    }
+}
+
+dependencies {
+    // The version of react-native is set by the React Native Gradle Plugin
+    implementation("com.facebook.react:react-android")
+    implementation("com.facebook.react:flipper-integration")
+    implementation(platform("com.google.firebase:firebase-bom:33.1.1"))
+    implementation("com.google.firebase:firebase-messaging")
+
+    if (hermesEnabled.toBoolean()) {
+        implementation("com.facebook.react:hermes-android")
+    } else {
+        implementation jscFlavor
+    }
+}
+
+apply from: file("../../node_modules/@react-native-community/cli-platform-android/native_modules.gradle"); applyNativeModulesAppBuildGradle(project)
+
+def googleServicesFile = file("$projectDir/google-services.json")
+if (googleServicesFile.exists()) {
+    apply plugin: "com.google.gms.google-services"
+}

package/example/android/app/proguard-rules.pro

@@ -0,0 +1,10 @@
+# Add project specific ProGuard rules here.
+# By default, the flags in this file are appended to flags specified
+# in /usr/local/Cellar/android-sdk/24.3.3/tools/proguard/proguard-android.txt
+# You can edit the include path and order by changing the proguardFiles
+# directive in build.gradle.
+#
+# For more details, see
+#   http://developer.android.com/guide/developing/tools/proguard.html
+
+# Add any project specific keep options here:

package/example/android/app/src/debug/AndroidManifest.xml

@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:tools="http://schemas.android.com/tools">
+
+    <application
+        android:usesCleartextTraffic="true"
+        tools:targetApi="28"
+        tools:ignore="GoogleAppIndexingWarning"/>
+</manifest>

package/example/android/app/src/main/AndroidManifest.xml

@@ -0,0 +1,27 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:tools="http://schemas.android.com/tools">
+
+    <uses-permission android:name="android.permission.INTERNET" />
+
+    <application
+      android:name=".MainApplication"
+      android:label="@string/app_name"
+      android:icon="@mipmap/ic_launcher"
+      android:roundIcon="@mipmap/ic_launcher_round"
+      android:allowBackup="false"
+      android:theme="@style/AppTheme"
+      tools:replace="android:allowBackup,android:theme">
+      <activity
+        android:name=".MainActivity"
+        android:label="@string/app_name"
+        android:configChanges="keyboard|keyboardHidden|orientation|screenLayout|screenSize|smallestScreenSize|uiMode"
+        android:launchMode="singleTask"
+        android:windowSoftInputMode="adjustResize"
+        android:exported="true">
+        <intent-filter>
+            <action android:name="android.intent.action.MAIN" />
+            <category android:name="android.intent.category.LAUNCHER" />
+        </intent-filter>
+      </activity>
+    </application>
+</manifest>

package/example/android/app/src/main/java/com/hawcx/example/MainActivity.kt

@@ -0,0 +1,22 @@
+package com.hawcx.example
+
+import com.facebook.react.ReactActivity
+import com.facebook.react.ReactActivityDelegate
+import com.facebook.react.defaults.DefaultNewArchitectureEntryPoint.fabricEnabled
+import com.facebook.react.defaults.DefaultReactActivityDelegate
+
+class MainActivity : ReactActivity() {
+
+  /**
+   * Returns the name of the main component registered from JavaScript. This is used to schedule
+   * rendering of the component.
+   */
+  override fun getMainComponentName(): String = "HawcxExampleApp"
+
+  /**
+   * Returns the instance of the [ReactActivityDelegate]. We use [DefaultReactActivityDelegate]
+   * which allows you to enable New Architecture with a single boolean flags [fabricEnabled]
+   */
+  override fun createReactActivityDelegate(): ReactActivityDelegate =
+      DefaultReactActivityDelegate(this, mainComponentName, fabricEnabled)
+}

package/example/android/app/src/main/java/com/hawcx/example/MainApplication.kt

@@ -0,0 +1,45 @@
+package com.hawcx.example
+
+import android.app.Application
+import com.facebook.react.PackageList
+import com.facebook.react.ReactApplication
+import com.facebook.react.ReactHost
+import com.facebook.react.ReactNativeHost
+import com.facebook.react.ReactPackage
+import com.facebook.react.defaults.DefaultNewArchitectureEntryPoint.load
+import com.facebook.react.defaults.DefaultReactHost.getDefaultReactHost
+import com.facebook.react.defaults.DefaultReactNativeHost
+import com.facebook.react.flipper.ReactNativeFlipper
+import com.facebook.soloader.SoLoader
+
+class MainApplication : Application(), ReactApplication {
+
+  override val reactNativeHost: ReactNativeHost =
+      object : DefaultReactNativeHost(this) {
+        override fun getPackages(): List<ReactPackage> =
+            PackageList(this).packages.apply {
+              // Packages that cannot be autolinked yet can be added manually here, for example:
+              // add(MyReactNativePackage())
+            }
+
+        override fun getJSMainModuleName(): String = "index"
+
+        override fun getUseDeveloperSupport(): Boolean = BuildConfig.DEBUG
+
+        override val isNewArchEnabled: Boolean = BuildConfig.IS_NEW_ARCHITECTURE_ENABLED
+        override val isHermesEnabled: Boolean = BuildConfig.IS_HERMES_ENABLED
+      }
+
+  override val reactHost: ReactHost
+    get() = getDefaultReactHost(this.applicationContext, reactNativeHost)
+
+  override fun onCreate() {
+    super.onCreate()
+    SoLoader.init(this, false)
+    if (BuildConfig.IS_NEW_ARCHITECTURE_ENABLED) {
+      // If you opted-in for the New Architecture, we load the native entry point for this app.
+      load()
+    }
+    ReactNativeFlipper.initializeFlipper(this, reactNativeHost.reactInstanceManager)
+  }
+}

package/example/android/app/src/main/res/drawable/rn_edit_text_material.xml

@@ -0,0 +1,36 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Copyright (C) 2014 The Android Open Source Project
+
+     Licensed under the Apache License, Version 2.0 (the "License");
+     you may not use this file except in compliance with the License.
+     You may obtain a copy of the License at
+
+          http://www.apache.org/licenses/LICENSE-2.0
+
+     Unless required by applicable law or agreed to in writing, software
+     distributed under the License is distributed on an "AS IS" BASIS,
+     WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+     See the License for the specific language governing permissions and
+     limitations under the License.
+-->
+<inset xmlns:android="http://schemas.android.com/apk/res/android"
+       android:insetLeft="@dimen/abc_edit_text_inset_horizontal_material"
+       android:insetRight="@dimen/abc_edit_text_inset_horizontal_material"
+       android:insetTop="@dimen/abc_edit_text_inset_top_material"
+       android:insetBottom="@dimen/abc_edit_text_inset_bottom_material">
+
+    <selector>
+        <!--
+          This file is a copy of abc_edit_text_material (https://bit.ly/3k8fX7I).
+          The item below with state_pressed="false" and state_focused="false" causes a NullPointerException.
+          NullPointerException:tempt to invoke virtual method 'android.graphics.drawable.Drawable android.graphics.drawable.Drawable$ConstantState.newDrawable(android.content.res.Resources)'
+
+          <item android:state_pressed="false" android:state_focused="false" android:drawable="@drawable/abc_textfield_default_mtrl_alpha"/>
+
+          For more info, see https://bit.ly/3CdLStv (react-native/pull/29452) and https://bit.ly/3nxOMoR.
+        -->
+        <item android:state_enabled="false" android:drawable="@drawable/abc_textfield_default_mtrl_alpha"/>
+        <item android:drawable="@drawable/abc_textfield_activated_mtrl_alpha"/>
+    </selector>
+
+</inset>