diff --git a/components/dashboard/README.md b/components/dashboard/README.md
index e13bd8b9be7e1f..296641132cab87 100644
--- a/components/dashboard/README.md
+++ b/components/dashboard/README.md
@@ -31,4 +31,25 @@ const GitIntegration = React.lazy(() => import('./settings/GitIntegration'));
 Global state is passed through `React.Context`.
 
 After creating a new component, run the following to update the license header:
-`leeway run components:update-license-header`
\ No newline at end of file
+`leeway run components:update-license-header`
+
+## How to develop in gitpod.io
+
+Edit `craco.config.js`, add `devServer` section, replace GITPOD_HOST to `SaaS Gitpod host` or `self-hosted Gitpod host`, then replace `cookie` field.
+```js
+     devServer: {
+         proxy: {
+             '/api': {
+                 target: 'https://' + GITPOD_HOST,
+                 ws: true,
+                 headers: {
+                     host: GITPOD_HOST,
+                     origin: 'https://' + GITPOD_HOST,
+                     cookie: '__REPLACE_YOUR_COOKIE__'
+                 },
+             }
+         }
+     }
+```
+
+After following the above steps, run `yarn run start` to start developing.
\ No newline at end of file