diff --git a/MIGRATION-v1.md b/MIGRATION-v1.md
new file mode 100644
index 0000000000..8ca48427dd
--- /dev/null
+++ b/MIGRATION-v1.md
@@ -0,0 +1,25 @@
+# Migration Guide
+
+Introducing version 1 of the Spirit Design System packages.
+
+💁 Please follow these steps to safely upgrade your Design System to Spirit Design System v1 components.
+
+## spirit-form-validations v1
+
+- [Migration Guide](./packages/form-validations/MIGRATION-v1.md)
+
+## spirit-web v1
+
+- [Migration Guide](./packages/web/MIGRATION-v1.md)
+
+## spirit-web-react v1
+
+- [Migration Guide](./packages/web-react/MIGRATION-v1.md)
+
+## spirit-web-twig v1
+
+- _spirit-web-twig_ was released as version 1 by default
+
+---
+
+Please refer back to this guide or reach out to our team if you encounter any issues during migration.
diff --git a/MIGRATION-v2.md b/MIGRATION-v2.md
new file mode 100644
index 0000000000..76a1f10075
--- /dev/null
+++ b/MIGRATION-v2.md
@@ -0,0 +1,13 @@
+# Migration Guide
+
+Introducing version 2 of the Spirit Design System packages.
+
+💁 Please follow these steps to safely upgrade your Design System to Spirit Design System v2 components.
+
+## spirit-web-twig v2
+
+- [Migration Guide](./packages/web-twig/MIGRATION-v2.md)
+
+---
+
+Please refer back to this guide or reach out to our team if you encounter any issues during migration.