From b54d8e84ddb22bf38db8e742b0964872a40912cf Mon Sep 17 00:00:00 2001
From: "Rodrigo Rodriguez (Pragmatismo)" <me@rodrigorodriguez.com>
Date: Sun, 7 Dec 2025 02:14:20 -0300
Subject: [PATCH] docs: update UI documentation and add testing chapters

- Update suite.md and ui-structure.md
- Add testing best-practices, ci-cd, and performance docs
---
 src/04-gbui/apps/suite.md        | 16 +++++++++++++---
 src/04-gbui/ui-structure.md      |  4 ++--
 src/17-testing/best-practices.md |  1 +
 src/17-testing/ci-cd.md          |  1 +
 src/17-testing/performance.md    |  1 +
 5 files changed, 18 insertions(+), 5 deletions(-)
 create mode 100644 src/17-testing/best-practices.md
 create mode 100644 src/17-testing/ci-cd.md
 create mode 100644 src/17-testing/performance.md

diff --git a/src/04-gbui/apps/suite.md b/src/04-gbui/apps/suite.md
index e317fe2c..c345f63a 100644
--- a/src/04-gbui/apps/suite.md
+++ b/src/04-gbui/apps/suite.md
@@ -79,13 +79,23 @@ Click the grid icon (⋮⋮⋮) to access all applications in a dropdown menu.
 
 ### As Desktop App
 
-Used automatically when running with `--desktop`:
+Use the `botui` Tauri application for native desktop experience:
 
 ```bash
-./botserver --desktop
+# From the botui directory
+cd botui
+cargo tauri dev
 # Opens Suite in native window
 ```
 
+Or build the standalone app:
+
+```bash
+cd botui
+cargo tauri build
+# Creates distributable app in target/release
+```
+
 ### As Web Interface
 
 Default template for browser access:
@@ -211,4 +221,4 @@ suite-sidebar-collapsed,false
 - [Drive App](./drive.md) - File management
 - [Tasks App](./tasks.md) - Task management
 - [HTMX Architecture](../htmx-architecture.md) - Technical details
-- [Theme Customization](../../chapter-05-gbtheme/README.md) - Styling
\ No newline at end of file
+- [Theme Customization](../../chapter-05-gbtheme/README.md) - Styling
diff --git a/src/04-gbui/ui-structure.md b/src/04-gbui/ui-structure.md
index dbe7e815..c56ba3b9 100644
--- a/src/04-gbui/ui-structure.md
+++ b/src/04-gbui/ui-structure.md
@@ -59,7 +59,7 @@ The Suite interface provides multi-application integration with seamless navigat
 
 The Suite interface is best suited for enterprise deployments requiring full functionality, power users working with multiple services simultaneously, desktop application distribution via Tauri builds, and multi-service integrations where context switching between modules matters.
 
-You can access the Suite interface via web at `http://localhost:8080/suite` or as a desktop application through the Tauri build using the `--desktop` flag.
+You can access the Suite interface via web at `http://localhost:8080/suite` or as a native desktop application using the `botui` Tauri app (see [BotUI Desktop](../botui/README.md)).
 
 ## Minimal Interface
 
@@ -222,4 +222,4 @@ Planned improvements include dynamic UI selection based on device capabilities t
 - [default.gbui Reference](./default-gbui.md) - Full desktop template
 - [single.gbui Reference](./single-gbui.md) - Simple chat template
 - [Console Mode](./console-mode.md) - Terminal interface
-- [Monitoring Dashboard](./monitoring.md) - System observability
\ No newline at end of file
+- [Monitoring Dashboard](./monitoring.md) - System observability
diff --git a/src/17-testing/best-practices.md b/src/17-testing/best-practices.md
new file mode 100644
index 00000000..874ca7f3
--- /dev/null
+++ b/src/17-testing/best-practices.md
@@ -0,0 +1 @@
+# Best Practices
diff --git a/src/17-testing/ci-cd.md b/src/17-testing/ci-cd.md
new file mode 100644
index 00000000..5340a605
--- /dev/null
+++ b/src/17-testing/ci-cd.md
@@ -0,0 +1 @@
+# CI/CD Integration
diff --git a/src/17-testing/performance.md b/src/17-testing/performance.md
new file mode 100644
index 00000000..c0459859
--- /dev/null
+++ b/src/17-testing/performance.md
@@ -0,0 +1 @@
+# Performance Testing