diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 0000000..2377a7f
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,9 @@
+# Changelog
+
+- 2015-04-02 
+  - enh: code enhancement, plugin should now work with OSMap too!
+- 2014-04-28 
+  - enh: code cleanup
+- 2013-09-18 
+  - new: public release
+
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..65c0112
--- /dev/null
+++ b/README.md
@@ -0,0 +1,14 @@
+# Xmap - Tags Extension for Joomla
+
+![](https://img.shields.io/static/v1?label=Joomla&message=3.X&style=flat&logo=joomla&logoColor=orange&color=blue)
+![](https://img.shields.io/github/release/z-index-net/joomla-plugin-xmap-tags.svg)
+![](https://img.shields.io/github/downloads/z-index-net/joomla-plugin-xmap-tags/total.svg)
+![](https://img.shields.io/badge/Maintained%3F-no-red.svg)
+![](https://img.shields.io/github/license/z-index-net/joomla-plugin-xmap-tags.svg)
+
+Enables Xmap support for Tag Manager which was added in Joomla 3.1
+
+### Preview
+
+![Screenshot](./screenshots/plg_xmap_com_tags.0.png?raw=true)
+
diff --git a/readme.md b/readme.md
deleted file mode 100644
index e69de29..0000000
diff --git a/screenshots/plg_xmap_com_tags.0.png b/screenshots/plg_xmap_com_tags.0.png
new file mode 100644
index 0000000..69283d4
Binary files /dev/null and b/screenshots/plg_xmap_com_tags.0.png differ