From c72b88d80a23fa08255de5240ca5b4e5201c39e4 Mon Sep 17 00:00:00 2001
From: Julie Huang <julhuang@gitlab.com>
Date: Thu, 18 Jul 2024 06:58:59 +0000
Subject: [PATCH] Apply 1 suggestion(s) to 1 file(s)

Co-authored-by: Stanislav Lashmanov <slashmanov@gitlab.com>
---
 doc/development/fe_guide/performance.md | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/doc/development/fe_guide/performance.md b/doc/development/fe_guide/performance.md
index 48960f3ee5edf..c62821d09fe0b 100644
--- a/doc/development/fe_guide/performance.md
+++ b/doc/development/fe_guide/performance.md
@@ -349,6 +349,14 @@ When unsure what controller and action corresponds to a page,
 inspect `document.body.dataset.page` in your
 browser's developer console from any page in GitLab.
 
+TROUBLESHOOTING:
+If using Vite, keep in mind that support for it is new and you may encounter unexpected effects from time to
+time. If the entrypoint is correctly configured but the JavaScript is not loading,
+try clearing the Vite cache and restarting the service:
+`rm -rf tmp/cache/vite && gdk restart vite`
+
+Alternatively, you can opt to use Webpack instead. Follow these [instructions for disabling Vite and using Webpack](https://gitlab.com/gitlab-org/gitlab-development-kit/-/blob/main/doc/configuration.md#vite-settings).
+
 #### Important Considerations
 
 - **Keep Entry Points Lite:**
-- 
GitLab