
diff --git a/docs/source/flexbox.md b/docs/source/flexbox.md
deleted file mode 100644
index aa12545d8..000000000
--- a/docs/source/flexbox.md
+++ /dev/null
@@ -1,6 +0,0 @@
----
-extends: _layouts.markdown
-title: "Flexbox"
----
-
-# Flexbox
diff --git a/docs/source/images.md b/docs/source/images.md
deleted file mode 100644
index 0d40d2a8b..000000000
--- a/docs/source/images.md
+++ /dev/null
@@ -1,6 +0,0 @@
----
-extends: _layouts.markdown
-title: "Images"
----
-
-# Images
diff --git a/docs/source/overflow.md b/docs/source/overflow.md
deleted file mode 100644
index 2f42e7317..000000000
--- a/docs/source/overflow.md
+++ /dev/null
@@ -1,50 +0,0 @@
----
-extends: _layouts.markdown
-title: "Overflow"
----
-
-# Overflow
-
-The overflow utilities are simply `overflow` property helpers.
-
-```html
-
-
-
-
-
-
-
-```
-
-```less
-
-
-div {
- .overflow-auto;
- .overflow-hidden;
- .overflow-visible;
- .overflow-scroll;
- .overflow-scroll-x;
- .overflow-scroll-y;
- .mask;
-}
-```
-
-Note that `.overflow-hidden` is available in a shorthand called `.mask`.
-
-## Responsive
-
-The display utitlies can also be used with
responsive prefixes:
-
-```html
-
-```
-
-```less
-div {
- .screen(lg, {
- .overflow-scroll;
- });
-}
-```
diff --git a/docs/source/text.md b/docs/source/text.md
deleted file mode 100644
index 61bd829f5..000000000
--- a/docs/source/text.md
+++ /dev/null
@@ -1,243 +0,0 @@
----
-extends: _layouts.markdown
-title: "Text"
----
-
-# Text
-
-
-
-
Font family
-
-```html
-
-
-
-```
-
-```less
-div {
- .sans;
- .serif;
- .mono;
-}
-```
-
-```less
-// Customize the font stack
-@font-family-sans: -apple-system, BlinkMacSystemFont, "Segoe UI", "Roboto", "Oxygen", "Ubuntu", "Cantarell", "Fira Sans", "Droid Sans", "Helvetica Neue", Arial, sans-serif;
-@font-family-serif: Constantia, "Lucida Bright", Lucidabright, "Lucida Serif", Lucida, "DejaVu Serif", "Bitstream Vera Serif", "Liberation Serif", Georgia, serif;
-@font-family-mono: Consolas, "Andale Mono WT", "Andale Mono", "Lucida Console", "Lucida Sans Typewriter", "DejaVu Sans Mono", "Bitstream Vera Sans Mono", "Liberation Mono", "Nimbus Mono L", Monaco, "Courier New", Courier, monospace;
-@font-family-base: @font-family-sans;
-```
-
-
Font sizes
-
-```html
-
-
-
-
-
-
-
-```
-
-```less
-div {
- .text-xs;
- .text-sm;
- .text-base;
- .text-lg;
- .text-xl;
- .text-2xl;
- .text-3xl;
-}
-```
-
-```less
-// Customize the text size scale
-@text-size-scale:
- 'xs' @font-size-xs,
- 'sm' @font-size-sm,
- 'base' @font-size-base,
- 'lg' @font-size-lg,
- 'xl' @font-size-xl,
- '2xl' @font-size-2xl,
- '3xl' @font-size-3xl,
-;
-```
-
-
Font weight
-
-```html
-
-
-
-
-
-```
-
-```less
-div {
- .text-hairline;
- .text-thin;
- .text-regular;
- .text-medium;
- .text-bold;
-}
-```
-
-```less
-// Customize the text weight scale
-@text-weight-scale:
- 'hairline' 200,
- 'thin' 300,
- 'regular' 400,
- 'medium' 600,
- 'bold' 700,
-;
-```
-
-
Colors
-
-```html
-
-
-
-
-
-
-
-
-
-```
-
-```less
-div {
- .text-light;
- .text-light-soft;
- .text-light-softer;
- .text-light-softest;
-
- .text-dark;
- .text-dark-soft;
- .text-dark-softer;
- .text-dark-softest;
-}
-```
-
-```less
-// Customize the text colors
-@text-colors:
- 'light' hsl(0, 0%, 100%),
- 'light-soft' hsl(0, 0%, 60%),
- 'light-softer' hsl(0, 0%, 45%),
- 'light-softest' hsl(0, 0%, 35%),
-
- 'dark' hsl(0, 0%, 25%),
- 'dark-soft' hsl(0, 0%, 50%),
- 'dark-softer' hsl(0, 0%, 65%),
- 'dark-softest' hsl(0, 0%, 75%),
-;
-```
-
-
Alignment
-
-```less
-div {
- // Horizontal
- .text-center;
- .text-left;
- .text-right;
- .text-justify;
-
- // Vertical
- .align-baseline;
- .align-top;
- .align-middle;
- .align-bottom;
- .align-text-top;
- .align-text-bottom;
-}
-```
-
-
Styles
-
-```less
-div { .text-em; } // Italic
-div { .text-uppercase; } // Uppercase
-div { .text-underline; } // Underline
-div { .text-break; } // Pre line
-div { .text-no-wrap; } // No wrap
-div { .text-force-wrap; } // Break word
-div { .text-smooth; } // Anti-aliased
-div { .text-strike; } // Line through
-div { .text-ellipsis; } // Overflow ellipsis
-div { .text-shadow-solid; } // Shadow
-```
-
-
Line height
-
-```html
-
-
-
-
-```
-
-```less
-div {
- .leading-none;
- .leading-tight;
- .leading-normal;
- .leading-loose;
-}
-```
-
-```less
-// Set the default line height
-@line-height: 1.5;
-
-// Customize the leading scale
-@leading-scale:
- 'none' 1,
- 'tight' 1.25,
- 'normal' 1.5,
- 'loose' 2,
-;
-```
-
-
Letter spacing
-
-```html
-
-
-
-```
-
-```less
-div {
- .tracking-tight;
- .tracking-normal;
- .tracking-wide;
-}
-```
-
-```less
-// Customize the tracking scale
-@tracking-scale:
- 'tight' -0.05em,
- 'normal' 0,
- 'wide' 0.1em,
-;
-```
diff --git a/docs/source/utilities/alignment.md b/docs/source/utilities/alignment.md
new file mode 100644
index 000000000..d30b23379
--- /dev/null
+++ b/docs/source/utilities/alignment.md
@@ -0,0 +1,13 @@
+---
+extends: _layouts.markdown
+title: "Alignment"
+---
+
+# Alignment
+
+
+
diff --git a/docs/source/utilities/appearance.md b/docs/source/utilities/appearance.md
new file mode 100644
index 000000000..a65f62d9a
--- /dev/null
+++ b/docs/source/utilities/appearance.md
@@ -0,0 +1,13 @@
+---
+extends: _layouts.markdown
+title: "Appearance"
+---
+
+# Appearance
+
+
+
diff --git a/docs/source/backgrounds.md b/docs/source/utilities/backgrounds.md
similarity index 100%
rename from docs/source/backgrounds.md
rename to docs/source/utilities/backgrounds.md
diff --git a/docs/source/utilities/backgrounds/color.md b/docs/source/utilities/backgrounds/color.md
new file mode 100644
index 000000000..de300b7e6
--- /dev/null
+++ b/docs/source/utilities/backgrounds/color.md
@@ -0,0 +1,234 @@
+---
+extends: _layouts.markdown
+title: "Backgrounds"
+---
+
+# Background Color
+
+
+
+
Colors
+
+
+
+
+
+
+ .bg-light
+
+
+ .bg-light-soft
+
+
+ .bg-light-softer
+
+
+ .bg-light-softest
+
+
+
+
+
+
+ .bg-dark
+
+
+ .bg-dark-soft
+
+
+ .bg-dark-softer
+
+
+ .bg-dark-softest
+
+
+
+
+
+
+
+
+
+ .bg-red-dark
+
+
+ .bg-red
+
+
+ .bg-red-light
+
+
+ .bg-red-lightest
+
+
+
+
+
+
+ .bg-orange-dark
+
+
+ .bg-orange
+
+
+ .bg-orange-light
+
+
+ .bg-orange-lightest
+
+
+
+
+
+
+ .bg-yellow-dark
+
+
+ .bg-yellow
+
+
+ .bg-yellow-light
+
+
+ .bg-yellow-lightest
+
+
+
+
+
+
+
+
+
+ .bg-green-dark
+
+
+ .bg-green
+
+
+ .bg-green-light
+
+
+ .bg-green-lightest
+
+
+
+
+
+
+ .bg-teal-dark
+
+
+ .bg-teal
+
+
+ .bg-teal-light
+
+
+ .bg-teal-lightest
+
+
+
+
+
+
+ .bg-blue-dark
+
+
+ .bg-blue
+
+
+ .bg-blue-light
+
+
+ .bg-blue-lightest
+
+
+
+
+
+
+
+
+
+ .bg-indigo-dark
+
+
+ .bg-indigo
+
+
+ .bg-indigo-light
+
+
+ .bg-indigo-lightest
+
+
+
+
+
+
+ .bg-purple-dark
+
+
+ .bg-purple
+
+
+ .bg-purple-light
+
+
+ .bg-purple-lightest
+
+
+
+
+
+
+ .bg-pink-dark
+
+
+ .bg-pink
+
+
+ .bg-pink-light
+
+
+ .bg-pink-lightest
+
+
+
+
+
+Using the utilities in HTML:
+
+```html
+
+
+
+
+
+
+
+
+
+```
+
+Using the utilities in Less:
+
+```less
+div {
+ .bg-light;
+ .bg-light-soft;
+ .bg-light-softer;
+ .bg-light-softest;
+
+ .bg-dark;
+ .bg-dark-soft;
+ .bg-dark-softer;
+ .bg-dark-softest;
+}
+```
+
diff --git a/docs/source/utilities/backgrounds/position.md b/docs/source/utilities/backgrounds/position.md
new file mode 100644
index 000000000..856a98a3f
--- /dev/null
+++ b/docs/source/utilities/backgrounds/position.md
@@ -0,0 +1,13 @@
+---
+extends: _layouts.markdown
+title: "Background Position"
+---
+
+# Background Position
+
+
+
diff --git a/docs/source/utilities/backgrounds/size.md b/docs/source/utilities/backgrounds/size.md
new file mode 100644
index 000000000..3ed4afc1f
--- /dev/null
+++ b/docs/source/utilities/backgrounds/size.md
@@ -0,0 +1,13 @@
+---
+extends: _layouts.markdown
+title: "Background Size"
+---
+
+# Background Size
+
+
+
diff --git a/docs/source/borders.md b/docs/source/utilities/borders.md
similarity index 100%
rename from docs/source/borders.md
rename to docs/source/utilities/borders.md
diff --git a/docs/source/utilities/borders/base.md b/docs/source/utilities/borders/base.md
new file mode 100644
index 000000000..160fea63d
--- /dev/null
+++ b/docs/source/utilities/borders/base.md
@@ -0,0 +1,77 @@
+---
+extends: _layouts.markdown
+title: "Borders"
+---
+
+# Borders
+
+
+
+
+
Sizes
+
+Construct border size utilities using the `.border{-side?}{-width?}` syntax. For example, `.border` would add a `1px` border to all sides of the element, where `.border-b-4` would add a `4px` border to the bottom of the element. By default, borders are `solid`, and use the `@default-border-color`.
+
+
+
+
+
Side (optional)
+
All
+
t Top
+
r Right
+
b Bottom
+
l Left
+
+
+
Width (optional)
+
0 0px
+
1px
+
2 2px
+
4 4px
+
8 8px
+
+
+
+### Border size examples
+
+```html
+
+
+
+
+
+
+
+
+```
+
+```less
+// Using the border size utilities in Less
+div {
+ .border;
+ .border-t;
+ .border-t-2;
+}
+```
+
+### Customizing border sizes
+
+You can easily customize the border size utilities using the `@border-width-scale` variable. Please note that the entire scale must be redefined. It's not possible to add a new value to the existing scale.
+
+```less
+// The default border width scale
+@border-width-scale:
+ '0' 0,
+ default 1px,
+ '2' 2px,
+ '4' 4px,
+ '8' 8px,
+;
+```
diff --git a/docs/source/utilities/borders/color.md b/docs/source/utilities/borders/color.md
new file mode 100644
index 000000000..c8d0cc409
--- /dev/null
+++ b/docs/source/utilities/borders/color.md
@@ -0,0 +1,56 @@
+---
+extends: _layouts.markdown
+title: "Border Color"
+---
+
+# Border Color
+
+
+
+
Colors
+
+By default, borders use the `@default-border-color`. To override a border color, add one of the border color utilities.
+
+```html
+
+
+
+
+
+
+
+
+
+```
+
+```less
+div {
+ .border-dark;
+ .border-dark-soft;
+ .border-dark-softer;
+
+ .border-light;
+ .border-light-soft;
+ .border-light-softer;
+
+ .border-invisible;
+}
+```
+
+The default border colors can also be modified using the following variables.
+
+```less
+// Variable: Default:
+@border-dark: hsl(0, 0%, 82%);
+@border-dark-soft: hsl(0, 0%, 90%);
+@border-dark-softer: hsl(0, 0%, 96%);
+
+@border-light: hsl(0, 0%, 100%);
+@border-light-soft: hsl(0, 0%, 60%);
+@border-light-softer: hsl(0, 0%, 35%);
+
+@default-border-color: @border-dark-soft;
+```
diff --git a/docs/source/utilities/borders/radius.md b/docs/source/utilities/borders/radius.md
new file mode 100644
index 000000000..e93bf6ca1
--- /dev/null
+++ b/docs/source/utilities/borders/radius.md
@@ -0,0 +1,13 @@
+---
+extends: _layouts.markdown
+title: "Border Radius"
+---
+
+# Border Radius
+
+
+
diff --git a/docs/source/utilities/borders/style.md b/docs/source/utilities/borders/style.md
new file mode 100644
index 000000000..cc442be8f
--- /dev/null
+++ b/docs/source/utilities/borders/style.md
@@ -0,0 +1,13 @@
+---
+extends: _layouts.markdown
+title: "Border Style"
+---
+
+# Border Style
+
+
+
diff --git a/docs/source/utilities/container.md b/docs/source/utilities/container.md
new file mode 100644
index 000000000..dbe2d61c5
--- /dev/null
+++ b/docs/source/utilities/container.md
@@ -0,0 +1,13 @@
+---
+extends: _layouts.markdown
+title: "Container"
+---
+
+# Container
+
+
+
diff --git a/docs/source/display.md b/docs/source/utilities/display.md
similarity index 70%
rename from docs/source/display.md
rename to docs/source/utilities/display.md
index 09b41897a..886458622 100644
--- a/docs/source/display.md
+++ b/docs/source/utilities/display.md
@@ -5,13 +5,20 @@ title: "Display"
# Display
-> If you're looking for flexbox utilities, see the [flexbox](/flexbox) page.
+
+
+> If you're looking for Flexbox utilities, see the [Flexbox](/flexbox) page.
The display utilities simply `display` property helpers.
```html
+
@@ -23,19 +30,6 @@ The display utilities simply `display` property helpers.
```
-```less
-// Using the utilities in Less:
-
-div {
- .block;
- .inline-block;
- .table;
- .table-row;
- .table-cell;
- .hidden;
-}
-```
-
## Responsive
The display utitlies can also be used with
responsive prefixes:
diff --git a/docs/source/utilities/flexbox.md b/docs/source/utilities/flexbox.md
new file mode 100644
index 000000000..59ee194fe
--- /dev/null
+++ b/docs/source/utilities/flexbox.md
@@ -0,0 +1,12 @@
+---
+extends: _layouts.markdown
+title: "Flexbox"
+---
+
+# Flexbox
+
+
diff --git a/docs/source/utilities/floats.md b/docs/source/utilities/floats.md
new file mode 100644
index 000000000..4d160fa66
--- /dev/null
+++ b/docs/source/utilities/floats.md
@@ -0,0 +1,12 @@
+---
+extends: _layouts.markdown
+title: "Floats"
+---
+
+# Floats
+
+
diff --git a/docs/source/utilities/interactivity/cursor.md b/docs/source/utilities/interactivity/cursor.md
new file mode 100644
index 000000000..bd89925f6
--- /dev/null
+++ b/docs/source/utilities/interactivity/cursor.md
@@ -0,0 +1,12 @@
+---
+extends: _layouts.markdown
+title: "Cursor"
+---
+
+# Cursor
+
+
diff --git a/docs/source/utilities/interactivity/pointer-events.md b/docs/source/utilities/interactivity/pointer-events.md
new file mode 100644
index 000000000..d9d6f0a83
--- /dev/null
+++ b/docs/source/utilities/interactivity/pointer-events.md
@@ -0,0 +1,12 @@
+---
+extends: _layouts.markdown
+title: "Pointer Events"
+---
+
+# Pointer Events
+
+
diff --git a/docs/source/utilities/interactivity/resize.md b/docs/source/utilities/interactivity/resize.md
new file mode 100644
index 000000000..35ae6acdf
--- /dev/null
+++ b/docs/source/utilities/interactivity/resize.md
@@ -0,0 +1,12 @@
+---
+extends: _layouts.markdown
+title: "Resize"
+---
+
+# Resize
+
+
diff --git a/docs/source/utilities/interactivity/user-select.md b/docs/source/utilities/interactivity/user-select.md
new file mode 100644
index 000000000..57b44f298
--- /dev/null
+++ b/docs/source/utilities/interactivity/user-select.md
@@ -0,0 +1,12 @@
+---
+extends: _layouts.markdown
+title: "User Select"
+---
+
+# User Select
+
+
diff --git a/docs/source/utilities/opacity.md b/docs/source/utilities/opacity.md
new file mode 100644
index 000000000..61910d60b
--- /dev/null
+++ b/docs/source/utilities/opacity.md
@@ -0,0 +1,12 @@
+---
+extends: _layouts.markdown
+title: "Opacity"
+---
+
+# Opacity
+
+
diff --git a/docs/source/utilities/overflow.md b/docs/source/utilities/overflow.md
new file mode 100644
index 000000000..a2f9f0861
--- /dev/null
+++ b/docs/source/utilities/overflow.md
@@ -0,0 +1,12 @@
+---
+extends: _layouts.markdown
+title: "Overflow"
+---
+
+# Overflow
+
+
diff --git a/docs/source/position.md b/docs/source/utilities/positioning.md
similarity index 81%
rename from docs/source/position.md
rename to docs/source/utilities/positioning.md
index 70052b376..e613e546f 100644
--- a/docs/source/position.md
+++ b/docs/source/utilities/positioning.md
@@ -1,9 +1,15 @@
---
extends: _layouts.markdown
-title: "Position"
+title: "Positioning"
---
-# Position
+# Positioning
+
+
The position utilities are primarily `position` property helpers.
diff --git a/docs/source/shadows.md b/docs/source/utilities/shadows.md
similarity index 100%
rename from docs/source/shadows.md
rename to docs/source/utilities/shadows.md
diff --git a/docs/source/utilities/sizing/height.md b/docs/source/utilities/sizing/height.md
new file mode 100644
index 000000000..143ba34a4
--- /dev/null
+++ b/docs/source/utilities/sizing/height.md
@@ -0,0 +1,12 @@
+---
+extends: _layouts.markdown
+title: "Height"
+---
+
+# Height
+
+
diff --git a/docs/source/utilities/sizing/max-height.md b/docs/source/utilities/sizing/max-height.md
new file mode 100644
index 000000000..9cfa8d373
--- /dev/null
+++ b/docs/source/utilities/sizing/max-height.md
@@ -0,0 +1,12 @@
+---
+extends: _layouts.markdown
+title: "Max-Height"
+---
+
+# Max-Height
+
+
diff --git a/docs/source/utilities/sizing/max-width.md b/docs/source/utilities/sizing/max-width.md
new file mode 100644
index 000000000..171c505ae
--- /dev/null
+++ b/docs/source/utilities/sizing/max-width.md
@@ -0,0 +1,12 @@
+---
+extends: _layouts.markdown
+title: "Max-Width"
+---
+
+# Max-Width
+
+
diff --git a/docs/source/utilities/sizing/min-height.md b/docs/source/utilities/sizing/min-height.md
new file mode 100644
index 000000000..93138bd16
--- /dev/null
+++ b/docs/source/utilities/sizing/min-height.md
@@ -0,0 +1,12 @@
+---
+extends: _layouts.markdown
+title: "Min-Height"
+---
+
+# Min-Height
+
+
diff --git a/docs/source/utilities/sizing/min-width.md b/docs/source/utilities/sizing/min-width.md
new file mode 100644
index 000000000..0d1e5fb85
--- /dev/null
+++ b/docs/source/utilities/sizing/min-width.md
@@ -0,0 +1,12 @@
+---
+extends: _layouts.markdown
+title: "Min-Width"
+---
+
+# Min-Width
+
+
diff --git a/docs/source/utilities/sizing/width.md b/docs/source/utilities/sizing/width.md
new file mode 100644
index 000000000..42570a392
--- /dev/null
+++ b/docs/source/utilities/sizing/width.md
@@ -0,0 +1,12 @@
+---
+extends: _layouts.markdown
+title: "Width"
+---
+
+# Width
+
+
diff --git a/docs/source/spacing.md b/docs/source/utilities/spacing/margin.md
similarity index 99%
rename from docs/source/spacing.md
rename to docs/source/utilities/spacing/margin.md
index 276bcbf99..7ea91762d 100644
--- a/docs/source/spacing.md
+++ b/docs/source/utilities/spacing/margin.md
@@ -1,14 +1,14 @@
---
extends: _layouts.markdown
-title: "Spacing"
+title: "Margin"
---
-# Spacing
+# Margin
Using
diff --git a/docs/source/utilities/spacing/negative-margin.md b/docs/source/utilities/spacing/negative-margin.md
new file mode 100644
index 000000000..8f836ebfc
--- /dev/null
+++ b/docs/source/utilities/spacing/negative-margin.md
@@ -0,0 +1,106 @@
+---
+extends: _layouts.markdown
+title: "Negative Margin"
+---
+
+# Negative Margin
+
+
+
+
Using
+
+The syntax below is combined to create a system for padding and margins. For example, `.pt-2` would add padding to the top of the element to the value of `0.5rem` and `.mx-0` would make the horizontal margin zero.
+
+
+
+
Class
+
p Padding
+
m Margin
+
pull Negative Margin
+
+
+
Position (optional)
+
t Top
+
r Right
+
b Bottom
+
l Left
+
x Horizontal
+
y Vertical
+
+
+
Space
+
0 0
+
1 0.25rem
+
2 0.5rem
+
3 0.75rem
+
4 1rem
+
6 1.5rem
+
8 2rem
+
+
+
+
Customizing the spacing scale
+
+You can customize the margin and padding utilities using the `@sizing-scale` variable. Please note that the entire scale must be redefined. It's not possible to add a new value to the existing scale.
+
+```less
+// The default sizing scale
+@sizing-scale:
+ '1' 0.25rem,
+ '2' 0.5rem,
+ '3' 0.75rem,
+ '4' 1rem,
+ '6' 1.5rem,
+ '8' 2rem,
+ '12' 3rem,
+ '16' 4rem,
+;
+```
+
+By default the `@sizing-scale` is automatically applied to the margin, negative margin (pull) and padding scales. However, it's possible to customize each scale individually using the `@margin-scale`, `@pull-scale` and `@padding-scale` variables.
+
+```less
+// Override the margin scale
+@margin-scale:
+ '1' 0.25rem,
+ '2' 0.5rem,
+ // ...
+;
+
+// Override the pull scale
+@pull-scale:
+ '1' 0.25rem,
+ '2' 0.5rem,
+ // ...
+;
+
+// Override the padding scale
+@padding-scale:
+ '1' 0.25rem,
+ '2' 0.5rem,
+ // ...
+;
+```
+
+
Responsive spacing utilities
+
+The spacing utilities can also be used with
responsive prefixes:
+
+```html
+
+
+
+```
+
+```less
+div {
+ .screen(lg, {
+ .mt-6;
+ });
+}
+```
+
diff --git a/docs/source/utilities/spacing/padding.md b/docs/source/utilities/spacing/padding.md
new file mode 100644
index 000000000..fcb06ce46
--- /dev/null
+++ b/docs/source/utilities/spacing/padding.md
@@ -0,0 +1,106 @@
+---
+extends: _layouts.markdown
+title: "Padding"
+---
+
+# Padding
+
+
+
+
Using
+
+The syntax below is combined to create a system for padding and margins. For example, `.pt-2` would add padding to the top of the element to the value of `0.5rem` and `.mx-0` would make the horizontal margin zero.
+
+
+
+
Class
+
p Padding
+
m Margin
+
pull Negative Margin
+
+
+
Position (optional)
+
t Top
+
r Right
+
b Bottom
+
l Left
+
x Horizontal
+
y Vertical
+
+
+
Space
+
0 0
+
1 0.25rem
+
2 0.5rem
+
3 0.75rem
+
4 1rem
+
6 1.5rem
+
8 2rem
+
+
+
+
Customizing the spacing scale
+
+You can customize the margin and padding utilities using the `@sizing-scale` variable. Please note that the entire scale must be redefined. It's not possible to add a new value to the existing scale.
+
+```less
+// The default sizing scale
+@sizing-scale:
+ '1' 0.25rem,
+ '2' 0.5rem,
+ '3' 0.75rem,
+ '4' 1rem,
+ '6' 1.5rem,
+ '8' 2rem,
+ '12' 3rem,
+ '16' 4rem,
+;
+```
+
+By default the `@sizing-scale` is automatically applied to the margin, negative margin (pull) and padding scales. However, it's possible to customize each scale individually using the `@margin-scale`, `@pull-scale` and `@padding-scale` variables.
+
+```less
+// Override the margin scale
+@margin-scale:
+ '1' 0.25rem,
+ '2' 0.5rem,
+ // ...
+;
+
+// Override the pull scale
+@pull-scale:
+ '1' 0.25rem,
+ '2' 0.5rem,
+ // ...
+;
+
+// Override the padding scale
+@padding-scale:
+ '1' 0.25rem,
+ '2' 0.5rem,
+ // ...
+;
+```
+
+
Responsive spacing utilities
+
+The spacing utilities can also be used with
responsive prefixes:
+
+```html
+
+
+
+```
+
+```less
+div {
+ .screen(lg, {
+ .mt-6;
+ });
+}
+```
+
diff --git a/docs/source/utilities/text/alignment.md b/docs/source/utilities/text/alignment.md
new file mode 100644
index 000000000..968d8fb77
--- /dev/null
+++ b/docs/source/utilities/text/alignment.md
@@ -0,0 +1,12 @@
+---
+extends: _layouts.markdown
+title: "Text Alignment"
+---
+
+# Text Alignment
+
+
diff --git a/docs/source/utilities/text/color.md b/docs/source/utilities/text/color.md
new file mode 100644
index 000000000..46bd60e04
--- /dev/null
+++ b/docs/source/utilities/text/color.md
@@ -0,0 +1,12 @@
+---
+extends: _layouts.markdown
+title: "Text Color"
+---
+
+# Text Color
+
+
diff --git a/docs/source/utilities/text/fonts.md b/docs/source/utilities/text/fonts.md
new file mode 100644
index 000000000..218a9d21d
--- /dev/null
+++ b/docs/source/utilities/text/fonts.md
@@ -0,0 +1,34 @@
+---
+extends: _layouts.markdown
+title: "Font Families"
+---
+
+# Font Families
+
+
+
+```html
+
+
+
+```
+
+```less
+div {
+ .sans;
+ .serif;
+ .mono;
+}
+```
+
+```less
+// Customize the font stack
+@font-family-sans: -apple-system, BlinkMacSystemFont, "Segoe UI", "Roboto", "Oxygen", "Ubuntu", "Cantarell", "Fira Sans", "Droid Sans", "Helvetica Neue", Arial, sans-serif;
+@font-family-serif: Constantia, "Lucida Bright", Lucidabright, "Lucida Serif", Lucida, "DejaVu Serif", "Bitstream Vera Serif", "Liberation Serif", Georgia, serif;
+@font-family-mono: Consolas, "Andale Mono WT", "Andale Mono", "Lucida Console", "Lucida Sans Typewriter", "DejaVu Sans Mono", "Bitstream Vera Sans Mono", "Liberation Mono", "Nimbus Mono L", Monaco, "Courier New", Courier, monospace;
+@font-family-base: @font-family-sans;
+```
diff --git a/docs/source/utilities/text/letter-spacing.md b/docs/source/utilities/text/letter-spacing.md
new file mode 100644
index 000000000..a880ab853
--- /dev/null
+++ b/docs/source/utilities/text/letter-spacing.md
@@ -0,0 +1,12 @@
+---
+extends: _layouts.markdown
+title: "Letter Spacing"
+---
+
+# Letter Spacing
+
+
diff --git a/docs/source/utilities/text/line-height.md b/docs/source/utilities/text/line-height.md
new file mode 100644
index 000000000..74c16f779
--- /dev/null
+++ b/docs/source/utilities/text/line-height.md
@@ -0,0 +1,12 @@
+---
+extends: _layouts.markdown
+title: "Line Height"
+---
+
+# Line Height
+
+
diff --git a/docs/source/utilities/text/sizing.md b/docs/source/utilities/text/sizing.md
new file mode 100644
index 000000000..edc9dde76
--- /dev/null
+++ b/docs/source/utilities/text/sizing.md
@@ -0,0 +1,12 @@
+---
+extends: _layouts.markdown
+title: "Text Sizing"
+---
+
+# Text Sizing
+
+
diff --git a/docs/source/utilities/text/style.md b/docs/source/utilities/text/style.md
new file mode 100644
index 000000000..60d3ca425
--- /dev/null
+++ b/docs/source/utilities/text/style.md
@@ -0,0 +1,12 @@
+---
+extends: _layouts.markdown
+title: "Style & Decoration"
+---
+
+# Style & Decoration
+
+
diff --git a/docs/source/utilities/text/weight.md b/docs/source/utilities/text/weight.md
new file mode 100644
index 000000000..1e6866e84
--- /dev/null
+++ b/docs/source/utilities/text/weight.md
@@ -0,0 +1,12 @@
+---
+extends: _layouts.markdown
+title: "Font Weight"
+---
+
+# Font Weight
+
+
diff --git a/docs/source/utilities/text/wrapping.md b/docs/source/utilities/text/wrapping.md
new file mode 100644
index 000000000..a3f4cd237
--- /dev/null
+++ b/docs/source/utilities/text/wrapping.md
@@ -0,0 +1,12 @@
+---
+extends: _layouts.markdown
+title: "Text Wrapping"
+---
+
+# Text Wrapping
+
+
diff --git a/docs/source/utilities/visibility.md b/docs/source/utilities/visibility.md
new file mode 100644
index 000000000..1e071003a
--- /dev/null
+++ b/docs/source/utilities/visibility.md
@@ -0,0 +1,12 @@
+---
+extends: _layouts.markdown
+title: "Visibility"
+---
+
+# Visibility
+
+
diff --git a/docs/source/utilities/z-index.md b/docs/source/utilities/z-index.md
new file mode 100644
index 000000000..18b8acb78
--- /dev/null
+++ b/docs/source/utilities/z-index.md
@@ -0,0 +1,12 @@
+---
+extends: _layouts.markdown
+title: "Z-Index"
+---
+
+# Z-Index
+
+
diff --git a/docs/source/workflow/adding-new-utilities.md b/docs/source/workflow/adding-new-utilities.md
new file mode 100644
index 000000000..709ab86ce
--- /dev/null
+++ b/docs/source/workflow/adding-new-utilities.md
@@ -0,0 +1,6 @@
+---
+extends: _layouts.markdown
+title: "Adding New Utilities"
+---
+
+# Adding New Utilities
diff --git a/docs/source/workflow/customizing-tailwind.md b/docs/source/workflow/customizing-tailwind.md
new file mode 100644
index 000000000..5e7880dfc
--- /dev/null
+++ b/docs/source/workflow/customizing-tailwind.md
@@ -0,0 +1,6 @@
+---
+extends: _layouts.markdown
+title: "Customizing Tailwind"
+---
+
+# Customizing Tailwind
diff --git a/docs/source/workflow/extracting-components.md b/docs/source/workflow/extracting-components.md
new file mode 100644
index 000000000..f935eccb9
--- /dev/null
+++ b/docs/source/workflow/extracting-components.md
@@ -0,0 +1,6 @@
+---
+extends: _layouts.markdown
+title: "Working Utility-First"
+---
+
+# Working Utility-First
diff --git a/docs/source/workflow/responsive-design.md b/docs/source/workflow/responsive-design.md
new file mode 100644
index 000000000..5880e0b43
--- /dev/null
+++ b/docs/source/workflow/responsive-design.md
@@ -0,0 +1,6 @@
+---
+extends: _layouts.markdown
+title: "Responsive Design"
+---
+
+# Responsive Design
diff --git a/docs/source/workflow/working-utility-first.md b/docs/source/workflow/working-utility-first.md
new file mode 100644
index 000000000..9c2068bbc
--- /dev/null
+++ b/docs/source/workflow/working-utility-first.md
@@ -0,0 +1,6 @@
+---
+extends: _layouts.markdown
+title: "Extracting Components"
+---
+
+# Extracting Components
diff --git a/docs/source/z-index.md b/docs/source/z-index.md
deleted file mode 100644
index 99575277d..000000000
--- a/docs/source/z-index.md
+++ /dev/null
@@ -1,6 +0,0 @@
----
-extends: _layouts.markdown
-title: "Z-Index"
----
-
-# Z-Index
diff --git a/docs/tailwind.js b/docs/tailwind.js
index 9f3e4cfd2..f5e040f76 100644
--- a/docs/tailwind.js
+++ b/docs/tailwind.js
@@ -1,5 +1,10 @@
module.exports = {
"extend": {
+ "sizing": {
+ "width": {
+ "128": "32rem",
+ }
+ },
"spacing": {
"padding": {
"12": "3rem",