docs: add vite-hmr guide (#796)

jsjoeio · web-flow · commit a1e14b48d811 · 2022-01-18T08:31:16.000-06:00
diff --git a/guides/troubleshooting/vite-hmr.md b/guides/troubleshooting/vite-hmr.md
@@ -0,0 +1,30 @@
+---
+title: Vite and HMR
+description: Learn how to resolve issues with HMR when using Vite.
+---
+
+When using Vite and accessing your app via
+[dev URLs](../../workspaces/devurls.md), you may encounter issues with hot
+module reloading (HMR) not working.
+
+## Why this happens
+
+Vite runs a WebSocket for hot module reloading (HMR) and assumes the client will
+listen on a specific port. If this isn't the case, Vite HMR and the client never
+connect.
+
+## How to fix
+
+Edit your `vite.config.js` file and add the following information to provide the
+appropriate port number:
+
+```js
+ server: {
+    hmr: {
+      clientPort: 443
+    },
+  },
+```
+
+If this doesn't resolve the issue, please
+[contact us](https://coder.com/contact) for further support.
diff --git a/manifest.json b/manifest.json
@@ -502,6 +502,9 @@
             },
             {
               "path": "./guides/troubleshooting/502error.md"
+            },
+            {
+              "path": "./guides/troubleshooting/vite-hmr.md"
             }
           ]
         }

Original file line number	Diff line number	Diff line change
`@@ -502,6 +502,9 @@`
`502`	`502`	`},`
`503`	`503`	`{`
`504`	`504`	`"path": "./guides/troubleshooting/502error.md"`
	`505`	`+ },`
	`506`	`+ {`
	`507`	`+ "path": "./guides/troubleshooting/vite-hmr.md"`
`505`	`508`	`}`
`506`	`509`	`]`
`507`	`510`	`}`