diff --git a/.devcontainer/devcontainer.json b/.devcontainer/devcontainer.json
new file mode 100644
index 0000000..7e0d589
--- /dev/null
+++ b/.devcontainer/devcontainer.json
@@ -0,0 +1,27 @@
+// For format details, see https://aka.ms/devcontainer.json. For config options, see the
+// README at: https://github.com/devcontainers/templates/tree/main/src/ubuntu
+{
+	"name": "Ubuntu",
+	// Or use a Dockerfile or Docker Compose file. More info: https://containers.dev/guide/dockerfile
+	"image": "mcr.microsoft.com/devcontainers/base:jammy",
+	"features": {
+		"ghcr.io/devcontainers/features/docker-in-docker:2": {},
+		"ghcr.io/devcontainers/features/github-cli:1": {},
+		"ghcr.io/jungaretti/features/make:1": {}
+	}
+
+	// Features to add to the dev container. More info: https://containers.dev/features.
+	// "features": {},
+
+	// Use 'forwardPorts' to make a list of ports inside the container available locally.
+	// "forwardPorts": [],
+
+	// Use 'postCreateCommand' to run commands after the container is created.
+	// "postCreateCommand": "uname -a",
+
+	// Configure tool-specific properties.
+	// "customizations": {},
+
+	// Uncomment to connect as root instead. More info: https://aka.ms/dev-containers-non-root.
+	// "remoteUser": "root"
+}
diff --git a/README.md b/README.md
index 86d695e..bc1aba7 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,6 @@
 # YesWorkflow Web Application
 
+
 ## Overview
 
 The purpose of this repo to enable the service supporting the YesWorkflow web
@@ -95,6 +96,24 @@ Perform the following steps on a computer running Linux, MacOS, or Windows.
 
 6. Navigate to the web application in your browser at http://localhost:8080.
 
+## Running the service with GitHub Codespaces
+1. Create a Codespaces by clicking
+[![Open in GitHub Codespaces](https://github.com/codespaces/badge.svg)](https://codespaces.new/yilinxia/yw-web-app)
+2. Once the Codespaces created, you can start the service by invoking the `run` target:
+
+	```
+    $ make run
+
+    docker run -it --rm -p 8080:8080 --volume C:/Users/tmcphill/GitRepos/yw-web-app:/mnt/yw-web-app cirss/yw-web-app:latest bash -ic /mnt/yw-web-app/service/run.sh
+
+    --------------------------------------------------------------------------
+    The YesWorkflow web app service has been started in the REPRO.
+    Connect to it by navigating in a web browser to http://localhost:8080
+
+    Terminate the service by typing CTRL-C in this terminal.
+    ---------------
+3. Open web application from `PORTS -> Local Address` 
+
 ## Running the service on a Windows system without Make
 
 There are two alternatives for running the YesWorkflow web app service on Windows systems: