diff --git a/README.md b/README.md
new file mode 100644
index 0000000..38d7898
--- /dev/null
+++ b/README.md
@@ -0,0 +1,27 @@
+# HA SwitchPlate HASPone
+
+The HA SwitchPlate is a DIY user-programmable LCD touchscreen you can mount into a [standard North American work box](https://www.nema.org/Standards/ComplimentaryDocuments/NEMA%20WD%206%20-%20Dimensions%20for%20Wiring%20Devices%20-%20Excerpt.pdf).  It connects to your home automation system over Wifi using [MQTT](https://en.wikipedia.org/wiki/MQTT) to display useful information and to control your smart devices.  The result is an attractive and highly-customizable controller for your home automation which you can build yourself!
+
+![HA SwitchPlate Models](https://github.com/HASwitchPlate/HASPone/blob/main/images/HASwitchPlate_Three_Model_Variations.png?raw=true)
+
+## Demo screens
+
+![Scene controller](https://github.com/HASwitchPlate/HASPone/blob/main/images/HASwitchPlate_Demo_SceneController.png?raw=true) ![Status display](https://github.com/HASwitchPlate/HASPone/blob/main/images/HASwitchPlate_Demo_Status.png?raw=true) ![Media control](https://github.com/HASwitchPlate/HASPone/blob/main/images/HASwitchPlate_Demo_Media.png?raw=true) ![Alarm Panel](https://github.com/HASwitchPlate/HASPone/blob/main/images/HASwitchPlate_Demo_AlarmPanel.png?raw=true) ![Slider/Dimmer Controls](https://github.com/HASwitchPlate/HASPone/blob/main/images/HASwitchPlate_Demo_Dimmers.png?raw=true) ![HVAC Controls](https://github.com/HASwitchPlate/HASPone/blob/main/images/HASwitchPlate_Demo_HVAC.png?raw=true) ![Light toggles](https://github.com/HASwitchPlate/HASPone/blob/main/images/HASwitchPlate_Demo_LightToggles.png?raw=true) ![Fan controller](https://github.com/HASwitchPlate/HASPone/blob/main/images/HASwitchPlate_Demo_FanControls.png?raw=true) ![WiFi Setup](https://github.com/HASwitchPlate/HASPone/blob/main/images/WiFi_Config_0.png?raw=true)
+
+## Purchase an assembled unit
+
+As this build requires some specialist skills and tools, I will occasionally be [offering assembled devices for sale here](https://www.tindie.com/products/luma/ha-switchplate-hasp-single-wide-assembled/).
+
+## Build your own HASPone
+
+Check out the build guide in the HASPone wiki [here](https://github.com/HASwitchPlate/HASPone/wiki/Building-your-own-HASPone).
+
+## Setup HASPone for Home Assistant
+
+If you're purchased or built a HASPone, [now it's time to make it talk to Home Assistant](https://github.com/HASwitchPlate/HASPone/wiki/Configure-your-HASPone-for-Home-Assistant)
+
+## Buy me a coffee
+
+[![Buy me a coffee](https://www.buymeacoffee.com/assets/img/custom_images/black_img.png)](https://www.buymeacoffee.com/gW5rPpsKR)
+
+This project is powered by coffee.  [I might get a little weird about it at times](https://github.com/aderusha/RoastLearner), but it's not much of a stretch to suggest that coffee both powers and consumes a fair portion of my mental energy.  [Hook me up if you think HASP is cool](https://www.buymeacoffee.com/gW5rPpsKR).  Thanks!
diff --git a/images/HASwitchPlate_Demo_3x3.png b/images/HASwitchPlate_Demo_3x3.png
new file mode 100644
index 0000000..22311b9
Binary files /dev/null and b/images/HASwitchPlate_Demo_3x3.png differ
diff --git a/images/HASwitchPlate_Demo_AlarmPanel.png b/images/HASwitchPlate_Demo_AlarmPanel.png
new file mode 100644
index 0000000..c7ac8f8
Binary files /dev/null and b/images/HASwitchPlate_Demo_AlarmPanel.png differ
diff --git a/images/HASwitchPlate_Demo_Dimmers.png b/images/HASwitchPlate_Demo_Dimmers.png
new file mode 100644
index 0000000..4d46ecf
Binary files /dev/null and b/images/HASwitchPlate_Demo_Dimmers.png differ
diff --git a/images/HASwitchPlate_Demo_FanControls.png b/images/HASwitchPlate_Demo_FanControls.png
new file mode 100644
index 0000000..9d7fe33
Binary files /dev/null and b/images/HASwitchPlate_Demo_FanControls.png differ
diff --git a/images/HASwitchPlate_Demo_HVAC.png b/images/HASwitchPlate_Demo_HVAC.png
new file mode 100644
index 0000000..9b0eda3
Binary files /dev/null and b/images/HASwitchPlate_Demo_HVAC.png differ
diff --git a/images/HASwitchPlate_Demo_LightToggles.png b/images/HASwitchPlate_Demo_LightToggles.png
new file mode 100644
index 0000000..98deb00
Binary files /dev/null and b/images/HASwitchPlate_Demo_LightToggles.png differ
diff --git a/images/HASwitchPlate_Demo_Media.png b/images/HASwitchPlate_Demo_Media.png
new file mode 100644
index 0000000..2a74662
Binary files /dev/null and b/images/HASwitchPlate_Demo_Media.png differ
diff --git a/images/HASwitchPlate_Demo_PrintStatus.png b/images/HASwitchPlate_Demo_PrintStatus.png
new file mode 100644
index 0000000..11afc32
Binary files /dev/null and b/images/HASwitchPlate_Demo_PrintStatus.png differ
diff --git a/images/HASwitchPlate_Demo_SceneController.png b/images/HASwitchPlate_Demo_SceneController.png
new file mode 100644
index 0000000..c65062f
Binary files /dev/null and b/images/HASwitchPlate_Demo_SceneController.png differ
diff --git a/images/HASwitchPlate_Demo_Status.png b/images/HASwitchPlate_Demo_Status.png
new file mode 100644
index 0000000..fc3d491
Binary files /dev/null and b/images/HASwitchPlate_Demo_Status.png differ
diff --git a/images/HASwitchPlate_Three_Model_Variations.png b/images/HASwitchPlate_Three_Model_Variations.png
new file mode 100644
index 0000000..5ac228a
Binary files /dev/null and b/images/HASwitchPlate_Three_Model_Variations.png differ
diff --git a/images/WiFi_Config_0.png b/images/WiFi_Config_0.png
new file mode 100644
index 0000000..e415a9c
Binary files /dev/null and b/images/WiFi_Config_0.png differ