diff --git a/packages/browser-sdk/package.json b/packages/browser-sdk/package.json
index 230bccaf..c9c13870 100644
--- a/packages/browser-sdk/package.json
+++ b/packages/browser-sdk/package.json
@@ -1,6 +1,6 @@
{
"name": "@reflag/browser-sdk",
- "version": "1.4.1",
+ "version": "1.4.2",
"packageManager": "yarn@4.1.1",
"license": "MIT",
"repository": {
diff --git a/packages/browser-sdk/src/httpClient.ts b/packages/browser-sdk/src/httpClient.ts
index 14f584c3..bf9f207a 100644
--- a/packages/browser-sdk/src/httpClient.ts
+++ b/packages/browser-sdk/src/httpClient.ts
@@ -51,8 +51,13 @@ export class HttpClient {
params.set(SDK_VERSION_HEADER_NAME, this.sdkVersion);
params.set("publishableKey", this.publishableKey);
- const url = this.getUrl(path);
- url.search = params.toString();
+ // Do not assign `url.search` directly: some React Native URL implementations
+ // expose `search` as getter-only and throw at runtime on assignment.
+ const query = params.toString();
+ const pathWithQuery = query
+ ? `${path}${path.includes("?") ? "&" : "?"}${query}`
+ : path;
+ const url = this.getUrl(pathWithQuery);
if (timeoutMs === undefined) {
return fetch(url, this.fetchOptions);
diff --git a/packages/browser-sdk/test/httpClient.test.ts b/packages/browser-sdk/test/httpClient.test.ts
index a885d99d..9389b5ec 100644
--- a/packages/browser-sdk/test/httpClient.test.ts
+++ b/packages/browser-sdk/test/httpClient.test.ts
@@ -63,4 +63,37 @@ describe("sets `credentials`", () => {
expect.objectContaining({ credentials: "include" }),
);
});
+
+ test("does not require a writable `URL.search` property", async () => {
+ const OriginalURL = global.URL;
+
+ class ReadonlySearchURL extends OriginalURL {
+ get search() {
+ return super.search;
+ }
+
+ set search(_value: string) {
+ throw new TypeError(
+ "Cannot assign to property 'search' which has only a getter",
+ );
+ }
+ }
+
+ global.URL = ReadonlySearchURL as unknown as typeof URL;
+
+ try {
+ const client = new HttpClient("publishableKey");
+ await client.get({
+ path: "/test",
+ params: new URLSearchParams({ hello: "world" }),
+ });
+
+ const [firstArg] = vi.mocked(global.fetch).mock.calls[0]!;
+ const url = new OriginalURL(String(firstArg));
+ expect(url.searchParams.get("hello")).toBe("world");
+ expect(url.searchParams.get("publishableKey")).toBe("publishableKey");
+ } finally {
+ global.URL = OriginalURL;
+ }
+ });
});
diff --git a/packages/react-native-sdk/dev/bare-rn/.eslintrc.js b/packages/react-native-sdk/dev/bare-rn/.eslintrc.js
new file mode 100644
index 00000000..187894b6
--- /dev/null
+++ b/packages/react-native-sdk/dev/bare-rn/.eslintrc.js
@@ -0,0 +1,4 @@
+module.exports = {
+ root: true,
+ extends: '@react-native',
+};
diff --git a/packages/react-native-sdk/dev/bare-rn/.gitignore b/packages/react-native-sdk/dev/bare-rn/.gitignore
new file mode 100644
index 00000000..beacfa68
--- /dev/null
+++ b/packages/react-native-sdk/dev/bare-rn/.gitignore
@@ -0,0 +1,76 @@
+# OSX
+#
+.DS_Store
+
+# Xcode
+#
+build/
+*.pbxuser
+!default.pbxuser
+*.mode1v3
+!default.mode1v3
+*.mode2v3
+!default.mode2v3
+*.perspectivev3
+!default.perspectivev3
+xcuserdata
+*.xccheckout
+*.moved-aside
+DerivedData
+*.hmap
+*.ipa
+*.xcuserstate
+**/.xcode.env.local
+
+# Android/IntelliJ
+#
+build/
+.idea
+.gradle
+local.properties
+*.iml
+*.hprof
+.cxx/
+*.keystore
+!debug.keystore
+.kotlin/
+
+# node.js
+#
+node_modules/
+npm-debug.log
+yarn-error.log
+
+# fastlane
+#
+# It is recommended to not store the screenshots in the git repo. Instead, use fastlane to re-generate the
+# screenshots whenever they are needed.
+# For more information about the recommended setup visit:
+# https://docs.fastlane.tools/best-practices/source-control/
+
+**/fastlane/report.xml
+**/fastlane/Preview.html
+**/fastlane/screenshots
+**/fastlane/test_output
+
+# Bundle artifact
+*.jsbundle
+
+# Ruby / CocoaPods
+**/Pods/
+/vendor/bundle/
+.bundle/
+
+# Temporary files created by Metro to check the health of the file watcher
+.metro-health-check*
+
+# testing
+/coverage
+
+# Yarn
+.yarn/*
+!.yarn/patches
+!.yarn/plugins
+!.yarn/releases
+!.yarn/sdks
+!.yarn/versions
diff --git a/packages/react-native-sdk/dev/bare-rn/.prettierrc.js b/packages/react-native-sdk/dev/bare-rn/.prettierrc.js
new file mode 100644
index 00000000..06860c8d
--- /dev/null
+++ b/packages/react-native-sdk/dev/bare-rn/.prettierrc.js
@@ -0,0 +1,5 @@
+module.exports = {
+ arrowParens: 'avoid',
+ singleQuote: true,
+ trailingComma: 'all',
+};
diff --git a/packages/react-native-sdk/dev/bare-rn/.watchmanconfig b/packages/react-native-sdk/dev/bare-rn/.watchmanconfig
new file mode 100644
index 00000000..0967ef42
--- /dev/null
+++ b/packages/react-native-sdk/dev/bare-rn/.watchmanconfig
@@ -0,0 +1 @@
+{}
diff --git a/packages/react-native-sdk/dev/bare-rn/App.tsx b/packages/react-native-sdk/dev/bare-rn/App.tsx
new file mode 100644
index 00000000..83c98352
--- /dev/null
+++ b/packages/react-native-sdk/dev/bare-rn/App.tsx
@@ -0,0 +1,242 @@
+import React, { useMemo } from 'react';
+import {
+ Button,
+ ScrollView,
+ StatusBar,
+ StyleSheet,
+ Text,
+ View,
+} from 'react-native';
+import { SafeAreaProvider, SafeAreaView } from 'react-native-safe-area-context';
+
+import {
+ ReflagProvider,
+ useClient,
+ useFlag,
+ useIsLoading,
+} from '@reflag/react-native-sdk';
+
+const publishableKey = 'pub_prod_vxuM5hSZOnhzvAfiOnZ9rj';
+const isConfigured = publishableKey.length > 0;
+
+type CheckStatus = 'pass' | 'warn' | 'fail';
+
+interface RuntimeCheck {
+ label: string;
+ status: CheckStatus;
+ details: string;
+}
+
+function runRuntimeChecks(): RuntimeCheck[] {
+ const checks: RuntimeCheck[] = [];
+
+ const hasURL = typeof URL !== 'undefined';
+ checks.push({
+ label: 'global URL',
+ status: hasURL ? 'pass' : 'fail',
+ details: hasURL ? 'available' : 'missing',
+ });
+
+ const hasURLSearchParams = typeof URLSearchParams !== 'undefined';
+ checks.push({
+ label: 'global URLSearchParams',
+ status: hasURLSearchParams ? 'pass' : 'fail',
+ details: hasURLSearchParams ? 'available' : 'missing',
+ });
+
+ if (hasURL) {
+ const descriptor = Object.getOwnPropertyDescriptor(URL.prototype, 'search');
+ checks.push({
+ label: 'URL.search setter',
+ status: descriptor?.set ? 'pass' : 'warn',
+ details: descriptor?.set
+ ? 'setter present'
+ : 'getter-only URL.search (older RN behavior)',
+ });
+ }
+
+ try {
+ const url = new URL('/probe', 'https://front.reflag.com');
+ url.searchParams.set('check', 'ok');
+ const href = url.toString();
+ checks.push({
+ label: 'URL + searchParams behavior',
+ status: href.includes('check=ok') ? 'pass' : 'fail',
+ details: href,
+ });
+ } catch (error) {
+ checks.push({
+ label: 'URL + searchParams behavior',
+ status: 'fail',
+ details: String(error),
+ });
+ }
+
+ checks.push({
+ label: 'global EventSource (auto feedback only)',
+ status: typeof EventSource !== 'undefined' ? 'pass' : 'warn',
+ details:
+ typeof EventSource !== 'undefined'
+ ? 'available'
+ : 'missing: keep feedback.enableAutoFeedback=false',
+ });
+
+ return checks;
+}
+
+function RuntimeChecksCard() {
+ const checks = useMemo(() => runRuntimeChecks(), []);
+
+ return (
+
+ Runtime Checks
+ {checks.map(check => (
+
+
+ {check.status.toUpperCase()}
+
+
+ {check.label}
+ {check.details}
+
+
+ ))}
+
+ );
+}
+
+function FlagCard() {
+ const client = useClient();
+ const isLoading = useIsLoading();
+ const { isEnabled, track } = useFlag('bare-rn-demo');
+
+ return (
+
+ Flag: bare-rn-demo
+
+ Status: {isLoading ? 'loading' : isEnabled ? 'enabled' : 'disabled'}
+
+
+
+
+ );
+}
+
+export default function App() {
+ return (
+
+
+
+
+
+ Reflag Bare RN Smoke App
+
+ {isConfigured
+ ? 'Connected to Reflag'
+ : 'Offline mode (set publishableKey in App.tsx to fetch real flags)'}
+
+
+
+
+
+
+
+
+
+ );
+}
+
+const styles = StyleSheet.create({
+ container: {
+ flex: 1,
+ backgroundColor: '#0f172a',
+ },
+ scrollContent: {
+ padding: 20,
+ gap: 16,
+ },
+ header: {
+ paddingHorizontal: 20,
+ paddingTop: 20,
+ gap: 8,
+ },
+ title: {
+ fontSize: 24,
+ fontWeight: '600',
+ color: '#f8fafc',
+ },
+ subtitle: {
+ fontSize: 14,
+ color: '#94a3b8',
+ },
+ card: {
+ backgroundColor: '#111827',
+ borderRadius: 12,
+ padding: 16,
+ gap: 12,
+ borderWidth: 1,
+ borderColor: '#1f2937',
+ },
+ cardTitle: {
+ fontSize: 16,
+ fontWeight: '600',
+ color: '#e2e8f0',
+ },
+ cardBody: {
+ fontSize: 14,
+ color: '#cbd5f5',
+ },
+ buttonRow: {
+ gap: 12,
+ },
+ checkRow: {
+ flexDirection: 'row',
+ gap: 12,
+ alignItems: 'flex-start',
+ },
+ checkStatus: {
+ fontSize: 12,
+ fontWeight: '700',
+ minWidth: 42,
+ },
+ statusPass: {
+ color: '#22c55e',
+ },
+ statusWarn: {
+ color: '#f59e0b',
+ },
+ statusFail: {
+ color: '#ef4444',
+ },
+ checkBody: {
+ flex: 1,
+ gap: 2,
+ },
+ checkLabel: {
+ fontSize: 13,
+ color: '#e2e8f0',
+ },
+ checkDetails: {
+ fontSize: 12,
+ color: '#94a3b8',
+ },
+});
diff --git a/packages/react-native-sdk/dev/bare-rn/Gemfile b/packages/react-native-sdk/dev/bare-rn/Gemfile
new file mode 100644
index 00000000..51515233
--- /dev/null
+++ b/packages/react-native-sdk/dev/bare-rn/Gemfile
@@ -0,0 +1,17 @@
+source 'https://rubygems.org'
+
+# You may use http://rbenv.org/ or https://rvm.io/ to install and use this version
+ruby ">= 2.6.10"
+
+# Exclude problematic versions of cocoapods and activesupport that causes build failures.
+gem 'cocoapods', '>= 1.13', '!= 1.15.0', '!= 1.15.1'
+gem 'activesupport', '>= 6.1.7.5', '!= 7.1.0'
+gem 'xcodeproj', '< 1.26.0'
+gem 'concurrent-ruby', '< 1.3.4'
+
+# Ruby 3.4.0 has removed some libraries from the standard library.
+gem 'bigdecimal'
+gem 'logger'
+gem 'benchmark'
+gem 'mutex_m'
+gem 'nkf'
diff --git a/packages/react-native-sdk/dev/bare-rn/Gemfile.lock b/packages/react-native-sdk/dev/bare-rn/Gemfile.lock
new file mode 100644
index 00000000..cad14382
--- /dev/null
+++ b/packages/react-native-sdk/dev/bare-rn/Gemfile.lock
@@ -0,0 +1,172 @@
+GEM
+ remote: https://rubygems.org/
+ specs:
+ CFPropertyList (3.0.8)
+ activesupport (7.2.3)
+ base64
+ benchmark (>= 0.3)
+ bigdecimal
+ concurrent-ruby (~> 1.0, >= 1.3.1)
+ connection_pool (>= 2.2.5)
+ drb
+ i18n (>= 1.6, < 2)
+ logger (>= 1.4.2)
+ minitest (>= 5.1)
+ securerandom (>= 0.3)
+ tzinfo (~> 2.0, >= 2.0.5)
+ addressable (2.8.8)
+ public_suffix (>= 2.0.2, < 8.0)
+ algoliasearch (1.27.5)
+ httpclient (~> 2.8, >= 2.8.3)
+ json (>= 1.5.1)
+ atomos (0.1.3)
+ base64 (0.3.0)
+ benchmark (0.5.0)
+ bigdecimal (4.0.1)
+ claide (1.1.0)
+ cocoapods (1.15.2)
+ addressable (~> 2.8)
+ claide (>= 1.0.2, < 2.0)
+ cocoapods-core (= 1.15.2)
+ cocoapods-deintegrate (>= 1.0.3, < 2.0)
+ cocoapods-downloader (>= 2.1, < 3.0)
+ cocoapods-plugins (>= 1.0.0, < 2.0)
+ cocoapods-search (>= 1.0.0, < 2.0)
+ cocoapods-trunk (>= 1.6.0, < 2.0)
+ cocoapods-try (>= 1.1.0, < 2.0)
+ colored2 (~> 3.1)
+ escape (~> 0.0.4)
+ fourflusher (>= 2.3.0, < 3.0)
+ gh_inspector (~> 1.0)
+ molinillo (~> 0.8.0)
+ nap (~> 1.0)
+ ruby-macho (>= 2.3.0, < 3.0)
+ xcodeproj (>= 1.23.0, < 2.0)
+ cocoapods-core (1.15.2)
+ activesupport (>= 5.0, < 8)
+ addressable (~> 2.8)
+ algoliasearch (~> 1.0)
+ concurrent-ruby (~> 1.1)
+ fuzzy_match (~> 2.0.4)
+ nap (~> 1.0)
+ netrc (~> 0.11)
+ public_suffix (~> 4.0)
+ typhoeus (~> 1.0)
+ cocoapods-deintegrate (1.0.5)
+ cocoapods-downloader (2.1)
+ cocoapods-plugins (1.0.0)
+ nap
+ cocoapods-search (1.0.1)
+ cocoapods-trunk (1.6.0)
+ nap (>= 0.8, < 2.0)
+ netrc (~> 0.11)
+ cocoapods-try (1.2.0)
+ colored2 (3.1.2)
+ concurrent-ruby (1.3.3)
+ connection_pool (3.0.2)
+ drb (2.2.3)
+ escape (0.0.4)
+ ethon (0.15.0)
+ ffi (>= 1.15.0)
+ ffi (1.17.3)
+ fourflusher (2.3.1)
+ fuzzy_match (2.0.4)
+ gh_inspector (1.1.3)
+ httpclient (2.9.0)
+ mutex_m
+ i18n (1.14.8)
+ concurrent-ruby (~> 1.0)
+ json (2.18.1)
+ logger (1.7.0)
+ minitest (6.0.1)
+ prism (~> 1.5)
+ molinillo (0.8.0)
+ mutex_m (0.3.0)
+ nanaimo (0.3.0)
+ nap (1.1.0)
+ netrc (0.11.0)
+ nkf (0.2.0)
+ prism (1.9.0)
+ public_suffix (4.0.7)
+ rexml (3.4.4)
+ ruby-macho (2.5.1)
+ securerandom (0.4.1)
+ typhoeus (1.5.0)
+ ethon (>= 0.9.0, < 0.16.0)
+ tzinfo (2.0.6)
+ concurrent-ruby (~> 1.0)
+ xcodeproj (1.25.1)
+ CFPropertyList (>= 2.3.3, < 4.0)
+ atomos (~> 0.1.3)
+ claide (>= 1.0.2, < 2.0)
+ colored2 (~> 3.1)
+ nanaimo (~> 0.3.0)
+ rexml (>= 3.3.6, < 4.0)
+
+PLATFORMS
+ ruby
+
+DEPENDENCIES
+ activesupport (>= 6.1.7.5, != 7.1.0)
+ benchmark
+ bigdecimal
+ cocoapods (>= 1.13, != 1.15.1, != 1.15.0)
+ concurrent-ruby (< 1.3.4)
+ logger
+ mutex_m
+ nkf
+ xcodeproj (< 1.26.0)
+
+CHECKSUMS
+ CFPropertyList (3.0.8) sha256=2c99d0d980536d3d7ab252f7bd59ac8be50fbdd1ff487c98c949bb66bb114261
+ activesupport (7.2.3) sha256=5675c9770dac93e371412684249f9dc3c8cec104efd0624362a520ae685c7b10
+ addressable (2.8.8) sha256=7c13b8f9536cf6364c03b9d417c19986019e28f7c00ac8132da4eb0fe393b057
+ algoliasearch (1.27.5) sha256=26c1cddf3c2ec4bd60c148389e42702c98fdac862881dc6b07a4c0b89ffec853
+ atomos (0.1.3) sha256=7d43b22f2454a36bace5532d30785b06de3711399cb1c6bf932573eda536789f
+ base64 (0.3.0) sha256=27337aeabad6ffae05c265c450490628ef3ebd4b67be58257393227588f5a97b
+ benchmark (0.5.0) sha256=465df122341aedcb81a2a24b4d3bd19b6c67c1530713fd533f3ff034e419236c
+ bigdecimal (4.0.1) sha256=8b07d3d065a9f921c80ceaea7c9d4ae596697295b584c296fe599dd0ad01c4a7
+ claide (1.1.0) sha256=6d3c5c089dde904d96aa30e73306d0d4bd444b1accb9b3125ce14a3c0183f82e
+ cocoapods (1.15.2) sha256=f0f5153de8d028d133b96f423e04f37fb97a1da0d11dda581a9f46c0cba4090a
+ cocoapods-core (1.15.2) sha256=322650d97fe1ad4c0831a09669764b888bd91c6d79d0f6bb07281a17667a2136
+ cocoapods-deintegrate (1.0.5) sha256=517c2a448ef563afe99b6e7668704c27f5de9e02715a88ee9de6974dc1b3f6a2
+ cocoapods-downloader (2.1) sha256=bb6ebe1b3966dc4055de54f7a28b773485ac724fdf575d9bee2212d235e7b6d1
+ cocoapods-plugins (1.0.0) sha256=725d17ce90b52f862e73476623fd91441b4430b742d8a071000831efb440ca9a
+ cocoapods-search (1.0.1) sha256=1b133b0e6719ed439bd840e84a1828cca46425ab73a11eff5e096c3b2df05589
+ cocoapods-trunk (1.6.0) sha256=5f5bda8c172afead48fa2d43a718cf534b1313c367ba1194cebdeb9bfee9ed31
+ cocoapods-try (1.2.0) sha256=145b946c6e7747ed0301d975165157951153d27469e6b2763c83e25c84b9defe
+ colored2 (3.1.2) sha256=b13c2bd7eeae2cf7356a62501d398e72fde78780bd26aec6a979578293c28b4a
+ concurrent-ruby (1.3.3) sha256=4f9cd28965c4dcf83ffd3ea7304f9323277be8525819cb18a3b61edcb56a7c6a
+ connection_pool (3.0.2) sha256=33fff5ba71a12d2aa26cb72b1db8bba2a1a01823559fb01d29eb74c286e62e0a
+ drb (2.2.3) sha256=0b00d6fdb50995fe4a45dea13663493c841112e4068656854646f418fda13373
+ escape (0.0.4) sha256=e49f44ae2b4f47c6a3abd544ae77fe4157802794e32f19b8e773cbc4dcec4169
+ ethon (0.15.0) sha256=0809805a035bc10f54162ca99f15ded49e428e0488bcfe1c08c821e18261a74d
+ ffi (1.17.3) sha256=0e9f39f7bb3934f77ad6feab49662be77e87eedcdeb2a3f5c0234c2938563d4c
+ fourflusher (2.3.1) sha256=1b3de61c7c791b6a4e64f31e3719eb25203d151746bb519a0292bff1065ccaa9
+ fuzzy_match (2.0.4) sha256=b5de4f95816589c5b5c3ad13770c0af539b75131c158135b3f3bbba75d0cfca5
+ gh_inspector (1.1.3) sha256=04cca7171b87164e053aa43147971d3b7f500fcb58177698886b48a9fc4a1939
+ httpclient (2.9.0) sha256=4b645958e494b2f86c2f8a2f304c959baa273a310e77a2931ddb986d83e498c8
+ i18n (1.14.8) sha256=285778639134865c5e0f6269e0b818256017e8cde89993fdfcbfb64d088824a5
+ json (2.18.1) sha256=fe112755501b8d0466b5ada6cf50c8c3f41e897fa128ac5d263ec09eedc9f986
+ logger (1.7.0) sha256=196edec7cc44b66cfb40f9755ce11b392f21f7967696af15d274dde7edff0203
+ minitest (6.0.1) sha256=7854c74f48e2e975969062833adc4013f249a4b212f5e7b9d5c040bf838d54bb
+ molinillo (0.8.0) sha256=efbff2716324e2a30bccd3eba1ff3a735f4d5d53ffddbc6a2f32c0ca9433045d
+ mutex_m (0.3.0) sha256=cfcb04ac16b69c4813777022fdceda24e9f798e48092a2b817eb4c0a782b0751
+ nanaimo (0.3.0) sha256=aaaedc60497070b864a7e220f7c4b4cad3a0daddda2c30055ba8dae306342376
+ nap (1.1.0) sha256=949691660f9d041d75be611bb2a8d2fd559c467537deac241f4097d9b5eea576
+ netrc (0.11.0) sha256=de1ce33da8c99ab1d97871726cba75151113f117146becbe45aa85cb3dabee3f
+ nkf (0.2.0) sha256=fbc151bda025451f627fafdfcb3f4f13d0b22ae11f58c6d3a2939c76c5f5f126
+ prism (1.9.0) sha256=7b530c6a9f92c24300014919c9dcbc055bf4cdf51ec30aed099b06cd6674ef85
+ public_suffix (4.0.7) sha256=8be161e2421f8d45b0098c042c06486789731ea93dc3a896d30554ee38b573b8
+ rexml (3.4.4) sha256=19e0a2c3425dfbf2d4fc1189747bdb2f849b6c5e74180401b15734bc97b5d142
+ ruby-macho (2.5.1) sha256=9075e52e0f9270b552a90b24fcc6219ad149b0d15eae1bc364ecd0ac8984f5c9
+ securerandom (0.4.1) sha256=cc5193d414a4341b6e225f0cb4446aceca8e50d5e1888743fac16987638ea0b1
+ typhoeus (1.5.0) sha256=120b67ed1ef515e6c0e938176db880f15b0916f038e78ce2a66290f3f1de3e3b
+ tzinfo (2.0.6) sha256=8daf828cc77bcf7d63b0e3bdb6caa47e2272dcfaf4fbfe46f8c3a9df087a829b
+ xcodeproj (1.25.1) sha256=9a2310dccf6d717076e86f602b17c640046b6f1dfe64480044596f6f2f13dc84
+
+RUBY VERSION
+ ruby 4.0.1
+
+BUNDLED WITH
+ 4.0.3
diff --git a/packages/react-native-sdk/dev/bare-rn/README.md b/packages/react-native-sdk/dev/bare-rn/README.md
new file mode 100644
index 00000000..c7e104e4
--- /dev/null
+++ b/packages/react-native-sdk/dev/bare-rn/README.md
@@ -0,0 +1,112 @@
+# Reflag React Native SDK Bare RN Smoke App
+
+This app is a non-Expo React Native example for validating `@reflag/react-native-sdk` behavior in a bare runtime.
+
+It is intentionally useful for catching runtime compatibility differences that Expo can hide.
+
+## Run
+
+Prerequisites for iOS:
+
+- Full Xcode app installed (not just Command Line Tools).
+- Non-system Ruby on PATH (Homebrew Ruby recommended), because system Ruby on macOS often fails building native gems used by CocoaPods.
+
+```sh
+brew install ruby
+echo 'export PATH="/opt/homebrew/opt/ruby/bin:$PATH"' >> ~/.zshrc
+source ~/.zshrc
+```
+
+If Xcode is installed, select it as active developer directory:
+
+```sh
+sudo xcode-select -s /Applications/Xcode.app/Contents/Developer
+sudo xcodebuild -runFirstLaunch
+```
+
+Prerequisites for Android:
+
+- Android SDK installed (via Android Studio recommended).
+- Android SDK packages required by this project:
+ - Android SDK Platform 36
+ - Android SDK Build-Tools 36.0.0
+ - Android SDK Platform-Tools (`adb`)
+ - Android Emulator
+- At least one emulator (AVD) created, or a physical Android device connected.
+
+Set Android environment variables (`~/.zshrc`):
+
+```sh
+export ANDROID_HOME="$HOME/Library/Android/sdk"
+export ANDROID_SDK_ROOT="$ANDROID_HOME"
+export PATH="$PATH:$ANDROID_HOME/platform-tools:$ANDROID_HOME/emulator:$ANDROID_HOME/cmdline-tools/latest/bin"
+source ~/.zshrc
+```
+
+Create `android/local.properties`:
+
+```sh
+printf "sdk.dir=%s/Library/Android/sdk\n" "$HOME" > packages/react-native-sdk/dev/bare-rn/android/local.properties
+```
+
+Sanity checks:
+
+```sh
+adb --version
+emulator -list-avds
+npx react-native doctor
+```
+
+From the repo root:
+
+```sh
+yarn install
+```
+
+For iOS (first run, and after native dependency changes):
+
+```sh
+cd packages/react-native-sdk/dev/bare-rn
+bundle install
+bundle exec pod install --project-directory=ios
+```
+
+Start Metro:
+
+```sh
+cd packages/react-native-sdk/dev/bare-rn
+yarn start
+```
+
+Run the app:
+
+```sh
+yarn ios
+# or
+yarn android
+```
+
+If using a physical device:
+
+```sh
+adb devices
+adb reverse tcp:8081 tcp:8081
+```
+
+## Troubleshooting
+
+- `/.../adb: No such file or directory`
+ - `platform-tools` is missing or `ANDROID_HOME` / `PATH` is not set correctly.
+- `No emulators found as an output of emulator -list-avds`
+ - Create an emulator in Android Studio Device Manager, or connect a physical device.
+- `SDK location not found ... android/local.properties`
+ - Set `ANDROID_HOME` / `ANDROID_SDK_ROOT` and create `packages/react-native-sdk/dev/bare-rn/android/local.properties`.
+
+## Notes
+
+- This app calls `@reflag/react-native-sdk` directly (no Expo runtime).
+- `App.tsx` includes runtime diagnostics for URL/search params and related globals.
+- By default it runs offline with fallback flag `bare-rn-demo`.
+- To hit live APIs, set `publishableKey` in `App.tsx`.
+- `yarn start` / `yarn ios` / `yarn android` only rebuild SDK deps if `dist` outputs are missing.
+- If you change SDK source in this monorepo, run `yarn build:deps` in this app before retesting.
diff --git a/packages/react-native-sdk/dev/bare-rn/android/app/build.gradle b/packages/react-native-sdk/dev/bare-rn/android/app/build.gradle
new file mode 100644
index 00000000..54fbf593
--- /dev/null
+++ b/packages/react-native-sdk/dev/bare-rn/android/app/build.gradle
@@ -0,0 +1,121 @@
+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 {
+ def workspaceNodeModulesDir = file("${rootDir}/../../../../../node_modules")
+
+ /* 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("${workspaceNodeModulesDir}/react-native")
+ // The folder where the react-native Codegen package is. Default is ../../node_modules/@react-native/codegen
+ codegenDir = file("${workspaceNodeModulesDir}/@react-native/codegen")
+ // The cli.js file which is the React Native CLI entrypoint. Default is ../../node_modules/react-native/cli.js
+ cliFile = file("${workspaceNodeModulesDir}/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"]
+
+ /* Autolinking */
+ autolinkLibrariesWithApp()
+}
+
+/**
+ * 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 = io.github.react-native-community:jsc-android-intl:2026004.+`
+ *
+ * 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 = 'io.github.react-native-community:jsc-android:2026004.+'
+
+android {
+ ndkVersion = rootProject.ext.ndkVersion
+ buildToolsVersion = rootProject.ext.buildToolsVersion
+ compileSdk = rootProject.ext.compileSdkVersion
+
+ namespace = "com.reflagbarernsmoke"
+ defaultConfig {
+ applicationId = "com.reflagbarernsmoke"
+ minSdk = rootProject.ext.minSdkVersion
+ targetSdk = 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")
+
+ if (hermesEnabled.toBoolean()) {
+ implementation("com.facebook.react:hermes-android")
+ } else {
+ implementation jscFlavor
+ }
+}
diff --git a/packages/react-native-sdk/dev/bare-rn/android/app/debug.keystore b/packages/react-native-sdk/dev/bare-rn/android/app/debug.keystore
new file mode 100644
index 00000000..364e105e
Binary files /dev/null and b/packages/react-native-sdk/dev/bare-rn/android/app/debug.keystore differ
diff --git a/packages/react-native-sdk/dev/bare-rn/android/app/proguard-rules.pro b/packages/react-native-sdk/dev/bare-rn/android/app/proguard-rules.pro
new file mode 100644
index 00000000..11b02572
--- /dev/null
+++ b/packages/react-native-sdk/dev/bare-rn/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:
diff --git a/packages/react-native-sdk/dev/bare-rn/android/app/src/main/AndroidManifest.xml b/packages/react-native-sdk/dev/bare-rn/android/app/src/main/AndroidManifest.xml
new file mode 100644
index 00000000..fb78f397
--- /dev/null
+++ b/packages/react-native-sdk/dev/bare-rn/android/app/src/main/AndroidManifest.xml
@@ -0,0 +1,27 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/packages/react-native-sdk/dev/bare-rn/android/app/src/main/java/com/reflagbarernsmoke/MainActivity.kt b/packages/react-native-sdk/dev/bare-rn/android/app/src/main/java/com/reflagbarernsmoke/MainActivity.kt
new file mode 100644
index 00000000..609f6b60
--- /dev/null
+++ b/packages/react-native-sdk/dev/bare-rn/android/app/src/main/java/com/reflagbarernsmoke/MainActivity.kt
@@ -0,0 +1,22 @@
+package com.reflagbarernsmoke
+
+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 = "ReflagBareRnSmoke"
+
+ /**
+ * 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)
+}
diff --git a/packages/react-native-sdk/dev/bare-rn/android/app/src/main/java/com/reflagbarernsmoke/MainApplication.kt b/packages/react-native-sdk/dev/bare-rn/android/app/src/main/java/com/reflagbarernsmoke/MainApplication.kt
new file mode 100644
index 00000000..5d0ced76
--- /dev/null
+++ b/packages/react-native-sdk/dev/bare-rn/android/app/src/main/java/com/reflagbarernsmoke/MainApplication.kt
@@ -0,0 +1,38 @@
+package com.reflagbarernsmoke
+
+import android.app.Application
+import com.facebook.react.PackageList
+import com.facebook.react.ReactApplication
+import com.facebook.react.ReactHost
+import com.facebook.react.ReactNativeApplicationEntryPoint.loadReactNative
+import com.facebook.react.ReactNativeHost
+import com.facebook.react.ReactPackage
+import com.facebook.react.defaults.DefaultReactHost.getDefaultReactHost
+import com.facebook.react.defaults.DefaultReactNativeHost
+
+class MainApplication : Application(), ReactApplication {
+
+ override val reactNativeHost: ReactNativeHost =
+ object : DefaultReactNativeHost(this) {
+ override fun getPackages(): List =
+ 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(applicationContext, reactNativeHost)
+
+ override fun onCreate() {
+ super.onCreate()
+ loadReactNative(this)
+ }
+}
diff --git a/packages/react-native-sdk/dev/bare-rn/android/app/src/main/res/drawable/rn_edit_text_material.xml b/packages/react-native-sdk/dev/bare-rn/android/app/src/main/res/drawable/rn_edit_text_material.xml
new file mode 100644
index 00000000..5c25e728
--- /dev/null
+++ b/packages/react-native-sdk/dev/bare-rn/android/app/src/main/res/drawable/rn_edit_text_material.xml
@@ -0,0 +1,37 @@
+
+
+
+
+
+
+