diff --git a/client/galaxy/scripts/components/Alert.md b/client/galaxy/scripts/components/Alert.md
new file mode 100644
index 00000000000..021efd67e56
--- /dev/null
+++ b/client/galaxy/scripts/components/Alert.md
@@ -0,0 +1,21 @@
+### Default alert
+
+```js
+An alert with all defaults
+```
+
+### Alert variants
+
+```js
+
+
A {{variant}} message
+
+```
+
+### Dismissible
+
+```js
+
+
A {{variant}} message
+
+```
diff --git a/client/galaxy/scripts/components/Alert.vue b/client/galaxy/scripts/components/Alert.vue
index 66af11ae62b..15fa4902114 100644
--- a/client/galaxy/scripts/components/Alert.vue
+++ b/client/galaxy/scripts/components/Alert.vue
@@ -1,5 +1,6 @@
+
{{ message }}
@@ -7,21 +8,34 @@