diff --git a/.gitpod.yml b/.gitpod.yml
new file mode 100644
index 000000000..7a74d91c1
--- /dev/null
+++ b/.gitpod.yml
@@ -0,0 +1,10 @@
+image:
+  file: Dockerfile
+# exposed ports
+ports:
+- port: 8080
+  onOpen: open-preview
+# start up tasks
+tasks:
+- init: ./mvnw package -DskipTests >/dev/null
+  command: ./mvnw package -DskipTests # FIXME : LS removes *.css on initialize
diff --git a/Dockerfile b/Dockerfile
new file mode 100644
index 000000000..868db7a68
--- /dev/null
+++ b/Dockerfile
@@ -0,0 +1,3 @@
+FROM gitpod/workspace-full
+
+# add your tools here
diff --git a/readme.md b/readme.md
index a8506b0ee..5f617ee33 100644
--- a/readme.md
+++ b/readme.md
@@ -4,6 +4,9 @@ Deploy this sample application to Pivotal Web Services:
     <img src="https://push-to.cfapps.io/ui/assets/images/Push-to-Pivotal-Dark.svg" width="130" alt="Push" align="top">
 </a>
 
+Start coding in Gitpod, a free online dev environment.
+[![Open in Gitpod](https://gitpod.io/button/open-in-gitpod.svg)](https://gitpod.io/from-referrer/)
+
 ## Understanding the Spring Petclinic application with a few diagrams
 <a href="https://speakerdeck.com/michaelisvy/spring-petclinic-sample-application">See the presentation here</a>
 
@@ -92,9 +95,9 @@ Visit [http://localhost:8080](http://localhost:8080) in your browser.
 
 |Spring Boot Configuration | Class or Java property files  |
 |--------------------------|---|
-|The Main Class | [PetClinicApplication](https://github.com/spring-projects/spring-petclinic/blob/master/src/main/java/org/springframework/samples/petclinic/PetClinicApplication.java) |
-|Properties Files | [application.properties](https://github.com/spring-projects/spring-petclinic/blob/master/src/main/resources) |
-|Caching | [CacheConfiguration](https://github.com/spring-projects/spring-petclinic/blob/master/src/main/java/org/springframework/samples/petclinic/system/CacheConfiguration.java) |
+|The Main Class | [PetClinicApplication](./src/main/java/org/springframework/samples/petclinic/PetClinicApplication.java) |
+|Properties Files | [application.properties](./src/main/resources/application.properties) |
+|Caching | [CacheConfiguration](./src/main/java/org/springframework/samples/petclinic/system/CacheConfiguration.java) |
 
 ## Interesting Spring Petclinic branches and forks