diff --git a/README.md b/README.md
index e69de29..df8d172 100644
--- a/README.md
+++ b/README.md
@@ -0,0 +1,12 @@
+## Butter Portal
+
+This is a flask application that will replace the current static butterbox portal.
+Some screenshots:
+
+![Portal screenshot_homepage](butter-new-portal.jpg "Homepage")
+![Portal screenshot_secure_messaging](butter-new-portal2.jpg "Delta Chat page")
+![Portal screenshot_files](butter-new-portal3.jpg "File viewer page")
+
+![Portal screenshot_app_settings1](butter-new-portal4.jpg "Application settings")
+![Portal screenshot_app_settings2](butter-new-portal5.jpg "Application Settings - continued")
+![Portal screenshot_app_settings3](butter-new-portal6.jpg "Apply changes")
\ No newline at end of file
diff --git a/butter-new-portal.jpg b/butter-new-portal.jpg
new file mode 100644
index 0000000..f555838
Binary files /dev/null and b/butter-new-portal.jpg differ
diff --git a/butter-new-portal2.jpg b/butter-new-portal2.jpg
new file mode 100644
index 0000000..94c41ed
Binary files /dev/null and b/butter-new-portal2.jpg differ
diff --git a/butter-new-portal3.jpg b/butter-new-portal3.jpg
new file mode 100644
index 0000000..22678ca
Binary files /dev/null and b/butter-new-portal3.jpg differ
diff --git a/butter-new-portal4.jpg b/butter-new-portal4.jpg
new file mode 100644
index 0000000..f5657f3
Binary files /dev/null and b/butter-new-portal4.jpg differ
diff --git a/butter-new-portal5.jpg b/butter-new-portal5.jpg
new file mode 100644
index 0000000..a693a96
Binary files /dev/null and b/butter-new-portal5.jpg differ
diff --git a/butter-new-portal6.jpg b/butter-new-portal6.jpg
new file mode 100644
index 0000000..284ab84
Binary files /dev/null and b/butter-new-portal6.jpg differ