diff --git a/java/demo/.readme_res/App_Engine_Run_Config.png b/java/demo/.readme_res/App_Engine_Run_Config.png
new file mode 100644
index 000000000..4c21985ec
Binary files /dev/null and b/java/demo/.readme_res/App_Engine_Run_Config.png differ
diff --git a/java/demo/README.md b/java/demo/README.md
index d10b30b9b..fa3a6d17c 100644
--- a/java/demo/README.md
+++ b/java/demo/README.md
@@ -1,4 +1,6 @@
-## Prerequisite:
+# Running the demo
+
+## 1. Install Google Cloud SDK
 
 ### Linux
 
@@ -16,6 +18,33 @@
 
 `$ gcloud components install app-engine-java`
 
-## How to regenerate the WAR, deploy and run in appengine?
+## 2. Add IDE Plugin
+
+### Intellij
+
+Install [Cloud Code Plugin for Intellij](https://plugins.jetbrains.com/plugin/8079-cloud-code)
+
+_If you have worked with the App Engine Plugin before,
+please [migrate](https://cloud.google.com/code/docs/intellij/migrate)._
+
+### Eclipse
+
+Install [Cloud Code Plugin for Eclipse](https://marketplace.eclipse.org/content/google-cloud-tools-eclipse)
+
+### Visual Studio Code
+
+Install [Cloud Code Plugin for Visual Studio Code](https://marketplace.visualstudio.com/items?itemName=GoogleCloudTools.cloudcode&ssr=false#overview)
+
+## 3. Run
+
+Most IDEs should autodetect your configuration after installing the plugin (and
+restart)
+
+![App Engine Run Config](.readme_res/App_Engine_Run_Config.png)
+
+## (Optional) Run Natively
+
+This is _not recommended_ with an IDE as you have to manage updating your
+artifacts yourself, it does not support live reload
 
 `$ mvn appengine:run`
diff --git a/java/demo/pom.xml b/java/demo/pom.xml
index 36336955b..27b791311 100644
--- a/java/demo/pom.xml
+++ b/java/demo/pom.xml
@@ -38,9 +38,9 @@
       <version>2022-07-20</version>
     </dependency>
     <dependency>
-      <artifactId>appengine-api-1.0-sdk</artifactId>
-      <groupId>com.google.appengine</groupId>
-      <version>2.0.8</version>
+      <artifactId>appengine-maven-plugin</artifactId>
+      <groupId>com.google.cloud.tools</groupId>
+      <version>2.4.4</version>
     </dependency>
     <dependency>
       <groupId>javax.servlet</groupId>