Skip to content

feat(ios): add bundleURL provider for dynamic bundle loading #212

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
artus9033 merged 8 commits into from
Jan 28, 2026
Merged

feat(ios): add bundleURL provider for dynamic bundle loading #212

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
8 commits
Select commit Hold shift + click to select a range
1b81ebd
feat(ios): add bundleURL provider for dynamic bundle loading
gronxb Jan 21, 2026
1cd75e2
chore: changeset
gronxb Jan 21, 2026
41ad8ef
fix: rename bundleURLOverride
gronxb Jan 23, 2026
6d01702
fix: rename
gronxb Jan 23, 2026
200e6fd
Merge branch 'main' into feature/ios-bundle-url-provider
gronxb Jan 23, 2026
09b0e0c
fix: indent
gronxb Jan 23, 2026
48b3d35
fix: rename
gronxb Jan 23, 2026
6c5f9fd
fix: renaming
gronxb Jan 23, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions .changeset/social-seas-see.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
'@callstack/react-native-brownfield': minor
---

feat(ios): add bundleURL provider for dynamic bundle loading
13 changes: 7 additions & 6 deletions docs/docs/docs/api-reference/react-native-brownfield/swift.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -28,12 +28,13 @@ ReactNativeBrownfield.shared

#### Properties

| Property | Type | Default | Description |
| ------------------ | --------- | --------------- | --------------------------------------------------------- |
| `entryFile` | `String` | `index` | Path to JavaScript root. |
| `fallbackResource` | `String?` | `nil` | Path to bundle fallback resource. |
| `bundlePath` | `String` | `main.jsbundle` | Path to bundle fallback resource. |
| `bundle` | `Bundle` | `Bundle.main` | Bundle instance to lookup the JavaScript bundle resource. |
| Property | Type | Default | Description |
| ------------------- | ------------------ | --------------- | --------------------------------------------------------------------------------------------- |
| `entryFile` | `String` | `index` | Path to JavaScript root. |
| `fallbackResource` | `String?` | `nil` | Path to bundle fallback resource. |
| `bundlePath` | `String` | `main.jsbundle` | Path to bundle fallback resource. |
| `bundle` | `Bundle` | `Bundle.main` | Bundle instance to lookup the JavaScript bundle resource. |
| `bundleURLOverride` | `(() -> URL?)?` | `nil` | Dynamic bundle URL provider called on every bundle load. When set, overrides default behavior. |

---

Expand Down
16 changes: 16 additions & 0 deletions packages/react-native-brownfield/ios/ReactNativeBrownfield.swift
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,13 +7,18 @@ class ReactNativeBrownfieldDelegate: RCTDefaultReactNativeFactoryDelegate {
var entryFile = "index"
var bundlePath = "main.jsbundle"
var bundle = Bundle.main
var bundleURLOverride: (() -> URL?)? = nil
// MARK: - RCTReactNativeFactoryDelegate Methods

override func sourceURL(for bridge: RCTBridge) -> URL? {
return bundleURL()
}

public override func bundleURL() -> URL? {
if let bundleURLProvider = bundleURLOverride {
return bundleURLProvider()
}

#if DEBUG
return RCTBundleURLProvider.sharedSettings().jsBundleURL(forBundleRoot: entryFile)
#else
Expand Down Expand Up @@ -64,6 +69,17 @@ class ReactNativeBrownfieldDelegate: RCTDefaultReactNativeFactoryDelegate {
delegate.bundle = bundle
}
}
/**
* Dynamic bundle URL provider called on every bundle load.
* When set, this overrides the default bundleURL() behavior in the delegate.
* Returns a URL to load a custom bundle, or nil to use default behavior.
* Default value: nil
*/
@objc public var bundleURLOverride: (() -> URL?)? = nil {
didSet {
delegate.bundleURLOverride = bundleURLOverride
}
}
/**
* React Native factory instance created when starting React Native.
* Default value: nil
Expand Down