diff --git a/docs/docs/components/modal.mdx b/docs/docs/components/modal.mdx
new file mode 100644
index 0000000..1795364
--- /dev/null
+++ b/docs/docs/components/modal.mdx
@@ -0,0 +1,22 @@
+# Modal (Spec)
+
+## Notes
+
+- use Create Portal for Markup
+- Proper settings to control the trigger
+- Proper way to adjust size, position, etc.
+- Overlay Customization and option to not show it
+- Lock scroll when modal is visible
+- Close on ClickOutside
+- Close on EscapeKey
+- use `<dialog>` element instead of `<div>`
+
+| Attributes            |        Values        | Optional ? |
+| :-------------------- | :------------------: | ---------: |
+| `isOpen`              | boolean (true/false) |         No |
+| `onClose`             |       function       |        Yes |
+| `onOpen`              |       function       |        Yes |
+| `size`                |        string        |        Yes |
+| `showOverlay`         |       boolean        |        Yes |
+| `closeOnOutsideClick` |       boolean        |        Yes |
+| `overlayStyles`       |     Style Object     |        Yes |