From 9126bbfda914e53738585a223f2232230f5d66e8 Mon Sep 17 00:00:00 2001 From: Carlos Alcaide Corvo Date: Tue, 27 Jun 2023 08:54:34 -0700 Subject: [PATCH] =?UTF-8?q?docs:=20=E2=9C=8F=EF=B8=8F=20Add=20desktop=20tr?= =?UTF-8?q?oubleshooting=20content=20(#1745)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * docs: ✏️ Add desktop troubleshooting content Co-authored-by: Lisbet Alvarez <107949262+lisbet-alvarez@users.noreply.github.com> --- ui/desktop/README.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/ui/desktop/README.md b/ui/desktop/README.md index d42e8c96c..dc8ae1b6b 100644 --- a/ui/desktop/README.md +++ b/ui/desktop/README.md @@ -17,6 +17,8 @@ The desktop client UI for Boundary. - [Environment Variables](#environment-variables-1) - [Running Tests](#running-tests) - [Running end to end Tests](#running-end-to-end-tests) + - [Troubleshooting](#troubleshooting) + - [Blank screen and/or hang browser tab when running as web app](#blank-screen-andor-hang-browser-tab-when-running-as-web-app) - [Deploying](#deploying) - [Debug desktop client](#debug-desktop-client) - [Debug `renderer` process](#debug-renderer-process) @@ -179,6 +181,14 @@ Steps: - Run `$ yarn run e2e` and tests will start run. - You can check the screenshots the tests take: `desktop/tests/end2end/screenshots`. + +### Troubleshooting + +#### Blank screen and/or hang browser tab when running as web app + +We are aware of an issue of the desktop client not being able to start correctly when running as web app within development mode. This issue reproduces when the developer is enabling/disabling Mirage ([more info](#environment-variables) about environment variables). + +The workaround to fix this issue is to reset/clear cookies and data (local storage and session storage). ### Deploying TBD