2 files changed, 16 insertions, 0 deletions
diff --git a/sources/pyside6/doc/deployment/deployment-pyside6-deploy.rst b/sources/pyside6/doc/deployment/deployment-pyside6-deploy.rst
index 980fe2dd1..3b602babc 100644
--- a/sources/pyside6/doc/deployment/deployment-pyside6-deploy.rst
+++ b/sources/pyside6/doc/deployment/deployment-pyside6-deploy.rst
@@ -144,6 +144,12 @@ The relevant parameters for ``pyside6-deploy`` are:
 
       NSCameraUsageDescription:CameraAccess
 
+  * ``mode``: Accepts one of the options: ``onefile`` or ``standalone``. The default is ``onefile``.
+    This option corresponds to the mode in which Nuitka is run. The onefile mode creates a single
+    executable file, while the standalone mode creates a directory with the executable and all the
+    necessary files. The standalone mode is useful when you want to distribute the application as a
+    directory with dependencies and other files required by the app.
+
   * ``extra_args``: Any extra Nuitka arguments specified. It is specified as space-separated
     command line arguments i.e. just like how you would specify it when you use Nuitka through
     the command line. By default, it contains the following arguments::
diff --git a/sources/pyside6/tests/tools/pyside6-deploy/test_pyside6_deploy.py b/sources/pyside6/tests/tools/pyside6-deploy/test_pyside6_deploy.py
index db60c8c3f..a5d122a37 100644
--- a/sources/pyside6/tests/tools/pyside6-deploy/test_pyside6_deploy.py
+++ b/sources/pyside6/tests/tools/pyside6-deploy/test_pyside6_deploy.py
@@ -174,6 +174,16 @@ class TestPySide6DeployWidgets(DeployTestBase):
             self.deploy.main(main_file=fake_main_file, config_file=self.config_file)
         self.assertTrue("Directory does not contain main.py file." in str(context.exception))
 
+    def testStandaloneMode(self, mock_plugins):
+        mock_plugins.return_value = self.all_plugins
+        # remove --onefile from self.expected_run_cmd and replace it with --standalone
+        self.expected_run_cmd = self.expected_run_cmd.replace(" --onefile", " --standalone")
+        # test standalone mode
+        original_output = self.deploy.main(self.main_file, mode="standalone", dry_run=True,
+                                           force=True)
+
+        self.assertEqual(original_output, self.expected_run_cmd)
+
 
 @unittest.skipIf(sys.platform == "darwin" and int(platform.mac_ver()[0].split('.')[0]) <= 11,
                  "Test only works on macOS version 12+")