diff --git a/docs/source/_assets/less/main.less b/docs/source/_assets/less/main.less
index 69572265a..15e070c1a 100644
--- a/docs/source/_assets/less/main.less
+++ b/docs/source/_assets/less/main.less
@@ -19,6 +19,19 @@ a {
}
}
+@spacing-scale:
+ 'px' 1px,
+ '0' 0,
+ '1' 0.25rem,
+ '2' 0.5rem,
+ '3' 0.75rem,
+ '4' 1rem,
+ '6' 1.5rem,
+ '8' 2rem,
+ '12' 3rem,
+ '16' 4rem,
+;
+
@text-colors:
'light' @text-light,
'light-soft' @text-light-soft,
diff --git a/docs/source/_layouts/master.blade.php b/docs/source/_layouts/master.blade.php
index 1949da9b1..7ed1d962e 100644
--- a/docs/source/_layouts/master.blade.php
+++ b/docs/source/_layouts/master.blade.php
@@ -45,6 +45,7 @@
Grid
Images
Position
+ Shadows
Spacing
Text
Z-Index
diff --git a/docs/source/shadows.md b/docs/source/shadows.md
new file mode 100644
index 000000000..b95dbf9bd
--- /dev/null
+++ b/docs/source/shadows.md
@@ -0,0 +1,43 @@
+---
+extends: _layouts.master
+title: "Shadows"
+---
+
+# Shadows
+
+Box shadows can be applied using the shadow utilities. By default these are a linear scale, where the lower values represent smaller (shallow) shadows, and higher values represent bigger (deeper) shadows.
+
+
+
.shadow-1
+
.shadow-2
+
.shadow-3
+
+
+```html
+
+
+
+```
+
+```less
+div {
+ .shadow-1;
+ .shadow-2;
+ .shadow-3;
+}
+```
+
+### Customizing shadows
+
+You can customize the shadow utilities using the `@shadows` variable. Please note that the entire scale must be redefined. It's not possible to add a new value to the existing scale. Shadows can be defined with multiple `box-shadow` values, as illustrated below.
+
+```less
+// The default shadows scale
+@shadows:
+ '1' ~"0 1px 3px rgba(0,0,0,0.12), 0 1px 2px rgba(0,0,0,0.24)",
+ '2' ~"0 3px 6px rgba(0,0,0,0.16), 0 3px 6px rgba(0,0,0,0.23)",
+ '3' ~"0 10px 20px rgba(0,0,0,0.19), 0 6px 6px rgba(0,0,0,0.23)",
+ '4' ~"0 14px 28px rgba(0,0,0,0.25), 0 10px 10px rgba(0,0,0,0.22)",
+ '5' ~"0 19px 38px rgba(0,0,0,0.30), 0 15px 12px rgba(0,0,0,0.22)",
+;
+```