diff --git a/README.md b/README.md
new file mode 100644
index 0000000..5949079
--- /dev/null
+++ b/README.md
@@ -0,0 +1,37 @@
+# nymea plug-ins
+
+--------------------------------------------
+<p align="center">
+  <a  href="https://nymea.io">
+    <img src="https://nymea.io/app/default/assets/addons/default/guh/default-theme/resources/img/nymea-logo.svg" width=300>
+  </a>
+</p>
+
+
+This repository contains integrations for nymea. 
+
+nymea (/[n'aiːmea:]/ - is an open source IoT edge server. The plug-in based architecture allows to integrate protocols and APIs. With the build-in rule engine you are able to interconnect devices or services available in the system and create individual scenes and behaviours for your environment.
+
+
+## Getting help
+
+If you want to present your project or want to share your newest developments you can share it in
+[Our Forum](https://forum.nymea.io)
+
+If you are facing any troubles, don't hesitate to reach out for us or the community members, we will be pleased to help you:
+Chat with us on [Telegram](http://t.me/nymeacommunity)
+
+## Wiki and Documentation
+
+* A detailed description how to install and getting started with the *nymea* can be found in the
+
+    [nymea | github wiki](https://wiki.nymea.io).
+
+* A detailed documentation of the source code can be found in the
+
+    [nymea | developer documentation](https://doc.nymea.io).
+
+
+## License
+--------------------------------------------
+> nymea is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, version 3 of the License.