diff --git a/README.md b/README.md
index c9f84cd..79e7039 100644
--- a/README.md
+++ b/README.md
@@ -1,7 +1,8 @@
-Mwmbl: No ads, no tracking, no cruft, no profit
-===============================================
+
-[](https://matrix.to/#/#mwmbl:matrix.org)
+# Mwmbl - **No ads, no tracking, no cruft, no profit**
+
+[](https://matrix.to/#/#mwmbl:matrix.org)
Mwmbl is a non-profit, ad-free, free-libre and free-lunch search
engine with a focus on useability and speed. At the moment it is
diff --git a/docs/assets/images/banner_mwmbl.svg b/docs/assets/images/banner_mwmbl.svg
new file mode 100644
index 0000000..f64db44
--- /dev/null
+++ b/docs/assets/images/banner_mwmbl.svg
@@ -0,0 +1,13 @@
+
diff --git a/docs/assets/images/mwmbl_logo.svg b/docs/assets/images/mwmbl_logo.svg
new file mode 100644
index 0000000..1e5a8e8
--- /dev/null
+++ b/docs/assets/images/mwmbl_logo.svg
@@ -0,0 +1,45 @@
+
+
\ No newline at end of file
diff --git a/docs/assets/images/mwmbl_logo_full.png b/docs/assets/images/mwmbl_logo_full.png
new file mode 100644
index 0000000..21a03e6
Binary files /dev/null and b/docs/assets/images/mwmbl_logo_full.png differ
diff --git a/docs/assets/images/mwmbl_logo_full.svg b/docs/assets/images/mwmbl_logo_full.svg
new file mode 100644
index 0000000..02e5c00
--- /dev/null
+++ b/docs/assets/images/mwmbl_logo_full.svg
@@ -0,0 +1 @@
+
\ No newline at end of file
diff --git a/docs/assets/images/mwmbl_logo_white.svg b/docs/assets/images/mwmbl_logo_white.svg
new file mode 100644
index 0000000..45b7b60
--- /dev/null
+++ b/docs/assets/images/mwmbl_logo_white.svg
@@ -0,0 +1,4 @@
+