diff --git a/.devcontainer/README.md b/.devcontainer/README.md
new file mode 100644
index 0000000000..f18ab5ea80
--- /dev/null
+++ b/.devcontainer/README.md
@@ -0,0 +1,26 @@
+# GitHub Codespace with OpenROAD GUI
+
+The goal is to provide a web browser experience of the OpenROAD GUI. Solution works with Firefox and Chrome.
+
+## User
+
+
+
+## Developer
+
+
+
+
+
+# Development loop
+
+https://code.visualstudio.com/docs/devcontainers/create-dev-container#_full-configuration-edit-loop
+
+
+# devcontainer json reference:
+
+https://containers.dev/implementors/json_reference/
+
+# ORFS Docker
+
+OpenROAD and OpenROAD Flow Scripts provide a docker image generation script `etc/DockerHelper.sh`, which is reused here to build and publish the image to GH registry.
diff --git a/.devcontainer/ubuntu2204-gui/devcontainer.json b/.devcontainer/ubuntu2204-gui/devcontainer.json
new file mode 100644
index 0000000000..44d486b770
--- /dev/null
+++ b/.devcontainer/ubuntu2204-gui/devcontainer.json
@@ -0,0 +1,12 @@
+{
+    "image": "ghcr.io/antmicro/openroad-flow-scripts/ubuntu22.04:latest",
+    "features": {
+      "ghcr.io/devcontainers/features/desktop-lite:1": {}
+    },
+    "forwardPorts": [6080],
+    "portsAttributes": {
+      "6080": {
+        "label": "desktop"
+      }
+    }
+}