create docs page & draft Zarf UI doc

docs/7-dashboard-ui/2-k9s-dashboard.md

@@ -1,4 +1,4 @@
-# K9s
+# K9s Dashboard
 
 Zarf vendors in [K9s, a terminal-based UI to interact with your Kubernetes cluster. K9s is not necessary to deploy, manage, or operate Zarf or its deployed packages, but it is a great tool to use when you want to interact with your cluster. Since Zarf vendors in this tool, you don't have to worry about additional dependencies or trying to install it yourself!
 

docs/7-dashboard-ui/3-Zarf-deployment-ui.md

@@ -0,0 +1,115 @@
+# Zarf Deployment Web UI
+
+Zarf has a Deoployment Web UI built in. The Deployment Web Ui supports a nubmer of Zarf features used during the package deployment process. For users who prefer not to use the command line tool, the Web UI creates a simple experience to deploy and manage Zarf clusters and packages. The Web UI can be used to connect to connect to existing clusters (via Kubeconfig), initalize a cluster, deploy packages into a cluster, update packages in the cluster, and remove packages from the cluster. 
+
+The Zarf Web UI mirros the functionality of the Zarf CLI commands, but with a more intuitive flow and familuar web application patterns for non-technical users. The web UI does not offer any additional commands or core functionaliity to Zarf. 
+
+## Open the Zarf Deployment Web UI
+
+The Zarf Deployment Web UI can be easily spun up with a single command from the CLI terminal. 
+
+Follow these steps to get started using the Web UI
+
+1. Step one: Install Zarf binary
+2. Step two: Open CLI terminal
+3. Step three: Type in the following command: ```zarf dev UI```
+
+![GIF showing the Web UI lauch from the CLI terminal](../.images/dashboard/Web_UI__Launch_w__Cluster_AdobeExpress.gif)
+
+## Using Zarf Deployment Web UI
+
+### Cluster Connection Status
+
+When Zarf is running it automatically searches for a Kubeconfig on the local machine. If the Kubeconfig is found, it searches the defualt cluster to determine if it is a Zarf cluster (Initialized). There are two different cluster statuses the Web UI will display based on the state of the cluster found. 
+
+#### Cluster not Connected (Not Initizalized)
+
+![Web UI shows organge warning status and message "cluster not connected" on the cluster card](../.images/dashboard/Web%20UI%20-%20Cluster%20Not%20Connected.png)
+
+1. Shown when there is no Kubeconfig found on the machine.
+2. Shown when there is a Kubeconfig foudn on the machine but it has not currently connected to Zarf.
+
+#### Cluster Connected (Initialized)
+
+If Zarf finds a cluster in the Kubeconfig that has Zarf resources on it it will automatically connect to the cluster and display the cluster details on the Web UI.
+
+![Web UI shows cluster metat data in on the cluster card when a connected cluster is found](../.images/dashboard/Web%20UI%20-%20Status%20Cluster%20connected.png)
+
+1. Shown when there is a Kubeconfig found on the machine with a default cluster that has Zarf resources in it.
+
+
+### Connect to Existing Cluster 
+
+The Zarf Web UI makes connecting to existing clusters easy. When on the packages page, if there is no Zarf cluster currently connected, select the connect cluster button. If Zarf finds a Kubeconfig it will ask the user if they want to connect to the the default cluster context. 
+
+:::Tip 
+
+Zarf can only read the default cluster in your Kubeconfig file, if you wish to connect to a different cluster in the kubeconfig you will need to change it to the default cluster in the terminal. See the Kubernetes documentation on [how to configure access to multiple clusters](https://kubernetes.io/docs/tasks/access-application-cluster/configure-access-multiple-clusters/).
+
+::: 
+
+Follow these steps to connect to an existing cluster:
+
+1. Be sure to have a Kubeconfig on your machine with the cluster you wish to connect to set as the default cluster.
+2. Click connect cluster button on cluster card
+3. Select cluster name in the dialog and click connect
+4. Select a ZarfInitConfig package to deploy into cluster
+5. Follow Package deployment prompts to deploy package and initialize cluster as a Zarf cluster.
+
+### Deploy K8 and Cluster with init package with Cluster
+
+If you do not have access to an existing cluster, or would simply like to spin up a new cluster. You can do that by deploying a ZarfInitConfig package and selecting the optional K3s component. 
+
+:::info
+
+This option is currently only available for linux machines or machines using a linux box. 
+
+:::
+
+Follow these steps to deploy and initialze a new cluster:
+
+1. Click deploy package button - on Deployed packages table
+2. Select an ZarfInitPackage from the list
+3. Toggle the switch for the K3s component to deploy 
+4. Complete package deployment steps to spin up and initialze your new Zarf cluster.
+
+### Deploy additional packages
+
+Once you have a cluster connected to Zarf, you can deploy additional packages into the cluster. 
+
+Steps to deploy additional packages into cluster:
+
+1. Click deploy package button on the Deployed packages table
+2. Select the package you wish to deploy from the list
+3. Complete the package deployment steps 
+
+### Additional Package Commands
+
+Once a package is deployed into the cluster, the Web UI offers additional commands that can be executed on a package. To view these commands click on the verticle elipse at the end of the table row for the package you wish to execute the command on. The Web UI currently supports these package commands.
+
+- Update: Use when you wish to update a package with a new version of the same package.
+- Remove: Use when you wish to remove a package and all of it's resources from the cluster. This cannot be undone.
+
+![Web UI deployed packages table with a context menu showing additional package commands](../.images/dashboard/Web%20UI%20-%20package%20commands.png
+
+
+## Technical Details
+
+The web UI is packaged into the Zarf binay, so you don't have to worry about additional dependencies or trying to install it yourself! The Web UI is served through your machines local browser, running as a local host, and utlizes as the backend. 
+
+Use the Zarf Deployment UI to execute the existing Zarf CLI commands. 
+- [Zarf tools Kubectl](/docs/4-user-guide/1-the-zarf-cli/100-cli-commands/zarf_tools_kubectl.md)
+- [Zarf tools Kubectl top](/docs/4-user-guide/1-the-zarf-cli/100-cli-commands/)
+- [Zarf Init](/docs/4-user-guide/1-the-zarf-cli/100-cli-commands/zarf_init.md)
+- [Zarf Package Deploy](/docs/4-user-guide/1-the-zarf-cli/100-cli-commands/)
+- [Zarf Package Remove](/docs/4-user-guide/1-the-zarf-cli/100-cli-commands/zarf_package_remove.md)
+- [Zarf Pacakge List](/docs/4-user-guide/1-the-zarf-cli/100-cli-commands/zarf_package_list.md)
+- [Zarf Package Inspect](/docs/4-user-guide/1-the-zarf-cli/100-cli-commands/zarf_package_inspect.md) (coming soon)
+- [Zarf Tools Sbom](/docs/4-user-guide/1-the-zarf-cli/100-cli-commands/zarf_tools_sbom.md) (Coming soon)
+- [Zarf Connect](/docs/4-user-guide/1-the-zarf-cli/100-cli-commands/zarf_connect.md) (coming soon) 
+
+:::info
+
+All other zarf [CLI commands](../4-user-guide/1-the-zarf-cli/100-cli-commands/) will require interfacing with the CLI directly.
+
+:::