Create README.md

README.md

@@ -0,0 +1,35 @@
+# heroku-utils
+
+
+# `x-heroku release <app>`
+
+This command makes and uploads a new heroku slug from a tar file after which the slug will be released as
+a new version of the app. 
+
+The input tar file MUST contain a `.heroku.json` file and all application assets/executables.
+
+```
+-rw-r--r--  0 root   root       52 Feb  1  1988 .heroku.json
+drwxr-xr-x  0 root   root        0 Feb  1  1988 bin/
+-rwxr-xr-x  0 root   root  7601672 Feb  1  1988 bin/hello
+```
+
+The content of the `.heroku.json` file must match the following example:
+
+```json5
+{
+  // required
+  "process_types": {
+    "web": "bin/hello"
+    // ...
+  },
+
+  // optional
+  "commit": "71763e53638e91d778ceda3de420cc3a7473b0e4",
+  "commit_description": "Commit message or description",
+  "buildpack_provided_description": "Golang app",
+  "stack": "cedar-14"
+}
+```
+
+