Add GUI runner and packaging docs

docs/docs/content/01-getting-started/05-briefcase.md

@@ -0,0 +1,20 @@
+# Packaging the GUI with Briefcase
+
+This project uses [BeeWare's Briefcase](https://beeware.org) to generate
+platform‑native installers. Once your development environment is set up,
+package the GUI by running the following commands from the repository root:
+
+```bash
+# Create the application scaffold for your platform
+briefcase create
+
+# Compile dependencies and produce a distributable bundle
+briefcase build
+
+# Run the packaged application
+briefcase run
+```
+
+`briefcase create` only needs to be executed once per platform. After the
+initial creation step you can repeatedly run `briefcase build` followed by
+`briefcase run` to test your packaged application on Windows, macOS or Linux.

pyproject.toml

@@ -4,6 +4,7 @@ version = "0.1.0"
 
 [project.scripts]
 seedpass = "seedpass.cli:app"
+seedpass-gui = "seedpass_gui.app:main"
 
 [tool.mypy]
 python_version = "3.11"

src/run_gui.py

@@ -0,0 +1,4 @@
+from seedpass_gui.app import main
+
+if __name__ == "__main__":
+    main()

src/seedpass_gui/app.py

@@ -197,3 +197,8 @@ class SeedPassApp(toga.App):
         )
         self.main_window = None
         self.lock_window.show()
+
+
+def main() -> None:  # pragma: no cover - GUI bootstrap
+    """Run the BeeWare application."""
+    SeedPassApp().main_loop()