Replace terminology sandbox with dashboard

Author: iMattPro

.github/CONTRIBUTING.md

@@ -60,7 +60,7 @@ Set-Location ..
 php tests/vendor/bin/phpunit -c phpunit.xml.dist
 ```
 
-Sandbox CLI or web UI changes must remain compatible with macOS, Linux, and native Windows. Before submitting such changes, run:
+CLI or Dashboard UI changes must remain compatible with macOS, Linux, and native Windows. Before submitting such changes, run:
 
 ```bash
 php bin/qi doctor

README.md

@@ -59,9 +59,9 @@ phpBB boards require a web server running PHP and one of the following database
 
 ## QuickInstall CLI
 
-QuickInstall now includes a cross-platform, Docker-based CLI and local sandbox web UI for creating phpBB test boards. They work on macOS, Linux, and native Windows and write generated state to `.qi/` without changing the legacy web application.
+QuickInstall now includes a cross-platform, Docker-based CLI and local Dashboard UI for creating phpBB test boards. They work on macOS, Linux, and native Windows and write generated state to `.qi/` without changing the legacy web application.
 
-Sandbox requirements:
+Requirements:
 
 - Docker Desktop, installed and running
 - PHP 8.0 or newer for the CLI command
@@ -70,29 +70,18 @@ Sandbox requirements:
 Create your first new board:
 
 ```bash
-php bin/qi init
 php bin/qi board:create test --phpbb 3.3 --db mariadb --port 8081 --populate extension-dev
 ```
 
-The examples use `php bin/qi`, which works on every supported operating system when PHP is in `PATH`. Windows users can alternatively use the supplied Command Prompt launcher from either Command Prompt or PowerShell:
-
-```powershell
-.\bin\qi.cmd board:list
-```
-
 The QuickInstall CLI targets phpBB 3.2+ installer-based boards. phpBB 3.0/3.1 remain legacy-web-app territory and are not planned for the QuickInstall CLI.
 
-Downloaded extensions can be unzipped into `customisations/` and mounted into boards:
+If you prefer a browser workflow, start the QuickInstall Dashboard UI:
 
 ```bash
-php bin/qi ext:mount test customisations/vendor/extname
+php bin/qi ui:start
 ```
 
-Downloaded styles can be unzipped into `customisations/` and mounted into boards:
-
-```bash
-php bin/qi style:mount test customisations/stylename
-```
+The examples use `php bin/qi`, which works on every supported operating system when PHP is in `PATH`. Windows users can alternatively use `.\bin\qi.cmd` from either Command Prompt or PowerShell.
 
 See the complete [QuickInstall CLI docs](docs/sandbox-cli.md).
 

docs/sandbox-cli.md

@@ -48,7 +48,7 @@ If you ever need help with commands, run:
 php bin/qi help
 ```
 
-If you prefer a browser workflow, start the local sandbox UI:
+If you prefer a browser workflow, start the QuickInstall Dashboard UI:
 
 ```bash
 php bin/qi ui:start
@@ -381,9 +381,9 @@ Fetched sources live under:
 .qi/sources/phpbb-<source>
 ```
 
-## Web UI
+## Dashboard UI
 
-QuickInstall includes a local browser UI for the same sandbox workflows exposed by the CLI. It is served by PHP's built-in web server and backed by the same `.qi/` project state. The UI server can be started, checked, restarted, and stopped on macOS, Linux, or native Windows.
+The QuickInstall Dashboard UI provides a local browser interface for the same workflows exposed by the CLI. It is served by PHP's built-in web server and backed by the same `.qi/` workspace. The Dashboard UI can be started, checked, restarted, and stopped on macOS, Linux, or native Windows.
 
 Start the UI:
 
@@ -403,7 +403,7 @@ Use a different local port:
 php bin/qi ui:start --port 8088
 ```
 
-Check or stop the tracked UI server:
+Check or stop the tracked Dashboard UI server:
 
 ```bash
 php bin/qi ui:status
@@ -416,7 +416,7 @@ Restart it:
 php bin/qi ui:restart
 ```
 
-Supported UI server hosts are loopback-only:
+Supported Dashboard UI server hosts are loopback-only:
 
 ```bash
 php bin/qi ui:start --host 127.0.0.1
@@ -434,9 +434,9 @@ Generated state:
 | `.qi/runtime/<name>`     | Docker Compose, Dockerfile, installer config |
 | `.qi/db/<name>`          | Database files                               |
 | `.qi/sources/<source>`   | Downloaded phpBB source                      |
-| `.qi/runtime/ui.json`    | Tracked web UI server state                  |
-| `.qi/runtime/ui.log`     | Web UI server output log                     |
-| `.qi/runtime/ui.log.err` | Windows web UI server error log              |
+| `.qi/runtime/ui.json`    | Tracked Dashboard UI server state            |
+| `.qi/runtime/ui.log`     | Dashboard UI server output log               |
+| `.qi/runtime/ui.log.err` | Windows Dashboard UI server error log        |
 | `.qi/cache/`             | Cached update-check metadata                 |
 
 User-managed drop zone:
@@ -452,9 +452,9 @@ customisations/
 - `board:create` rejects ports already registered to another board or already in use on the host.
 - `ext:mount` and `style:mount` only use `customisations/` unless `--allow-external` is used.
 - Custom Git source URLs require `--allow-external`; only use trusted forks.
-- The web UI server only accepts loopback hosts (`127.0.0.1`, `localhost`, or `::1`) and rejects non-local requests.
+- The Dashboard UI server only accepts loopback hosts (`127.0.0.1`, `localhost`, or `::1`) and rejects non-local requests.
 - `ui:start` refuses ports already in use on the selected loopback host.
-- Web UI form submissions use CSRF tokens and only accept local origins or referrers.
+- Dashboard UI form submissions use CSRF tokens and only accept local origins or referrers.
 
 ## Troubleshooting
 
@@ -510,7 +510,7 @@ php bin/qi board:destroy demo
 php bin/qi board:create demo --phpbb 3.3 --db mariadb --port 8081 --populate none
 ```
 
-#### Web UI will not start
+#### Dashboard UI will not start
 
 Check the tracked status:
 
@@ -531,4 +531,4 @@ If the selected port is already in use, choose a different local port:
 php bin/qi ui:start --port 8088
 ```
 
-The UI server output log is written to `.qi/runtime/ui.log`. On Windows, PHP server errors are written to `.qi/runtime/ui.log.err`.
+The Dashboard UI server output log is written to `.qi/runtime/ui.log`. On Windows, PHP server errors are written to `.qi/runtime/ui.log.err`.

src/QuickInstall/Sandbox/Application.php

@@ -595,11 +595,11 @@ private function uiStart(array $args): int
 		$state = $result['state'];
 		if ($result['status'] === 'already_running')
 		{
-			echo "QuickInstall sandbox UI is already running: {$state['url']}\n";
+			echo "QuickInstall Dashboard UI is already running: {$state['url']}\n";
 			return 0;
 		}
 
-		echo "QuickInstall sandbox UI started: {$state['url']}\n";
+		echo "QuickInstall Dashboard UI started: {$state['url']}\n";
 		echo "PID: {$state['pid']}\n";
 		echo "Log: {$state['log']}\n";
 		echo "Stop it with: php bin/qi ui:stop\n";
@@ -613,21 +613,21 @@ private function uiStop(): int
 		$state = $result['state'];
 		if ($result['status'] === 'not_tracked')
 		{
-			echo "QuickInstall sandbox UI is not tracked as running.\n";
+			echo "QuickInstall Dashboard UI is not tracked as running.\n";
 			return 0;
 		}
 
 		if ($result['status'] === 'stopped')
 		{
-			echo "Stopped QuickInstall sandbox UI";
+			echo "Stopped QuickInstall Dashboard UI";
 			if (!empty($state['url']))
 			{
 				echo ": {$state['url']}";
 			}
 		}
 		else
 		{
-			echo "QuickInstall sandbox UI process was not running";
+			echo "QuickInstall Dashboard UI process was not running";
 			$pid = (int) ($state['pid'] ?? 0);
 			if ($pid > 0)
 			{
@@ -651,7 +651,7 @@ private function uiStatus(): int
 		$state = $result['state'];
 		if ($result['status'] === 'running')
 		{
-			echo "QuickInstall sandbox UI is running\n";
+			echo "QuickInstall Dashboard UI is running\n";
 			echo "URL: {$state['url']}\n";
 			echo "PID: {$state['pid']}\n";
 			echo "Log: {$state['log']}\n";
@@ -660,13 +660,13 @@ private function uiStatus(): int
 
 		if ($result['status'] === 'stale')
 		{
-			echo "QuickInstall sandbox UI is not running, but stale state exists.\n";
+			echo "QuickInstall Dashboard UI is not running, but stale state exists.\n";
 			echo "Last URL: " . ($state['url'] ?? '(unknown)') . "\n";
 			echo "Run: php bin/qi ui:stop\n";
 			return 1;
 		}
 
-		echo "QuickInstall sandbox UI is not running.\n";
+		echo "QuickInstall Dashboard UI is not running.\n";
 		return 0;
 	}
 
@@ -1121,8 +1121,8 @@ private function helpCommands(): array
 				'ui:start' => [
 					'title' => 'ui:start',
 					'usage' => 'ui:start [--host 127.0.0.1] [--port 8079]',
-					'summary' => 'Start the local sandbox admin UI.',
-					'description' => 'Starts PHP built-in server in the background on a loopback address and serves a minimal admin UI backed by the sandbox services.',
+					'summary' => 'Start the local QuickInstall Dashboard UI.',
+					'description' => 'Starts PHP built-in server in the background on a loopback address and serves the QuickInstall Dashboard UI.',
 					'options' => [
 						'--host HOST' => 'Loopback host. One of: 127.0.0.1, localhost, ::1. Default: 127.0.0.1.',
 						'--port PORT' => 'Local UI port. Default: 8079.',
@@ -1135,17 +1135,17 @@ private function helpCommands(): array
 				'ui:stop' => [
 					'title' => 'ui:stop',
 					'usage' => 'ui:stop',
-					'summary' => 'Stop the tracked local sandbox admin UI.',
-					'description' => 'Stops the background UI server that was started with ui:start and removes its runtime state file.',
+					'summary' => 'Stop the tracked QuickInstall Dashboard UI.',
+					'description' => 'Stops the background Dashboard UI server that was started with ui:start and removes its runtime state file.',
 					'examples' => [
 						'ui:stop',
 					],
 				],
 				'ui:restart' => [
 					'title' => 'ui:restart',
 					'usage' => 'ui:restart [--host 127.0.0.1] [--port 8079]',
-					'summary' => 'Restart the local sandbox admin UI.',
-					'description' => 'Stops the tracked UI server if present, then starts a fresh local UI server.',
+					'summary' => 'Restart the local QuickInstall Dashboard UI.',
+					'description' => 'Stops the tracked Dashboard UI server if present, then starts a fresh local Dashboard UI server.',
 					'options' => [
 						'--host HOST' => 'Loopback host. One of: 127.0.0.1, localhost, ::1. Default: 127.0.0.1.',
 						'--port PORT' => 'Local UI port. Default: 8079.',
@@ -1157,7 +1157,7 @@ private function helpCommands(): array
 				'ui:status' => [
 					'title' => 'ui:status',
 					'usage' => 'ui:status',
-					'summary' => 'Show whether the local sandbox admin UI is running.',
+					'summary' => 'Show whether the QuickInstall Dashboard UI is running.',
 					'description' => 'Reads the tracked UI runtime state and checks whether the configured local UI port responds.',
 					'examples' => [
 						'ui:status',

src/QuickInstall/Sandbox/DockerComposeWriter.php

@@ -70,7 +70,7 @@ private function installConfig(string $name, array $config): string
   board:
     lang: en
     name: $boardName
-    description: "QuickInstall sandbox"
+    description: "QuickInstall test board"
   database:
     dbms: $dbms
     dbhost: "$dbhost"

src/QuickInstall/Sandbox/UiServerService.php

@@ -132,7 +132,7 @@ private function startUnixDetachedProcess(array $command, string $cwd, string $l
 		}
 		if ($result['exit_code'] !== 0 || $pid <= 0)
 		{
-			throw new RuntimeException('Unable to start QuickInstall sandbox UI server.');
+			throw new RuntimeException('Unable to start QuickInstall Dashboard UI server.');
 		}
 
 		return $pid;
@@ -155,7 +155,7 @@ private function startWindowsDetachedProcess(array $command, string $cwd, string
 		$pid = (int) trim($result['output']);
 		if ($result['exit_code'] !== 0 || $pid <= 0)
 		{
-			throw new RuntimeException('Unable to start QuickInstall sandbox UI server. PowerShell is required on Windows.');
+			throw new RuntimeException('Unable to start QuickInstall Dashboard UI server. PowerShell is required on Windows.');
 		}
 
 		return $pid;
@@ -338,7 +338,7 @@ private function waitForStart(array $state): void
 		{
 			$logs .= ' and ' . $state['error_log'];
 		}
-		throw new RuntimeException('QuickInstall sandbox UI server did not become available. Check the UI logs for details: ' . $logs);
+		throw new RuntimeException('QuickInstall Dashboard UI server did not become available. Check the Dashboard UI logs for details: ' . $logs);
 	}
 
 	private function waitForStop(array $state): void

src/QuickInstall/Sandbox/Web/Application.php

@@ -287,7 +287,7 @@ private function disableExecutionTimeLimit(): void
 		@ini_set('max_execution_time', '0');
 		if ((int) ini_get('max_execution_time') !== 0)
 		{
-			throw new RuntimeException('QuickInstall could not disable the PHP execution time limit for this action. Allow set_time_limit or set max_execution_time=0 for the sandbox UI.');
+			throw new RuntimeException('QuickInstall could not disable the PHP execution time limit for this action. Allow set_time_limit or set max_execution_time=0 for the Dashboard UI.');
 		}
 	}
 

src/QuickInstall/Sandbox/Web/templates/layout.php

@@ -36,7 +36,7 @@
 		<main class="main">
 			<header class="topbar">
 				<div>
-					<h1>QuickInstall dashboard</h1>
+					<h1>QuickInstall Dashboard</h1>
 					<p class="lede">Manage disposable phpBB boards backed by the same Docker services as the CLI.</p>
 				</div>
 				<form method="post" data-ajax>

tests/Integration/BinQiTest.php

@@ -40,7 +40,7 @@ public function testUiStatusSmokeTestLoadsUiServerService(): void
 		$result = $this->runCli(['ui:status']);
 
 		self::assertContains($result['exit_code'], [0, 1]);
-		self::assertStringContainsString('QuickInstall sandbox UI', $result['stdout']);
+		self::assertStringContainsString('QuickInstall Dashboard UI', $result['stdout']);
 		self::assertSame('', $result['stderr']);
 	}
 

tests/Integration/WebApplicationTest.php

@@ -57,7 +57,6 @@ public function testRenderShowsCoreSandboxWorkflows(): void
 		$html = $this->runWebApplication($root);
 
 		self::assertStringContainsString('QuickInstall Dashboard', $html);
-		self::assertStringContainsString('QuickInstall dashboard', $html);
 		self::assertStringContainsString('QuickInstall + Docker', $html);
 		self::assertStringContainsString('Create board', $html);
 		self::assertStringContainsString('Sources', $html);