diff --git a/README.md b/README.md
index 8e7d0cc..577099e 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,47 @@
+# Steps to Create and Deploy:
+
+## set up local
+
+## local postgres
+
+1. open your postgres app and start the db server
+1. in the postgres app, double click one of the existing databases to enter `psql`
+1. once inside `psql`, run `CREATE DATABASE springdemo;`
+
+### in your browser
+
+1. fork this repo
+
+### in your terminal
+
+1. clone your fork of this repo onto your local computer somewhere outside the class repo
+1. `cd` into the local repo
+
+Set up an environment variable so your local spring app will use your local postgres database:
+
+```
+export JDBC_DATABASE_URL=jdbc:postgresql://localhost:5432/springdemo
+```
+
+Now start spring:
+
 ```
 ./mvnw spring-boot:run
 ```
+
+## set up heroku
+
+### in your terminal
+
+1. run `heroku create` (take note of the app name for later)
+1. run `git push heroku master`
+
+### in your browser
+
+1. go to heroku.com in your browser and sign in
+1. find this newly created heroku app in your list of available apps and click on it
+1. go to resources
+1. search for postgres and choose Heroku Postgres
+1. choose "Hobby Dev - Free"
+1. click provision
+