diff --git a/packages/core/README.md b/packages/core/README.md
new file mode 100644
index 0000000000..0019e27e5a
--- /dev/null
+++ b/packages/core/README.md
@@ -0,0 +1,3 @@
+# @ionic/core
+
+This contains the core stencil components for ionic based applications.
\ No newline at end of file