From db9fc2a8c183219e404518e5198f4d87f7cd0391 Mon Sep 17 00:00:00 2001
From: Duc Trung LE <leductrungxf@gmail.com>
Date: Fri, 15 Oct 2021 17:38:55 +0200
Subject: [PATCH] Update docs for UI test

---
 docs/source/contribute.rst | 33 +++++++++++++++++++++++++++++++++
 1 file changed, 33 insertions(+)

diff --git a/docs/source/contribute.rst b/docs/source/contribute.rst
index 7e57c7090..d3fe40f9f 100755
--- a/docs/source/contribute.rst
+++ b/docs/source/contribute.rst
@@ -218,6 +218,39 @@ Finally, to run the tests:
 
    python -m pytest
 
+UI tests with `Playwright`
+==========================
+
+Install the test dependencies and the mock widgets:
+
+.. code-block:: bash
+
+   python -m pip install jupyterlab~=3.0 numpy bqplot matplotlib ipympl ipyvolume scipy
+   cd tests/widget_lib
+   pip install .
+
+Install `Playwright` and `Chromium` browser:
+
+.. code-block:: bash
+
+   cd ui-tests
+   jlpm install --frozen-lockfile
+   jlpm playwright install chromium
+
+Start `Voilà` server for snapshot and stability testing: 
+
+.. code-block:: bash
+
+   # In ui-tests folder
+   jlpm start
+   jlpm start-stability
+
+Finally, to run the tests:
+
+.. code-block:: bash
+
+   jlpm run test
+
 Editing templates
 =================