diff --git a/.gitignore b/.gitignore
index 5948403..3a25564 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,2 +1,3 @@
 node_modules
 *.spk
+.DS_Store
diff --git a/.sandstorm/app-graphics/appgrid-128x128.png b/.sandstorm/app-graphics/appgrid-128x128.png
new file mode 100644
index 0000000..3dad438
Binary files /dev/null and b/.sandstorm/app-graphics/appgrid-128x128.png differ
diff --git a/.sandstorm/app-graphics/grain-24x24.png b/.sandstorm/app-graphics/grain-24x24.png
new file mode 100644
index 0000000..5674ff2
Binary files /dev/null and b/.sandstorm/app-graphics/grain-24x24.png differ
diff --git a/.sandstorm/icon.png b/.sandstorm/app-graphics/hugo_icon.png
similarity index 100%
rename from .sandstorm/icon.png
rename to .sandstorm/app-graphics/hugo_icon.png
diff --git a/.sandstorm/app-graphics/market-150x150.png b/.sandstorm/app-graphics/market-150x150.png
new file mode 100644
index 0000000..679c679
Binary files /dev/null and b/.sandstorm/app-graphics/market-150x150.png differ
diff --git a/.sandstorm/app-graphics/market-big-300x300.png b/.sandstorm/app-graphics/market-big-300x300.png
new file mode 100644
index 0000000..cac24c3
Binary files /dev/null and b/.sandstorm/app-graphics/market-big-300x300.png differ
diff --git a/.sandstorm/app-graphics/screenshot1.png b/.sandstorm/app-graphics/screenshot1.png
new file mode 100644
index 0000000..a2765d6
Binary files /dev/null and b/.sandstorm/app-graphics/screenshot1.png differ
diff --git a/.sandstorm/app-graphics/screenshot2.png b/.sandstorm/app-graphics/screenshot2.png
new file mode 100644
index 0000000..cfc9654
Binary files /dev/null and b/.sandstorm/app-graphics/screenshot2.png differ
diff --git a/.sandstorm/sandstorm-pkgdef.capnp b/.sandstorm/sandstorm-pkgdef.capnp
index d758e1c..9082afb 100644
--- a/.sandstorm/sandstorm-pkgdef.capnp
+++ b/.sandstorm/sandstorm-pkgdef.capnp
@@ -48,10 +48,10 @@ const pkgdef :Spk.PackageDefinition = (
       # https://github.com/sandstorm-io/sandstorm/blob/master/src/sandstorm/package.capnp
       icons = (
         # Various icons to represent the app in various contexts.
-        #appGrid = (svg = embed "path/to/appgrid-128x128.svg"),
-        #grain = (svg = embed "path/to/grain-24x24.svg"),
-        #market = (svg = embed "path/to/market-150x150.svg"),
-        #marketBig = (svg = embed "path/to/market-big-300x300.svg"),
+        appGrid = (png = (dpi1x = embed "app-graphics/appgrid-128x128.png")),
+        grain = (png = (dpi1x = embed "app-graphics/grain-24x24.png")),
+        market = (png = (dpi1x = embed "app-graphics/market-150x150.png")),
+        marketBig = (png = (dpi1x = embed "app-graphics/market-big-300x300.png")),
       ),
 
       website = "https://gohugo.io",
@@ -123,9 +123,8 @@ const pkgdef :Spk.PackageDefinition = (
         # Screenshots to use for marketing purposes.  Examples below.
         # Sizes are given in device-independent pixels, so if you took these
         # screenshots on a Retina-style high DPI screen, divide each dimension by two.
-
-        (width = 1280, height = 773, png = embed "screenshot1.png"),
-        (width = 1280, height = 773, png = embed "screenshot2.png"),
+        (width = 1366, height = 672, png = embed "app-graphics/screenshot1.png"),
+        (width = 1366, height = 672, png = embed "app-graphics/screenshot2.png"),
       ],
       changeLog = (defaultText = embed "changelog.md"),
       # Documents the history of changes in Github-flavored markdown format (with the same restrictions
diff --git a/.sandstorm/screenshot1.png b/.sandstorm/screenshot1.png
deleted file mode 100644
index 334d878..0000000
Binary files a/.sandstorm/screenshot1.png and /dev/null differ
diff --git a/.sandstorm/screenshot2.png b/.sandstorm/screenshot2.png
deleted file mode 100644
index b3a23e0..0000000
Binary files a/.sandstorm/screenshot2.png and /dev/null differ
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..1d4db94
--- /dev/null
+++ b/README.md
@@ -0,0 +1,34 @@
+Hugo Sandstorm package
+===========================
+
+This is the [Sandstorm](https://sandstorm.io) package of [Hugo](https://gohugo.io/).
+
+![Hugo screenshot](.sandstorm/app-graphics/screenshot2.png "Hugo administration view in Sandstorm")
+
+# How to
+
+The package is done with [vagrant-spk](https://github.com/sandstorm-io/vagrant-spk), a tool designed to help app developers package apps for [Sandstorm](https://sandstorm.io).
+
+You can follow the below mentioned steps to make your own package or to contribute.
+
+## Prerequisites
+
+You will need to install:
+- [Vagrant](https://www.vagrantup.com/)
+- [VirtualBox](https://www.virtualbox.org/wiki/Downloads)
+- Git
+
+## Step by Step
+
+```
+git clone https://github.com/sandstorm-io/vagrant-spk
+git clone https://github.com/ndarilek/hugo-sandstorm
+export PATH=$(pwd)/vagrant-spk:$PATH
+cd hugo-sandstorm
+vagrant-spk vm up
+vagrant-spk dev
+```
+
+visit [http://local.sandstorm.io:6080/](http://local.sandstorm.io:6080/) in a web browser
+
+Note: when you want to fork this repo and create actual app packages for the app store you would need either the original app key or create a new one and make your own version of the app.