diff --git a/.changeset/rotten-chefs-shout.md b/.changeset/rotten-chefs-shout.md
new file mode 100644
index 000000000..313d1203e
--- /dev/null
+++ b/.changeset/rotten-chefs-shout.md
@@ -0,0 +1,5 @@
+---
+'@portaljs/components': major
+---
+
+Components API tidying up and storybook docs improvements.