diff --git a/docs/source/styles/flexbox/flex-grow-shrink.blade.md b/docs/source/styles/flexbox/flex-grow-shrink.blade.md
index 7f0ae72da..ca63c2018 100644
--- a/docs/source/styles/flexbox/flex-grow-shrink.blade.md
+++ b/docs/source/styles/flexbox/flex-grow-shrink.blade.md
@@ -6,15 +6,16 @@ category: "Flexbox"
# Flex, Grow, & Shrink
-
-
Usage
-
Responsive
-
Customizing
+
+
+ Utilities for controlling how flex items grow and shrink.
-Tailwind provides a comprehensive set of Flexbox utilities out of the box to make it easy for you to implement complex layouts without having to write any new CSS.
+
-
Initial Default
+### Initial
Default
Use `.flex-initial` to allow a flex item to shrink but not grow, taking into account it's initial size:
@@ -66,7 +67,7 @@ Use `.flex-initial` to allow a flex item to shrink but not grow, taking into acc
@endslot
@endcomponent
-## Flex 1
+### Flex 1
Use `.flex-1` to allow a flex item to grow and shrink as needed, ignoring it's initial size:
@@ -111,7 +112,7 @@ Use `.flex-1` to allow a flex item to grow and shrink as needed, ignoring it's i
@endslot
@endcomponent
-## Auto
+### Auto
Use `.flex-auto` to allow a flex item to grow and shrink, taking into account it's initial size:
@@ -156,7 +157,7 @@ Use `.flex-auto` to allow a flex item to grow and shrink, taking into account it
@endslot
@endcomponent
-## None
+### None
Use `.flex-none` to prevent a flex item from growing or shrinking:
@@ -174,7 +175,7 @@ Use `.flex-none` to prevent a flex item from growing or shrinking:
@endcomponent
-## Grow
+### Grow
Use `.flex-grow` to allow a flex item to grow to fill any available space:
@@ -192,7 +193,7 @@ Use `.flex-grow` to allow a flex item to grow to fill any available space:
@endcomponent
-## Don't grow
+### Don't grow
Use `.flex-no-grow` to prevent a flex item from growing:
@@ -210,7 +211,7 @@ Use `.flex-no-grow` to prevent a flex item from growing:
@endcomponent
-## Shrink
+### Shrink
Use `.flex-shrink` to allow a flex item to shrink if needed:
@@ -228,7 +229,7 @@ Use `.flex-shrink` to allow a flex item to shrink if needed:
@endcomponent
-## Don't shrink
+### Don't shrink
Use `.flex-no-shrink` to prevent a flex item from shrinking:
@@ -245,3 +246,86 @@ Use `.flex-no-shrink` to prevent a flex item from shrinking:
@endcomponent
+
+## Responsive
+
+To control how a flex item grows or shrinks at a specific breakpoint, add a `{breakpoint}:` prefix to any existing utility class. For example, use `md:flex-no-shrink` to apply the `flex-no-shrink` utility at only medium screen sizes and above.
+
+For more information about Tailwind's responsive design features, check out the [Responsive Design](#) documentation.
+
+@component('_partials.responsive-code-sample')
+@slot('none')
+
+
+ Item that can grow or shrink if needed
+
+
+ Responsive flex item
+
+
+ Item that can grow or shrink if needed
+
+
+@endslot
+@slot('sm')
+
+
+ Item that can grow or shrink if needed
+
+
+ Responsive flex item
+
+
+ Item that can grow or shrink if needed
+
+
+@endslot
+@slot('md')
+
+
+ Item that can grow or shrink if needed
+
+
+ Responsive flex item
+
+
+ Item that can grow or shrink if needed
+
+
+@endslot
+@slot('lg')
+
+
+ Item that can grow or shrink if needed
+
+
+ Responsive flex item
+
+
+ Item that can grow or shrink if needed
+
+
+@endslot
+@slot('xl')
+
+
+ Item that can grow or shrink if needed
+
+
+ Responsive flex item
+
+
+ Item that can grow or shrink if needed
+
+
+@endslot
+@slot('code')
+
+
+
+ Item that cannot grow or shrink
+
+
+
+@endslot
+@endcomponent