diff --git a/src/components/NcIcon/NcIcon.vue b/src/components/NcIcon/NcIcon.vue
new file mode 100644
index 0000000000..332a10a0ce
--- /dev/null
+++ b/src/components/NcIcon/NcIcon.vue
@@ -0,0 +1,388 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+### Description
+
+Render a Nextcloud icon.
+
+#### Available icons
+
+The following icons are available, besides searching by icon name,
+the search also allows to search by icon tags, for example searching for "trash" will also show the "delete" icon.
+
+```vue
+
+
+
+
+
+```
+
+### Directional usage
+
+The `directional` property allows to enable a language direction aware icon.
+This icon component can be used in places where an language direction aware icon should be used,
+for example if an arrow pointing to the left it used it often points in the wrong direction for right-to-left languages.
+In this cases this icon can be used which will always point into the logical "start" direction.
+
+```vue
+
+