diff --git a/packages/shorebird_cli/lib/src/commands/release/macos_releaser.dart b/packages/shorebird_cli/lib/src/commands/release/macos_releaser.dart
index 806ca418..d282d6cc 100644
--- a/packages/shorebird_cli/lib/src/commands/release/macos_releaser.dart
+++ b/packages/shorebird_cli/lib/src/commands/release/macos_releaser.dart
@@ -182,5 +182,7 @@ To change the version of this release, change your app's version in your pubspec
       '''
 
 macOS app created at ${artifactManager.getMacOSAppDirectory(flavor: flavor)!.path}.
+
+${styleBold.wrap('Note:')} If you distribute your app via the Mac App Store using a .pkg installer, the packaging process may modify the binary and cause patch failures. See ${link(uri: Uri.parse('https://github.com/shorebirdtech/shorebird/issues/3223'))} for more information.
 ''';
 }
diff --git a/packages/shorebird_cli/test/src/commands/release/macos_releaser_test.dart b/packages/shorebird_cli/test/src/commands/release/macos_releaser_test.dart
index c9684ecb..1b0091a7 100644
--- a/packages/shorebird_cli/test/src/commands/release/macos_releaser_test.dart
+++ b/packages/shorebird_cli/test/src/commands/release/macos_releaser_test.dart
@@ -916,10 +916,16 @@ To change the version of this release, change your app's version in your pubspec
       test('prints xcarchive upload steps', () {
         expect(
           runWithOverrides(() => releaser.postReleaseInstructions),
-          equals('''
+          contains('macOS app created at ${appDirectory.path}.'),
+        );
+      });
 
-macOS app created at ${appDirectory.path}.
-'''),
+      test('includes .pkg distribution warning', () {
+        expect(
+          runWithOverrides(() => releaser.postReleaseInstructions),
+          contains(
+            'https://github.com/shorebirdtech/shorebird/issues/3223',
+          ),
         );
       });
     });