diff --git a/types/README.md b/types/README.md
new file mode 100644
index 00000000..51847b04
--- /dev/null
+++ b/types/README.md
@@ -0,0 +1,7 @@
+# types
+
+The TypeScript definitions in this folder are auto-generated by [sveld](https://github.com/ibm/sveld).
+
+Do not edit these types directly. To add or update property types or definitions, update the JSDoc annotations in the component source code in the [src](../src) folder.
+
+Tests are located in the [tests](../tests) folder.