feat: add standalone Reactotron server and update dependencies

- Introduced a bundled standalone Reactotron server that starts automatically with the macOS app.
- Added a new script to bundle the server code using esbuild.
- Updated package.json to include esbuild as a dependency.
- Enhanced README with instructions for running the server and details about the embedded server functionality.
- Updated Podfile.lock to reflect changes in dependencies.
- Minor adjustments to existing scripts and configurations for better integration.

Author: joshuayoes

README.md

@@ -35,11 +35,13 @@ npm install
 npm run pod
 npm run start
 npm run macos
-# for release builds
+# for release builds (automatically bundles the server)
 npm run macos-release
 ```
 
-### Windows Development  
+**Note:** The Reactotron server is now embedded in the macOS app and starts automatically on port 9292. No need to run a separate server process!
+
+### Windows Development
 
 #### System Requirements
 
@@ -69,14 +71,26 @@ Both platforms use unified commands for native module development:
 
 See [Making a TurboModule](./docs/Making-a-TurboModule.md) for detailed native development instructions.
 
+### Server Bundle
+
+If you modify the standalone server code (`standalone-server.js`), rebuild the bundle:
+
+```sh
+npm run bundle-server
+```
+
+The bundle is automatically generated during release builds (`npm run macos-release`).
+
 ## Enabling Reactotron in your app
 
 > [!NOTE]
 > We don't have a simple way to integrate the new Reactotron-macOS into your app yet, but that will be coming at some point. This assumes you've cloned down Reactotron-macOS.
 
-1. From the root of Reactotron-macOS, start the standalone relay server:
-   `node -e "require('./standalone-server').startReactotronServer({ port: 9292 })"`
-2. In your app, add the following to your app.tsx:
+The Reactotron server is now embedded in the macOS app and starts automatically when you launch it. Simply:
+
+1. Run the Reactotron macOS app (via `npm run macos` or the built .app)
+2. The server will automatically start on port 9292
+3. In your app, add the following to your app.tsx:
 
 ```tsx
 if (__DEV__) {
@@ -92,7 +106,26 @@ if (__DEV__) {
 }
 ```
 
-3. Start your app and Reactotron-macOS. You should see logs appear.
+4. Start your app and you should see logs appear in Reactotron.
+
+### Running the Server Standalone (Optional)
+
+If you need to run the server without the GUI (for CI/CD or headless environments), you can still run:
+
+```sh
+node -e "require('./standalone-server').startReactotronServer({ port: 9292 })"
+```
+
+### Server Implementation Details
+
+The embedded server:
+
+- Starts automatically when the app launches
+- Stops automatically when the app quits
+- Runs on port 9292 by default (configurable in `AppDelegate.mm`)
+- Is bundled as a single file with all dependencies
+- Requires Node.js to be installed on the system
+- Supports nvm, asdf, fnm, and other Node version managers
 
 ## Get Help
 

macos/Podfile.lock

@@ -1779,7 +1779,7 @@ SPEC CHECKSUMS:
   glog: b7594b792ee4e02ed1f44b01d046ca25fa713e3d
   hermes-engine: b5c9cfbe6415f1b0b24759f2942c8f33e9af6347
   IRNativeModules: 2fa316ab0ca91ec3e7bd4ba7ab2fc1f642fb5542
-  RCT-Folly: e8b53d8c0d2d9df4a6a8b0a368a1a91fc62a88cb
+  RCT-Folly: abec2d7f4af402b4957c44e86ceff8725b23c1b4
   RCTDeprecation: 9da6c2d8a3b1802142718283260fb06d702ddb07
   RCTRequired: 574f9d55bda1d50676530b6c36bab4605612dfb6
   RCTTypeSafety: 7de929c405e619c023116e7747118a2c5d5b2320

macos/Reactotron-macOS/AppDelegate.mm

@@ -5,7 +5,121 @@
 #import <ReactAppDependencyProvider/RCTAppDependencyProvider.h>
 #import "WindowSetup.h"
 
-@implementation AppDelegate
+@implementation AppDelegate {
+  NSTask *_reactotronTask;
+}
+
+#pragma mark - Reactotron Server Management
+
+- (NSString *)findNodeBinary
+{
+  // Use login shell approach to honor nvm/asdf/etc.
+  NSTask *which = [[NSTask alloc] init];
+  which.launchPath = @"/usr/bin/env";
+  which.arguments = @[ @"bash", @"-lc", @"command -v node || true" ];
+
+  NSPipe *pipe = [NSPipe pipe];
+  which.standardOutput = pipe;
+
+  [which launch];
+  [which waitUntilExit];
+
+  NSData *data = [[pipe fileHandleForReading] readDataToEndOfFile];
+  NSString *path = [[[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding]
+                    stringByTrimmingCharactersInSet:[NSCharacterSet whitespaceAndNewlineCharacterSet]];
+
+  if (path.length > 0) {
+    NSLog(@"Found node at: %@", path);
+    return path;
+  }
+  
+  NSLog(@"Node not found in shell path, using /usr/bin/env as fallback");
+  return @"/usr/bin/env"; // fallback; will run "env node" below
+}
+
+- (void)startReactotronServerWithPort:(NSString *)port
+{
+  if (_reactotronTask) {
+    NSLog(@"Reactotron server already running");
+    return;
+  }
+
+  NSString *node = [self findNodeBinary];
+
+  NSURL *scriptURL =
+    [[NSBundle mainBundle] URLForResource:@"standalone-server.bundle" withExtension:@"js"];
+  if (!scriptURL) {
+    NSLog(@"⚠️  standalone-server.bundle.js not found in bundle. Run 'npm run bundle-server' to generate it.");
+    return;
+  }
+
+  NSLog(@"Found server script at: %@", scriptURL.path);
+
+  _reactotronTask = [[NSTask alloc] init];
+  
+  // Launch node directly with arguments (avoid shell -c for security)
+  if ([node isEqualToString:@"/usr/bin/env"]) {
+    _reactotronTask.launchPath = node;
+    _reactotronTask.arguments = @[ @"node", scriptURL.path, @"--port", port ?: @"9292" ];
+  } else {
+    _reactotronTask.launchPath = node;
+    _reactotronTask.arguments = @[ scriptURL.path, @"--port", port ?: @"9292" ];
+  }
+
+  // Give the script a sane CWD (app bundle directory)
+  _reactotronTask.currentDirectoryPath = [[[NSBundle mainBundle] bundleURL] path];
+
+  // Capture output for debugging
+  NSPipe *outputPipe = [NSPipe pipe];
+  NSPipe *errorPipe = [NSPipe pipe];
+  _reactotronTask.standardOutput = outputPipe;
+  _reactotronTask.standardError = errorPipe;
+
+  // Log server output
+  outputPipe.fileHandleForReading.readabilityHandler = ^(NSFileHandle *file) {
+    NSData *data = [file availableData];
+    if (data.length > 0) {
+      NSString *output = [[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding];
+      NSLog(@"[Reactotron Server] %@", [output stringByTrimmingCharactersInSet:[NSCharacterSet newlineCharacterSet]]);
+    }
+  };
+
+  errorPipe.fileHandleForReading.readabilityHandler = ^(NSFileHandle *file) {
+    NSData *data = [file availableData];
+    if (data.length > 0) {
+      NSString *output = [[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding];
+      NSLog(@"[Reactotron Server Error] %@", [output stringByTrimmingCharactersInSet:[NSCharacterSet newlineCharacterSet]]);
+    }
+  };
+
+  __weak __typeof__(self) weakSelf = self;
+  _reactotronTask.terminationHandler = ^(NSTask *task) {
+    NSLog(@"Reactotron server exited with status: %d", task.terminationStatus);
+    __typeof__(self) strongSelf = weakSelf;
+    if (strongSelf) {
+      strongSelf->_reactotronTask = nil;
+    }
+  };
+
+  @try {
+    [_reactotronTask launch];
+    NSLog(@"✅ Reactotron server started on port %@", port ?: @"9292");
+  } @catch (NSException *exception) {
+    NSLog(@"❌ Failed to start Reactotron server: %@", exception.reason);
+    _reactotronTask = nil;
+  }
+}
+
+- (void)stopReactotronServer
+{
+  if (_reactotronTask && _reactotronTask.isRunning) {
+    NSLog(@"Stopping Reactotron server...");
+    [_reactotronTask terminate];
+  }
+  _reactotronTask = nil;
+}
+
+#pragma mark - Application Lifecycle
 
 - (void)applicationDidFinishLaunching:(NSNotification *)notification
 {
@@ -25,6 +139,15 @@ - (void)applicationDidFinishLaunching:(NSNotification *)notification
 
   // Configure window chrome before RN mounts
   IRConfigureWindow(self.window);
+
+  // Start the bundled Reactotron server
+  // You can change the port here or make it a user preference
+  [self startReactotronServerWithPort:@"9292"];
+}
+
+- (void)applicationWillTerminate:(NSNotification *)notification
+{
+  [self stopReactotronServer];
 }
 
 - (NSURL *)sourceURLForBridge:(RCTBridge *)bridge