diff --git a/site/src/content/docs/components/chips.mdx b/site/src/content/docs/components/chips.mdx
index 8531d0fa82..bcf0179377 100644
--- a/site/src/content/docs/components/chips.mdx
+++ b/site/src/content/docs/components/chips.mdx
@@ -54,10 +54,8 @@ Static chips have no hover effect. A dismiss button has its own hover state with
Use a button for an action or a link for navigation. Chips on or inside interactive elements have a pointer cursor and hover feedback. Combobox also provides these states for its selectable chips.
-Keyboard focus uses the chip’s theme color, including on dismiss buttons. Chips without a theme use the default focus color.
-
-Action chip
- Link chip`} />
+Action chip
+ Link chip`} />
### Themed chips
diff --git a/site/src/content/docs/content/prose.mdx b/site/src/content/docs/content/prose.mdx
index dcc2b6456d..1345f05d66 100644
--- a/site/src/content/docs/content/prose.mdx
+++ b/site/src/content/docs/content/prose.mdx
@@ -13,9 +13,7 @@ Wrap your content in the `.prose` class to get modified font-size, line-height,
- Normalize the spacing of lists
- Set a default `margin-bottom` for headings.
- Some headings get an additional `margin-top` to ensure proper spacing between headings and other content.
-- Space the children of blockquotes and disclosures.
-- Keep images and videos within the content width without changing their aspect ratio.
-- Use shared font-weight tokens for headings, heading code, and description terms.
+- Style blockquotes, code, and other inline elements.
The `.not-prose` utility class can be used to opt out of `.prose` typography styles in specific elements. This is useful for components that have their own styling, such as code snippets or examples. Adding a `.prose` within a `.not-prose` won’t work.
@@ -25,13 +23,11 @@ Wrap your content in the `.prose` class to get modified font-size, line-height,
Below is an example of Markdown demonstrating several types of HTML content supported in the `.prose` class.
-
+
# Getting started with documentation
Writing clear and effective documentation is essential for any project. When you create content that others will read and use, [proper formatting](#) makes all the difference. *Good documentation* helps users understand complex concepts quickly and efficiently.
-> Documentation is a guide for your future self. Write each instruction so you can follow it later.
->
-> Leave space between paragraphs so readers can see where each thought starts.
+> Documentation is a love letter that you write to your future self. Clear writing today saves countless hours of confusion tomorrow.
The foundation of great documentation starts with **understanding your audience** and their needs. Writers should focus on clarity, consistency, and providing practical examples that readers can follow.
@@ -53,7 +49,7 @@ Most of these elements are styled by browsers with few modifications on our part
Effective documentation requires careful attention to structure and flow. When organizing content, consider how readers will navigate through your material and what information they need first. Clear headings help users scan quickly and find relevant sections.
-### Inline `code`
+### Code
Inline code is available with the `` element. Snippets of multiple lines of code are supported through Rouge. Longer lines will automatically scroll horizontally when needed. You may also use code fencing (triple backticks) for rendering code.
@@ -112,30 +108,11 @@ Technical definitions should be clear and accessible to your target audience. Av
Visual elements enhance understanding by providing concrete examples of abstract concepts. Choose images that directly support your written content rather than serving as mere decoration.
-Images keep their aspect ratio when the content becomes narrower. Small images keep their own width instead of stretching. These images have no `.img-fluid` or spacing classes. The same sizing rules apply to `
-
-
.md:col-3 .md:ms-auto
-
.md:col-3 .md:ms-auto
-
-
-
.col-auto .me-auto
-
.col-auto
+
+
+
.md:col-4
+
.md:col-4 .ms-auto
+
+
+
.md:col-3 .md:ms-auto
+
.md:col-3 .md:ms-auto
+
+
+
.col-auto .me-auto
+
.col-auto
+
`} />
## Standalone column classes
-The `.col-*` classes can also be used outside a `.row` to give an element a specific width. Column classes do not add padding, inside or outside a row. Outside a row, numbered columns keep their percentage widths.
+The `.col-*` classes can also be used outside a `.row` to give an element a specific width. Whenever column classes are used as non-direct children of a row, the paddings are omitted.
.col-3: width of 25%
diff --git a/site/src/content/docs/layout/css-grid.mdx b/site/src/content/docs/layout/css-grid.mdx
index e1cde394dd..3a53f694c4 100644
--- a/site/src/content/docs/layout/css-grid.mdx
+++ b/site/src/content/docs/layout/css-grid.mdx
@@ -34,9 +34,9 @@ Compared to the default grid system:
- Flex utilities don’t affect the CSS Grid columns in the same way.
-- Both grids use native CSS `gap`. The flexbox grid uses `.g-*`, `.gx-*`, and `.gy-*` to keep column widths in sync. CSS Grid uses `--bs-gap` or gap utilities.
+- Gaps replaces gutters. The `gap` property replaces the horizontal `padding` from our default grid system and functions more like `margin`.
-- Neither grid uses negative gutter margins. Use gap controls to space columns, and padding to space content inside them. CSS Grid applies gaps in both directions by default. See the [customizing section](#customizing) for more details.
+- As such, unlike `.row`s, `.grid`s have no negative margins and margin utilities cannot be used to change the grid gutters. Grid gaps are applied horizontally and vertically by default. See the [customizing section](#customizing) for more details.
- Inline and custom styles should be viewed as replacements for modifier classes (e.g., `style="--bs-columns: 3;"` vs `class="row-cols-3"`).
@@ -48,7 +48,7 @@ Compared to the default grid system:
Three equal-width columns across all container sizes and devices can be created by using the `.g-col-4` classes. Add [responsive classes](#responsive) to change the layout by the `.grid` container’s width.
-
+
.g-col-4
.g-col-4
.g-col-4
@@ -62,7 +62,7 @@ Use responsive classes to adjust your layout across breakpoints. Here we start w
Responsive `.g-col-*` and `.g-start-*` classes are powered by [container queries](https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_containment/Container_queries) rather than media queries. The `.grid` is set as a query container (`container-type: inline-size`), so its grid items respond to the width of the `.grid` itself instead of the viewport. This means a `.grid` placed inside a narrow column will switch layouts based on that column’s width, not the size of the browser window.
-
+
.g-col-6 .md:g-col-4
.g-col-6 .md:g-col-4
.g-col-6 .md:g-col-4
@@ -70,7 +70,7 @@ Responsive `.g-col-*` and `.g-start-*` classes are powered by [container queries
Compare that to this two column layout at all container sizes.
-
+
.g-col-6
.g-col-6
`} />
@@ -90,7 +90,7 @@ The examples above are constrained by the width of this page, so you can only re
Drag the handle on the right edge of the example to resize it. The badge shows the active container-query breakpoint, and every grid below responds to the example's width—not the size of the browser window.
-
+
cell
cell
cell
@@ -98,21 +98,21 @@ The examples above are constrained by the width of this page, so you can only re
cell
cell
-
+
card
card
card
card
-
+
sidebar
main content
-
+
primary
secondary
-
+
centered with .md:g-start-4
`} />
@@ -125,7 +125,7 @@ The examples above are constrained by the width of this page, so you can only re
Grid items automatically wrap to the next line when there’s no more room horizontally. Note that the `gap` applies to horizontal and vertical gaps between grid items.
-
+
.g-col-6
.g-col-6
@@ -137,7 +137,7 @@ Grid items automatically wrap to the next line when there’s no more room horiz
Start classes aim to replace our default grid’s offset classes, but they’re not entirely the same. CSS Grid creates a grid template through styles that tell browsers to “start at this column” and “end at this column”. Those properties are `grid-column-start` and `grid-column-end`. Start classes are shorthand for the former. Pair them with the column classes to size and align your columns however you need. Start classes begin at `1` as `0` is an invalid value for these properties.
-
+
.g-col-3 .g-start-2
.g-col-4 .g-start-6
`} />
@@ -146,7 +146,7 @@ Start classes aim to replace our default grid’s offset classes, but they’re
When there are no classes on the grid items (the immediate children of a `.grid`), each grid item will automatically be sized to one column.
-
+
1
1
1
@@ -163,7 +163,7 @@ When there are no classes on the grid items (the immediate children of a `.grid`
This behavior can be mixed with grid column classes.
-
+
.g-col-6
1
1
@@ -184,7 +184,7 @@ Similar to our default grid system, our CSS Grid allows for easy nesting of `.gr
In practice this allows for more complex and custom layouts when compared to our default grid system.
-
+
First auto-column
@@ -221,7 +221,7 @@ These CSS variables have no default value; instead, they apply fallback values t
Immediate children elements of `.grid` are grid items, so they’ll be sized without explicitly adding a `.g-col` class.
-
+
Auto-column
Auto-column
Auto-column
@@ -231,12 +231,12 @@ Immediate children elements of `.grid` are grid items, so they’ll be sized wit
Adjust the number of columns and the gap.
-
+
.g-col-2
.g-col-2
`} />
-
+
.g-col-6
.g-col-4
`} />
@@ -245,7 +245,7 @@ Adjust the number of columns and the gap.
Adding more rows and changing the placement of columns:
-
+
Auto-column
Auto-column
Auto-column
@@ -255,7 +255,7 @@ Adding more rows and changing the placement of columns:
Change the vertical gaps only by modifying the `row-gap`. Note that we use `gap` on `.grid`s, but `row-gap` and `column-gap` can be modified as needed.
-
+
.g-col-6
.g-col-6
@@ -265,7 +265,7 @@ Change the vertical gaps only by modifying the `row-gap`. Note that we use `gap`
Because of that, you can have different vertical and horizontal `gap`s, which can take a single value (all sides) or a pair of values (vertical and horizontal). This can be applied with an inline style for `gap`, or with our `--bs-gap` CSS variable.
-
+
.g-col-6
.g-col-6
@@ -282,7 +282,7 @@ One limitation of the CSS Grid is that our default classes are still generated b
For example, you can increase the column count and change the gap size, and then size your “columns” with a mix of inline styles and predefined CSS Grid column classes (e.g., `.g-col-4`).
-
+
14 columns
.g-col-4
`} />
diff --git a/site/src/content/docs/layout/grid.mdx b/site/src/content/docs/layout/grid.mdx
index 32ab498a22..8291188c51 100644
--- a/site/src/content/docs/layout/grid.mdx
+++ b/site/src/content/docs/layout/grid.mdx
@@ -15,19 +15,21 @@ Bootstrap’s grid system uses a series of containers, rows, and columns to layo
**New to or unfamiliar with flexbox?** [Read this CSS Tricks flexbox guide](https://css-tricks.com/snippets/css/a-guide-to-flexbox/#flexbox-background) for background, terminology, guidelines, and code snippets.
-
-
- Column
-
-
- Column
-
-
- Column
+
+
+
+ Column
+
+
+ Column
+
+
+ Column
+
`} />
-The above example creates three equal-width columns across all devices and viewports using our predefined grid classes. Add a parent `.container` to center and horizontally pad the grid on a page.
+The above example creates three equal-width columns across all devices and viewports using our predefined grid classes. Those columns are centered in the page with the parent `.container`.
## How it works
@@ -37,9 +39,9 @@ Breaking it down, here’s how the grid system comes together:
- **Containers center and horizontally pad your content.** Use `.container` for a responsive pixel width, `.container-fluid` for `width: 100%` across all viewports and devices, or a responsive container (e.g., `.md:container`) for a combination of fluid and pixel widths.
-- **Rows are wrappers for columns.** Native CSS `gap` creates the gutters between columns. Numbered column widths account for those gaps, so spans that add up to 12 fit on one line. Rows fit inside their parent without negative margins, and columns do not add gutter padding. Rows also support modifier classes to [uniformly apply column sizing](#row-columns) and [gutter classes]([[docsref:/layout/gutters]]) to change the spacing of your content.
+- **Rows are wrappers for columns.** Each column has horizontal `padding` (called a gutter) for controlling the space between them. This `padding` is then counteracted on the rows with negative margins to ensure the content in your columns is visually aligned down the left side. Rows also support modifier classes to [uniformly apply column sizing](#row-columns) and [gutter classes]([[docsref:/layout/gutters]]) to change the spacing of your content.
-- **Columns are incredibly flexible.** There are 12 template columns available per row, allowing you to create different combinations of elements that span any number of columns. Column classes indicate the number of template columns to span (e.g., `col-4` spans four). Widths account for each span and the horizontal gap, so mixed spans that total 12 fit on one line.
+- **Columns are incredibly flexible.** There are 12 template columns available per row, allowing you to create different combinations of elements that span any number of columns. Column classes indicate the number of template columns to span (e.g., `col-4` spans four). `width`s are set in percentages so you always have the same relative sizing.
- **Gutters are also responsive and customizable.** [Gutter classes are available]([[docsref:/layout/gutters]]) across all breakpoints, with all the same sizes as our [margin]([[docsref:/utilities/margin]]) and [padding]([[docsref:/utilities/padding]]) utilities. Change horizontal gutters with `.gx-*` classes, vertical gutters with `.gy-*`, or all gutters with `.g-*` classes. `.g-0` is also available to remove gutters.
@@ -124,23 +126,25 @@ Utilize breakpoint-specific column classes for easy column sizing without an exp
For example, here are two grid layouts that apply to every device and viewport, from `xs` to `2xl`. Add any number of unit-less classes for each breakpoint you need and every column will be the same width.
-
-
- 1 of 2
+
+
+
+ 1 of 2
+
+
+ 2 of 2
+
-
- 2 of 2
-
-
-
-
- 1 of 3
-
-
- 2 of 3
-
-
- 3 of 3
+
+
+ 1 of 3
+
+
+ 2 of 3
+
+
+ 3 of 3
+
`} />
@@ -148,26 +152,28 @@ For example, here are two grid layouts that apply to every device and viewport,
Auto-layout for flexbox grid columns also means you can set the width of one column and have the sibling columns automatically resize around it. You may use predefined grid classes (as shown below), grid mixins, or inline widths. Note that the other columns will resize no matter the width of the center column.
-
-
- 1 of 3
+
+
+
+ 1 of 3
+
+
+ 2 of 3 (wider)
+
+
+ 3 of 3
+
-
- 2 of 3 (wider)
-
-
- 3 of 3
-
-
-
-
- 1 of 3
-
-
- 2 of 3 (wider)
-
-
- 3 of 3
+
+
+ 1 of 3
+
+
+ 2 of 3 (wider)
+
+
+ 3 of 3
+
`} />
@@ -175,26 +181,28 @@ Auto-layout for flexbox grid columns also means you can set the width of one col
Use `{breakpoint}:col-auto` classes to size columns based on the natural width of their content.
-
-
- 1 of 3
+
+
+
+ 1 of 3
+
+
+ Variable width content
+
+
+ 3 of 3
+
-
- Variable width content
-
-
- 3 of 3
-
-
-
-
- 1 of 3
-
-
- Variable width content
-
-
- 3 of 3
+
+
+ 1 of 3
+
+
+ Variable width content
+
+
+ 3 of 3
+
`} />
@@ -206,52 +214,58 @@ Bootstrap’s grid includes six tiers of predefined classes for building complex
For grids that are the same from the smallest of devices to the largest, use the `.col` and `.col-*` classes. Specify a numbered class when you need a particularly sized column; otherwise, feel free to stick to `.col`.
-
-
col
-
col
-
col
-
col
-
-
-
col-8
-
col-4
+
+
+
col
+
col
+
col
+
col
+
+
+
col-8
+
col-4
+
`} />
### Stacked to horizontal
Using a single set of `.sm:col-*` classes, you can create a basic grid system that starts out stacked and becomes horizontal at the small breakpoint (`sm`).
-
-
sm:col-8
-
sm:col-4
-
-
-
sm:col
-
sm:col
-
sm:col
+
+
+
sm:col-8
+
sm:col-4
+
+
+
sm:col
+
sm:col
+
sm:col
+
`} />
### Mix and match
Don’t want your columns to simply stack in some grid tiers? Use a combination of different classes for each tier as needed. See the example below for a better idea of how it all works.
-
-
-
.md:col-8
-
.col-6 .md:col-4
-
+
+
+
+
.md:col-8
+
.col-6 .md:col-4
+
-
-
-
.col-6 .md:col-4
-
.col-6 .md:col-4
-
.col-6 .md:col-4
-
+
+
+
.col-6 .md:col-4
+
.col-6 .md:col-4
+
.col-6 .md:col-4
+
-
-
-
.col-6
-
.col-6
+
+
+
.col-6
+
.col-6
+
`} />
### Row columns
@@ -260,46 +274,58 @@ Use the responsive `.row-cols-*` classes to quickly set the number of columns th
Use these row columns classes to quickly create basic grid layouts or to control your card layouts.
-
-
Column
-
Column
-
Column
-
Column
+
+
+
Column
+
Column
+
Column
+
Column
+
`} />
-
-
Column
-
Column
-
Column
-
Column
+
+
+
Column
+
Column
+
Column
+
Column
+
`} />
-
-
Column
-
Column
-
Column
-
Column
+
+
+
Column
+
Column
+
Column
+
Column
+
`} />
-
-
Column
-
Column
-
Column
-
Column
+
+
+
Column
+
Column
+
Column
+
Column
+
`} />
-
-
Column
-
Column
-
Column
-
Column
+
+
+
Column
+
Column
+
Column
+
Column
+
`} />
-
-
Column
-
Column
-
Column
-
Column
+
+
+
Column
+
Column
+
Column
+
Column
+
`} />
You can also use the accompanying Sass mixin, `row-cols()`:
@@ -320,17 +346,19 @@ You can also use the accompanying Sass mixin, `row-cols()`:
To nest your content with the default grid, add a new `.row` and set of `.sm:col-*` columns within an existing `.sm:col-*` column. Nested rows should include a set of columns that add up to 12 or fewer (it is not required that you use all 12 available columns).
-
-
- Level 1: .sm:col-3
-
-
-
-
- Level 2: .col-8 .sm:col-6
-
-
- Level 2: .col-4 .sm:col-6
+
+
+
+ Level 1: .sm:col-3
+
+
+
+
+ Level 2: .col-8 .sm:col-6
+
+
+ Level 2: .col-4 .sm:col-6
+
@@ -379,8 +407,6 @@ Mixins are used in conjunction with the grid variables to generate semantic CSS
### Example usage
-When using `make-col()` or `make-col-offset()` outside a gap-based row, pass `$gap: 0px` to keep percentage sizing.
-
You can modify the variables to your own custom values, or just use the mixins with their default values. Here’s an example of using the default settings to create a two-column layout with a gap between.
```scss
@@ -431,7 +457,7 @@ Using our built-in grid Sass variables and maps, it’s possible to completely c
### Columns and gutters
-The number of grid columns can be modified via Sass variables. `$grid-columns` sets the span fractions used by the gap-aware column widths. `$grid-gutter-x` and `$grid-gutter-y` set the horizontal and vertical gutter sizes. `$grid-row-columns` is used to set the maximum number of columns of `.row-cols-*`, any number over this limit is ignored.
+The number of grid columns can be modified via Sass variables. `$grid-columns` is used to generate the widths (in percent) of each individual column. `$grid-gutter-x` and `$grid-gutter-y` set the horizontal and vertical gutter sizes. `$grid-row-columns` is used to set the maximum number of columns of `.row-cols-*`, any number over this limit is ignored.
```scss
$grid-columns: 12 !default;
diff --git a/site/src/content/docs/layout/gutters.mdx b/site/src/content/docs/layout/gutters.mdx
index ea8a502329..3f6ce468c3 100644
--- a/site/src/content/docs/layout/gutters.mdx
+++ b/site/src/content/docs/layout/gutters.mdx
@@ -1,12 +1,12 @@
---
title: Gutters
-description: Gutters are the gaps between your columns, used to responsively space and align content in the Bootstrap grid system.
+description: Gutters are the padding between your columns, used to responsively space and align content in the Bootstrap grid system.
toc: true
---
## How they work
-- **Gutters use native CSS `gap` on the row.** Numbered column widths and offsets account for the horizontal gap. Columns do not add gutter padding, and rows do not use negative margins. Add padding to an inner wrapper when your content needs it.
+- **Gutters are the gaps between column content, created by horizontal `padding`.** We set `padding-right` and `padding-left` on each column, and use negative `margin` to offset that at the start and end of each row to align content.
- **Gutters start at `1.5rem` (`24px`) wide.** This allows us to match our grid to the [margin]([[docsref:/utilities/margin]]) and [padding]([[docsref:/utilities/padding]]) utilities scale.
@@ -14,52 +14,71 @@ toc: true
## Horizontal gutters
-Use `.gx-*` to control horizontal gaps. The row stays inside its parent, so you do not need extra container padding or an overflow wrapper to contain the gutters:
+`.gx-*` classes can be used to control the horizontal gutter widths. The `.container` or `.container-fluid` parent may need to be adjusted if larger gutters are used too to avoid unwanted overflow, using a matching padding utility. For example, in the following example we’ve increased the padding with `.px-4`:
-
-
-
Custom column padding
+
+
+
+
Custom column padding
+
+
+
Custom column padding
+
-
-
Custom column padding
+
`} />
+
+An alternative solution is to add a wrapper around the `.row` with the `.overflow-hidden` class:
+
+
+
+
+
Custom column padding
+
+
+
Custom column padding
+
`} />
## Vertical gutters
-Use `.gy-*` to control the gap between wrapped lines. Vertical gaps appear only between lines, without adding space before the first line or after the last:
+`.gy-*` classes can be used to control the vertical gutter widths within a row when columns wrap to new lines. Like the horizontal gutters, the vertical gutters can cause some overflow below the `.row` at the end of a page. If this occurs, you add a wrapper around `.row` with the `.overflow-hidden` class:
-
-
-
Custom column padding
-
-
-
Custom column padding
-
-
-
Custom column padding
-
-
-
Custom column padding
+
+
+
+
Custom column padding
+
+
+
Custom column padding
+
+
+
Custom column padding
+
+
+
Custom column padding
+
`} />
## Horizontal & vertical gutters
-Use `.g-*` classes to control horizontal and vertical gaps together.
+Use `.g-*` classes to control the horizontal and vertical grid gutters. In the example below, we use a smaller gutter width, so there isn’t a need for the `.overflow-hidden` wrapper class.
-
-
-
Custom column padding
-
-
-
Custom column padding
-
-
-
Custom column padding
-
-
-
Custom column padding
+
+
+
+
Custom column padding
+
+
+
Custom column padding
+
+
+
Custom column padding
+
+
+
Custom column padding
+
`} />
@@ -67,66 +86,58 @@ Use `.g-*` classes to control horizontal and vertical gaps together.
Gutter classes can also be added to [row columns]([[docsref:/layout/grid#row-columns]]). In the following example, we use responsive row columns and responsive gutter classes.
-
-
-
Row column
-
-
-
Row column
-
-
-
Row column
-
-
-
Row column
-
-
-
Row column
-
-
-
Row column
-
-
-
Row column
-
-
-
Row column
-
-
-
Row column
-
-
-
Row column
+
+
+
+
Row column
+
+
+
Row column
+
+
+
Row column
+
+
+
Row column
+
+
+
Row column
+
+
+
Row column
+
+
+
Row column
+
+
+
Row column
+
+
+
Row column
+
+
+
Row column
+
`} />
## No gutters
-Use `.g-0` to remove horizontal and vertical gaps. Column widths and offsets update to match the zero gap.
+The gutters between columns in our predefined grid classes can be removed with `.g-0`. This removes the negative `margin`s from `.row` and the horizontal `padding` from all immediate children columns.
-**Need an edge-to-edge design?** Drop the parent `.container` or `.container-fluid`. Rows no longer need `.mx-0` to prevent gutter overflow.
+**Need an edge-to-edge design?** Drop the parent `.container` or `.container-fluid` and add `.mx-0` to the `.row` to prevent overflow.
In practice, here’s how it looks. Note that you can continue to use this with all other predefined grid classes (including column widths, responsive tiers, reorders, and more).
-
+
.sm:col-6 .md:col-8
.col-6 .md:col-4
`} />
-## Column widths and offsets
-
-For a span of `s` columns in an `N`-column grid, the width is `(row width + horizontal gap) × s / N − horizontal gap`. An offset of `s` columns uses `(row width + horizontal gap) × s / N`. These calculations support mixed numbered spans without needing to count the items on each line.
-
-`.col` shares the remaining space after gaps, while `.col-auto` keeps its content width. Numbered column classes outside a `.row` keep their percentage widths.
-
-Use `.g-*`, `.gx-*`, and `.gy-*` to change flex grid gaps. Generic `.gap-*` utilities change `gap` without updating the gutter variables used by the width calculations. For custom CSS, set `--bs-gutter-x` and `--bs-gutter-y` on the row; include a length unit such as `0px` for a zero horizontal gap.
-
## Change the gutters
Classes are built from the `$gutters` Sass map which is inherited from the `$spacers` Sass map.
-Gutter classes use values from the Sass map. A runtime override of `--bs-spacer-*` does not change those classes. To change gaps at runtime, set `--bs-gutter-x` and `--bs-gutter-y` on the row.
-
```scss
$grid-gutter-x: 1.5rem;
$gutters: $spacers;
diff --git a/site/src/content/docs/utilities/gap.mdx b/site/src/content/docs/utilities/gap.mdx
index 3a25beb081..c6f6ed0853 100644
--- a/site/src/content/docs/utilities/gap.mdx
+++ b/site/src/content/docs/utilities/gap.mdx
@@ -29,8 +29,6 @@ Use gap utilities to control the space between children in flexbox and grid layo
```
-For the flexbox grid’s `.row`, use `.g-*`, `.gx-*`, and `.gy-*` instead. These classes also update the gutter variables used by column widths. See [Gutters]([[docsref:/layout/gutters]]).
-
**Support note:** Gap utilities work with CSS Grid and Flexbox layouts. They are a modern alternative to margin utilities for spacing children within a container.
diff --git a/site/src/scss/_component-examples.scss b/site/src/scss/_component-examples.scss
deleted file mode 100644
index 5517affbab..0000000000
--- a/site/src/scss/_component-examples.scss
+++ /dev/null
@@ -1,14 +0,0 @@
-// check-unused-imports-disable — @use loads shared example styles.
-@use "@twbs/bui/scss/component-examples";
-
-// Include responsive column classes in the shared BUI example highlighting.
-@layer custom {
- .bd-example-row :is([class~="col"], [class*="col-"], [class*=":col"]),
- .bd-example-cols :is([class~="col"], [class*="col-"], [class*=":col"]) > *,
- .bd-example-cssgrid [class*="grid"] > * {
- padding-block: .75rem;
- text-align: center;
- background-color: color-mix(in srgb, var(--bd-violet) 15%, transparent);
- border: 1px solid color-mix(in srgb, var(--bd-violet) 30%, transparent);
- }
-}
diff --git a/site/src/scss/_content.scss b/site/src/scss/_content.scss
index 00c14e6be6..f706a424ab 100644
--- a/site/src/scss/_content.scss
+++ b/site/src/scss/_content.scss
@@ -1,5 +1,4 @@
@use "../../../scss/layout/breakpoints" as *;
-@use "../../../scss/mixins/border-radius" as *;
//
// Bootstrap docs content theming
@@ -102,24 +101,6 @@
}
}
- .bd-example-prose {
- padding: var(--bs-spacer-3);
- border: var(--bs-border-width) solid var(--bs-border-color);
- @include border-radius(var(--bs-radius-3));
-
- @include media-breakpoint-up(lg) {
- padding: var(--bs-spacer-5);
- }
-
- @include media-breakpoint-down(md) {
- padding-block: 2rem;
- padding-inline: calc(var(--bs-gutter-x) * .5);
- margin-inline: calc(var(--bs-gutter-x) * -.5);
- border-inline-width: 0;
- @include border-radius(0);
- }
- }
-
.table-options {
td:nth-child(2) {
min-width: 160px;
diff --git a/site/src/scss/docs.scss b/site/src/scss/docs.scss
index 8d0adc0b13..702edbe061 100644
--- a/site/src/scss/docs.scss
+++ b/site/src/scss/docs.scss
@@ -35,7 +35,7 @@
@use "layout";
@use "toc";
@use "footer";
-@use "component-examples";
+@use "@twbs/bui/scss/component-examples";
@use "badge";
@use "callouts";
@use "details";
diff --git a/site/static/docs/[version]/assets/img/bootstrap-intellisense-autocomplete.png b/site/static/docs/[version]/assets/img/bootstrap-intellisense-autocomplete.png
new file mode 100644
index 0000000000..073675662b
Binary files /dev/null and b/site/static/docs/[version]/assets/img/bootstrap-intellisense-autocomplete.png differ
diff --git a/site/static/docs/[version]/assets/img/bootstrap-themes-collage.png b/site/static/docs/[version]/assets/img/bootstrap-themes-collage.png
new file mode 100644
index 0000000000..da99b30a8a
Binary files /dev/null and b/site/static/docs/[version]/assets/img/bootstrap-themes-collage.png differ
diff --git a/site/static/docs/[version]/assets/img/bootstrap-themes-collage@2x.png b/site/static/docs/[version]/assets/img/bootstrap-themes-collage@2x.png
new file mode 100644
index 0000000000..2ffb1ce9ea
Binary files /dev/null and b/site/static/docs/[version]/assets/img/bootstrap-themes-collage@2x.png differ
diff --git a/site/static/docs/[version]/assets/img/bootstrap-themes.png b/site/static/docs/[version]/assets/img/bootstrap-themes.png
new file mode 100644
index 0000000000..d43dba2a7d
Binary files /dev/null and b/site/static/docs/[version]/assets/img/bootstrap-themes.png differ
diff --git a/site/static/docs/[version]/assets/img/bootstrap-themes@2x.png b/site/static/docs/[version]/assets/img/bootstrap-themes@2x.png
new file mode 100644
index 0000000000..13c32337d6
Binary files /dev/null and b/site/static/docs/[version]/assets/img/bootstrap-themes@2x.png differ