diff --git a/packages/reference/README.md b/packages/reference/README.md
new file mode 100644
index 00000000..8ff16259
--- /dev/null
+++ b/packages/reference/README.md
@@ -0,0 +1,8 @@
+# @strudel/reference
+
+this package contains metadata for all documented strudel functions, useful to implement a reference.
+
+```js
+import { reference } from '@strudel/reference';
+console.log(reference)
+```