diff --git a/README.md b/README.md
new file mode 100644
index 0000000..165a422
--- /dev/null
+++ b/README.md
@@ -0,0 +1,9 @@
+# basic theming
+
+the idea behind this repo is to create a starting point with which to apply to pelican, hugo, wordpress, etc themes. the styles here are very basic so this is a work in progress. no sites are using this just yet and the html files you see here are simply examples to visualise the styles.
+
+ping me here:
+
+ 📧
+ 💬
+