diff --git a/docs/components/BottomNavigation.md b/docs/components/BottomNavigation.md
index 0b21f3870..41e487beb 100644
--- a/docs/components/BottomNavigation.md
+++ b/docs/components/BottomNavigation.md
@@ -9,14 +9,20 @@ path: /catalog/bottom-navigation/
# Bottom navigation (Navigation bar)
-**Note:** Bottom navigation has been renamed to navigation bar.
-
[Navigation bar](https://m3.material.io/components/navigation-bar/overview) lets
people switch between UI views on smaller devices.
-
+**Note:** The design name of this component has been changed from **Bottom
+navigation** to **Navigation bar**. However, Material's Android implementation
+remains as `BottomNavigationView`.
+
+
Navigation bar on compact and medium window sizes
+Navigation bars can have three to five destinations. The nav bar is positioned
+at the bottom of screens for convenient access. Each destination is represented
+by an icon and label text.
+
**Note:** Images use various dynamic color schemes.
## Design & API documentation
@@ -26,7 +32,7 @@ Navigation bar on compact and medium window sizes
## Anatomy
-
+
1. Container
2. Icon
@@ -39,7 +45,9 @@ Navigation bar on compact and medium window sizes
More details on anatomy items in the
[component guidelines](https://m3.material.io/components/navigation-bar/guidelines#895b5b49-a166-4d30-90be-c71a4c970f04).
-## M3 Expressive update
+## M3 Expressive
+
+### M3 Expressive update
Before you can use `Material3Expressive` component styles, follow the
[`Material3Expressive` themes setup instructions](https://github.com/material-components/material-components-android/tree/master/docs/getting-started.md#material3expressive-themes).
@@ -48,14 +56,35 @@ A new expressive style for the bottom navigation bar has been introduced that's
shorter and supports horizontal navigation items in medium-sized windows.
[More on M3 Expressive](https://m3.material.io/blog/building-with-m3-expressive)
-
-The updated expressive navigation bar is shorter and can be used in medium
-windows with horizontal nav items
+
**Color:**
* Active label changed from **on-surface-variant** to **secondary**
+### M3 Expressive styles
+
+Changes from M3:
+
+* Height: From 80dp to 64dp
+* Color: New expressive colors!
+* Top item padding: From 12dp to 6dp
+* Bottom item padding: From 16dp to 6dp
+* Label text is no longer bolded when selected
+* Active indicator: From 64dp to 56dp
+* New horizontal item configuration on medium and larger window sizes (greater
+ than or equal to 600dp):
+ * Icon moves from top to start of item
+ * Instead of being a set width based on the item count, item width is
+ based on content with a max width
+ * Item gravity: From top center to center
+
+The default style for bottom navigation bar is:
+
+```xml
+- @style/Widget.Material3Expressive.BottomNavigationView
+```
+
## Key properties
### Container attributes
@@ -304,7 +333,7 @@ Here's an example:
app:menu="@menu/bottom_navigation_menu"/>
```
-
+
### Making navigation bar accessible
diff --git a/docs/components/CommonButton.md b/docs/components/CommonButton.md
index 181db0ffb..b09affc6c 100644
--- a/docs/components/CommonButton.md
+++ b/docs/components/CommonButton.md
@@ -13,12 +13,12 @@ path: /catalog/buttons/
take actions, and make choices, with a single tap. There are two variants of
common buttons.
-
+
1. Default button
2. Toggle button
-
+
There are five button styles, in order of emphasis:
@@ -43,7 +43,7 @@ C. Toggle (selected)
## Anatomy
-
+
1. Container
2. Label text
@@ -52,12 +52,14 @@ C. Toggle (selected)
More details on anatomy items in the
[component guidelines](https://m3.material.io/components/buttons/guidelines#653b660b-e9d8-48ad-9f53-67fb3d76e09e).
-## M3 Expressive update
+## M3 Expressive
+
+### M3 Expressive update
Before you can use `Material3Expressive` component styles, follow the
[`Material3Expressive` themes setup instructions](https://github.com/material-components/material-components-android/tree/master/docs/getting-started.md#material3expressive-themes).
-
+
1. Five sizes
2. Toggle (selection)
@@ -93,6 +95,240 @@ can change shape when selected
* 16dp (recommended to match padding of new sizes)
* 24dp (deprecated)
+### M3 Expressive styles
+
+#### Buttons
+
+Filled
+
+Default
| Checked
| Unchecked
+---------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- | -----------------------------------------
+ |  | 
+ |  | 
+
+By default, the filled button is uncheckable. To make it checkable, enable the
+`android:checkable` attribute in style or layout.
+
+```xml
+
+```
+
+
+
+Filled tonal
+
+Default
| Checked
| Unchecked
+------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- | -----------------------------------------
+ |  | 
+ |  | 
+
+By default, the tonal button is uncheckable. To make it checkable, enable the
+`android:checkable` attribute in style or layout.
+
+```xml
+
+```
+
+
+
+Outlined
+
+Default
| Checked
| Unchecked
+------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ | -----------------------------------------
+ |  | 
+ |  | 
+
+By default, the outlined button is uncheckable. To make it checkable, enable the
+`android:checkable` attribute in style or layout.
+
+```xml
+
+```
+
+
+
+Text
+
+
|
+-------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -----------------------------------------------------------------------------------------------------------------------------------------------------------------------
+
+The text button appears as only text until pressed. It does not have a solid
+fill or outline by default.
+
+```xml
+
+```
+
+
+
+Elevated
+
+Default
| Checked
| Unchecked
+----------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- | -----------------------------------------
+ |  | 
+ |  | 
+
+By default, the elevated button is uncheckable. To make it checkable, enable the
+`android:checkable` attribute in style or layout.
+
+```xml
+
+```
+
+
+
+Filled button with icons
+
+Default
| Checked
| Unchecked
+------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------ | -----------------------------------------
+ |  | 
+ |  | 
+
+Icons visually communicate the button’s action and help draw attention. They
+should be placed on the leading side of the button, before the label text.
+
+```xml
+
+```
+
+
+
+#### Shapes
+
+Round
+
+Default
| Checked
| Unchecked
+---------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- | -----------------------------------------
+ |  | 
+
+```xml
+
+```
+
+
+
+Square
+
+Default
| Checked
| Unchecked
+------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------ | -----------------------------------------
+ |  | 
+
+```xml
+
+```
+
+
+
+#### Sizes
+
+**Note:** Images below show the label buttons in different sizes relatively. The
+actual sizes in px on mobile devices depends on the screen pixel density.
+
+Extra small
+
+
+
+```xml
+
+```
+
+
+
+Small
+
+
+
+```xml
+
+```
+
+
+
+Medium
+
+
+
+```xml
+
+```
+
+
+
+Large
+
+
+
+```xml
+
+```
+
+
+
+Extra Large
+
+
+
+```xml
+
+```
+
+
+
## Key properties
@@ -388,7 +624,7 @@ page.
* The default and toggle buttons use different colors
* Toggle buttons don’t use the text style
-
+
1. Elevated button
2. Filled button
@@ -421,7 +657,7 @@ In the layout:
```xml
+
1. Container
2. Elements
@@ -30,12 +30,14 @@ Docked toolbar provides a way to show actions related to the current page.
More details on anatomy items in the
[component guidelines](https://m3.material.io/components/toolbars/guidelines#d6b7bcb1-295d-41e6-a051-37f12e1c96ab).
-## M3 Expressive update
+## M3 Expressive
+
+### M3 Expressive update
Before you can use `Material3Expressive` component styles, follow the
[`Material3Expressive themes` setup instructions](https://github.com/material-components/material-components-android/tree/master/docs/getting-started.md#material3expressive-themes).
-
+
Docked with embedded primary action instead of FAB
The **bottom app bar** is being deprecated and should be replaced with the
@@ -53,6 +55,14 @@ flexibility.
* **Bottom app bar** is still available, but not recommended
+### M3 Expressive styles
+
+The standard style for the docked toolbar is defined as below:
+
+```xml
+- @style/Widget.Material3Expressive.DockedToolbar
+```
+
## Key properties
### Container attributes
@@ -314,7 +324,7 @@ Docked toolbars support the customization of color and typography.
The following example shows a docked toolbar with Material theming.
-
+
##### Implementing docked toolbar theming
diff --git a/docs/components/ExtendedFloatingActionButton.md b/docs/components/ExtendedFloatingActionButton.md
index 98a78a3e1..f899ccade 100644
--- a/docs/components/ExtendedFloatingActionButton.md
+++ b/docs/components/ExtendedFloatingActionButton.md
@@ -12,7 +12,7 @@ path: /catalog/floating-action-button/
[Extended floating action buttons (extended FABs)](https://m3.material.io/components/extended-fab)
help people take primary actions. There are three variants of the extended FAB.
-
+
1. Small extended FAB
2. Medium extended FAB
@@ -27,7 +27,7 @@ help people take primary actions. There are three variants of the extended FAB.
## Anatomy
-
+
1. Container
2. Text label
@@ -36,13 +36,15 @@ help people take primary actions. There are three variants of the extended FAB.
More details on anatomy items in the
[component guidelines](https://m3.material.io/components/extended-fab/guidelines#1dc1f503-edff-4e3f-b2a6-c76cee1b8369).
-## M3 Expressive update
+## M3 Expressive
+
+### M3 Expressive update
Before you can use `Material3Expressive` component styles, follow the
[`Material3Expressive` themes setup instructions](https://github.com/material-components/material-components-android/tree/master/docs/getting-started.md#material3expressive-themes).
 The original
+FABs from the expressive update.](assets/fabs/efab-expressive.png) The original
extended FAB is replaced with a set of small, medium, and large extended FABs
with new typography
@@ -67,6 +69,59 @@ replaced with the small extended FAB. Surface FABs are also being deprecated.
* Adjusted typography to be larger
+### M3 Expressive styles
+
+#### M3 Expressive small extended FAB
+
+
|
+------------------------------------------------------------------------------------------------------------------------------------------- | -----------------------------------------------------------------------------------------------------------------------------------------
+
+```xml
+
+```
+
+#### M3 Expressive medium extended FAB
+
+
|
+--------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------
+
+```xml
+
+```
+
+#### M3 Expressive large extended FAB
+
+
|
+------------------------------------------------------------------------------------------------------------------------------------------- | -----------------------------------------------------------------------------------------------------------------------------------------
+
+```xml
+
+```
+
## Key properties
### Container attributes
@@ -118,7 +173,7 @@ and
There are three types of extended FABs: small, medium, and large.
-
+
Choose an appropriately-sized extended FAB to add the right amount of emphasis
for an action.
@@ -160,7 +215,7 @@ API and source code:
The following example shows an extended FAB with a plus icon.
-
+
In the layout:
@@ -243,7 +298,7 @@ The following example shows a regular, small, and extended FAB with Material
Theming.

+with "Extended" label"](assets/fabs/fab-theming.png)
##### Implementing FAB theming
diff --git a/docs/components/FloatingActionButton.md b/docs/components/FloatingActionButton.md
index 628f748cb..445f5b7d3 100644
--- a/docs/components/FloatingActionButton.md
+++ b/docs/components/FloatingActionButton.md
@@ -13,7 +13,7 @@ A
[floating action button (FAB)](https://m3.material.io/components/floating-action-button)
represents the primary action of a screen. There are three variants of a FAB.
-
+
1. FAB
2. Medium FAB
@@ -32,7 +32,7 @@ center.
## Anatomy
-
+
1. Container
2. Icon
@@ -40,12 +40,14 @@ center.
More details on anatomy items in the
[component guidelines](https://m3.material.io/components/floating-action-button/guidelines#9a56f806-8840-4910-8f53-3cb2a6c81c86).
-## M3 Expressive update
+## M3 Expressive
+
+### M3 Expressive update
Before you can use `Material3Expressive` component styles, follow the
[`Material3Expressive` themes setup instructions](https://github.com/material-components/material-components-android/tree/master/docs/getting-started.md#material3expressive-themes).
-
+
FABs have updated colors and sizes
The FAB has new sizes to match the extended FAB and more color options. The
@@ -72,6 +74,78 @@ small FAB is deprecated.
* The values haven't changed
* Deprecated surface color FABs
+### M3 Expressive styles
+
+#### Theme overlays
+
+To avoid a scenario of exploding style combinations, the colors will be handled
+via theme overlays instead of creating distinct styles for each size/palette
+combination for FABs and extended FABs.
+
+M3 Expressive library provides six theme overlays to be used:
+
+- `ThemeOverlay.Material3Expressive.FloatingActionButton.Primary`
+- `ThemeOverlay.Material3Expressive.FloatingActionButton.Secondary`
+- `ThemeOverlay.Material3Expressive.FloatingActionButton.Tertiary`
+- `ThemeOverlay.Material3Expressive.FloatingActionButton.PrimaryContainer`
+- `ThemeOverlay.Material3Expressive.FloatingActionButton.SecondaryContainer`
+- `ThemeOverlay.Material3Expressive.FloatingActionButton.TertiaryContainer`
+
+The theme overlay for a given FAB or extended FAB can be specified within the
+component XML by adding, for example,
+`app:materialThemeOverlay="@style/ThemeOverlay.Material3Expressive.FloatingActionButton.Primary`.
+
+**Note:** The images below show FAB examples in light mode (left) and in dark
+mode (right) using the primary theme overlay.
+
+#### M3 Expressive FAB
+
+
|
+------------------------------------------------------------------------------------------------------------------------------- | -----------------------------------------------------------------------------------------------------------------------------
+
+```xml
+
+```
+
+#### M3 Expressive medium FAB
+
+
|
+---------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------
+
+```xml
+
+```
+
+#### M3 Expressive large FAB
+
+
|
+-------------------------------------------------------------------------------------------------------------------------------------------- | -----------------------------------------------------------------------------------------------------------------------------------------
+
+```xml
+
+```
+
## Key properties
### Container attributes
@@ -116,7 +190,7 @@ There are three FAB sizes:
Choose the FAB size based on the visual hierarchy of your layout.
-FABs have multiple sizes that scale with
+FABs have multiple sizes that scale with
window size
@@ -137,7 +211,7 @@ API and source code:
The following example shows a regular FAB with a plus icon.
-
+
In the layout:
@@ -186,9 +260,9 @@ API and source code:
#### Medium FAB example
-The following example shows a small FAB with a plus icon.
+The following example shows a medium FAB with a plus icon.
-
+
In the layout:
@@ -234,7 +308,7 @@ API and source code:
The following example shows a large FAB with a plus icon.
-
+
In the layout:
@@ -281,7 +355,7 @@ API and source code:
The following example shows a small FAB with a plus icon.
-
+
In the layout:
@@ -357,7 +431,7 @@ API and source code:
The following example shows multiple FABs with Material Theming in different
sizes that scale with window size.
-
+
##### Implementing FAB theming
diff --git a/docs/components/FloatingToolbar.md b/docs/components/FloatingToolbar.md
index c7b59419c..5b062e0a3 100644
--- a/docs/components/FloatingToolbar.md
+++ b/docs/components/FloatingToolbar.md
@@ -33,12 +33,14 @@ Vertical floating toolbar
More details on anatomy items in the
[component guidelines](https://m3.material.io/components/toolbars/guidelines#d6b7bcb1-295d-41e6-a051-37f12e1c96ab).
-## M3 Expressive update
+## M3 Expressive
+
+### M3 Expressive update
Before you can use `Material3Expressive` component styles, follow the
[`Material3Expressive themes` setup instructions](https://github.com/material-components/material-components-android/tree/master/docs/getting-started.md#material3expressive-themes).
-
+
Floating toolbar show controls relevant to the current page
The **floating toolbar** was created for more versatility, greater amounts of
@@ -54,6 +56,57 @@ actions, and more variety in where it's placed.
* Flexibility: Can hold many elements and components. Can be paired with
FAB.
+### M3 Expressive styles
+
+There are two styles for the floating toolbar specifying different color
+schemes:
+
+```xml
+- @style/Widget.Material3Expressive.FloatingToolbar
+- @style/Widget.Material3Expressive.FloatingToolbar.Vibrant
+```
+
+Standard Floating Toolbar | Vibrant Floating Toolbar
+---------------------------------------------------------------------------------- | ------------------------
+ | 
+
+By default, if a style is not specified, a `FloatingToolbar` will use
+`floatingToolbarStyle` from the theme.
+
+There are also styles specific to components inside the floating toolbar that
+are recommended to be used. Currently, the recommendation exists for icon
+buttons: `Widget.Material3Expressive.FloatingToolbar.IconButton` and
+`Widget.Material3Expressive.FloatingToolbar.IconButton.Vibrant`.
+
+Example usage:
+
+```xml
+
+
+
+
+
+ ...
+```
+
## Key properties
### Container attributes
@@ -171,12 +224,11 @@ Here's what a typical layout would look like:
```
-A Floating Toolbar is a `FrameLayout` that provides additional styling and
-functionality.
-You may add children to it as you would to a `FrameLayout`. It's recommended to
-have its children wrapped by an `OverflowLinearLayout` that will handle
-automatically adding items to an overflow button when there's not enough screen
-space to show all the items.
+A floating toolbar is a `FrameLayout` that provides additional styling and
+functionality. You may add children to it as you would to a `FrameLayout`. It's
+recommended to have its children wrapped by an `OverflowLinearLayout` that will
+handle automatically adding items to an overflow button when there's not enough
+screen space to show all the items.
When using `OverflowLinearLayout`, you should also set `app:layout_overflowText`
as that will be the text of the menu item that corresponds to the hidden child.
@@ -184,7 +236,7 @@ Optionally, you can also set `app:layout_overflowIcon`. See
[OverflowLinearLayout](https://github.com/material-components/material-components-android/tree/master//docs/components/Overflow.md)
for more info.
-Note: if the child view that is clickable is not a direct child of
+**Note:** if the child view that is clickable is not a direct child of
`OverflowLinearLayout`, such as the case of the example above, make sure to
propagate the parent's click to the child. That is so overflowed items in the
overflowed menu respond properly to being clicked. Alternatively, you can also
diff --git a/docs/components/NavigationDrawer.md b/docs/components/NavigationDrawer.md
index b778a2b8d..26d206746 100644
--- a/docs/components/NavigationDrawer.md
+++ b/docs/components/NavigationDrawer.md
@@ -18,7 +18,7 @@ window size classes.
provide access to destinations in your app. There are two variants of navigation
drawers.
-
+
1. Standard navigation drawer
2. Modal navigation drawer
@@ -32,7 +32,7 @@ drawers.
## Anatomy
-
+
1. Container
2. Headline
diff --git a/docs/components/assets/bottomnav/navigationbar_anatomy.png b/docs/components/assets/bottomnav/bottomnav-anatomy.png
similarity index 100%
rename from docs/components/assets/bottomnav/navigationbar_anatomy.png
rename to docs/components/assets/bottomnav/bottomnav-anatomy.png
diff --git a/docs/components/assets/bottomnav/navigationbar_expressive.png b/docs/components/assets/bottomnav/bottomnav-expressive.png
similarity index 100%
rename from docs/components/assets/bottomnav/navigationbar_expressive.png
rename to docs/components/assets/bottomnav/bottomnav-expressive.png
diff --git a/docs/components/assets/bottomnav/navigationbar_hero.png b/docs/components/assets/bottomnav/bottomnav-hero.png
similarity index 100%
rename from docs/components/assets/bottomnav/navigationbar_hero.png
rename to docs/components/assets/bottomnav/bottomnav-hero.png
diff --git a/docs/components/assets/bottomnav/bottomnav_horizontal.png b/docs/components/assets/bottomnav/bottomnav-horizontal.png
similarity index 100%
rename from docs/components/assets/bottomnav/bottomnav_horizontal.png
rename to docs/components/assets/bottomnav/bottomnav-horizontal.png
diff --git a/docs/components/assets/buttons/checked-elevated-dark.png b/docs/components/assets/buttons/checked-elevated-dark.png
new file mode 100644
index 000000000..1dcfdee01
Binary files /dev/null and b/docs/components/assets/buttons/checked-elevated-dark.png differ
diff --git a/docs/components/assets/buttons/checked-elevated-light.png b/docs/components/assets/buttons/checked-elevated-light.png
new file mode 100644
index 000000000..3c5c26942
Binary files /dev/null and b/docs/components/assets/buttons/checked-elevated-light.png differ
diff --git a/docs/components/assets/buttons/checked-filled-button-dark.png b/docs/components/assets/buttons/checked-filled-button-dark.png
new file mode 100644
index 000000000..1dcfdee01
Binary files /dev/null and b/docs/components/assets/buttons/checked-filled-button-dark.png differ
diff --git a/docs/components/assets/buttons/checked-filled-button-light.png b/docs/components/assets/buttons/checked-filled-button-light.png
new file mode 100644
index 000000000..3c5c26942
Binary files /dev/null and b/docs/components/assets/buttons/checked-filled-button-light.png differ
diff --git a/docs/components/assets/buttons/checked-filled-icon-button-dark.png b/docs/components/assets/buttons/checked-filled-icon-button-dark.png
new file mode 100644
index 000000000..efe5e7aec
Binary files /dev/null and b/docs/components/assets/buttons/checked-filled-icon-button-dark.png differ
diff --git a/docs/components/assets/buttons/checked-filled-icon-button-light.png b/docs/components/assets/buttons/checked-filled-icon-button-light.png
new file mode 100644
index 000000000..13f54366c
Binary files /dev/null and b/docs/components/assets/buttons/checked-filled-icon-button-light.png differ
diff --git a/docs/components/assets/buttons/checked-filled-tonal-dark.png b/docs/components/assets/buttons/checked-filled-tonal-dark.png
new file mode 100644
index 000000000..91c3f95de
Binary files /dev/null and b/docs/components/assets/buttons/checked-filled-tonal-dark.png differ
diff --git a/docs/components/assets/buttons/checked-filled-tonal-light.png b/docs/components/assets/buttons/checked-filled-tonal-light.png
new file mode 100644
index 000000000..67f29bb1e
Binary files /dev/null and b/docs/components/assets/buttons/checked-filled-tonal-light.png differ
diff --git a/docs/components/assets/buttons/checked-outlined-button-dark.png b/docs/components/assets/buttons/checked-outlined-button-dark.png
new file mode 100644
index 000000000..74efb0e8b
Binary files /dev/null and b/docs/components/assets/buttons/checked-outlined-button-dark.png differ
diff --git a/docs/components/assets/buttons/checked-outlined-button-light.png b/docs/components/assets/buttons/checked-outlined-button-light.png
new file mode 100644
index 000000000..260457c6b
Binary files /dev/null and b/docs/components/assets/buttons/checked-outlined-button-light.png differ
diff --git a/docs/components/assets/buttons/checked-round-shaped.png b/docs/components/assets/buttons/checked-round-shaped.png
new file mode 100644
index 000000000..1dcfdee01
Binary files /dev/null and b/docs/components/assets/buttons/checked-round-shaped.png differ
diff --git a/docs/components/assets/buttons/checked-square-shape.png b/docs/components/assets/buttons/checked-square-shape.png
new file mode 100644
index 000000000..1d734778f
Binary files /dev/null and b/docs/components/assets/buttons/checked-square-shape.png differ
diff --git a/docs/components/assets/buttons/commonbutton_anatomy.png b/docs/components/assets/buttons/commonbutton-anatomy.png
similarity index 100%
rename from docs/components/assets/buttons/commonbutton_anatomy.png
rename to docs/components/assets/buttons/commonbutton-anatomy.png
diff --git a/docs/components/assets/buttons/commonbutton_expressive.png b/docs/components/assets/buttons/commonbutton-expressive.png
similarity index 100%
rename from docs/components/assets/buttons/commonbutton_expressive.png
rename to docs/components/assets/buttons/commonbutton-expressive.png
diff --git a/docs/components/assets/buttons/commonbutton_styles.png b/docs/components/assets/buttons/commonbutton-styles.png
similarity index 100%
rename from docs/components/assets/buttons/commonbutton_styles.png
rename to docs/components/assets/buttons/commonbutton-styles.png
diff --git a/docs/components/assets/buttons/commonbutton_types.png b/docs/components/assets/buttons/commonbutton-types.png
similarity index 100%
rename from docs/components/assets/buttons/commonbutton_types.png
rename to docs/components/assets/buttons/commonbutton-types.png
diff --git a/docs/components/assets/buttons/commonbuttons_types.png b/docs/components/assets/buttons/commonbuttons-types.png
similarity index 100%
rename from docs/components/assets/buttons/commonbuttons_types.png
rename to docs/components/assets/buttons/commonbuttons-types.png
diff --git a/docs/components/assets/buttons/default-elevated-dark.png b/docs/components/assets/buttons/default-elevated-dark.png
new file mode 100644
index 000000000..f58bf525c
Binary files /dev/null and b/docs/components/assets/buttons/default-elevated-dark.png differ
diff --git a/docs/components/assets/buttons/default-elevated-light.png b/docs/components/assets/buttons/default-elevated-light.png
new file mode 100644
index 000000000..41fdc6bfe
Binary files /dev/null and b/docs/components/assets/buttons/default-elevated-light.png differ
diff --git a/docs/components/assets/buttons/default-filled-button-dark.png b/docs/components/assets/buttons/default-filled-button-dark.png
new file mode 100644
index 000000000..1d734778f
Binary files /dev/null and b/docs/components/assets/buttons/default-filled-button-dark.png differ
diff --git a/docs/components/assets/buttons/default-filled-button-light.png b/docs/components/assets/buttons/default-filled-button-light.png
new file mode 100644
index 000000000..604a975a1
Binary files /dev/null and b/docs/components/assets/buttons/default-filled-button-light.png differ
diff --git a/docs/components/assets/buttons/default-filled-button_dark.png b/docs/components/assets/buttons/default-filled-button_dark.png
new file mode 100644
index 000000000..1d734778f
Binary files /dev/null and b/docs/components/assets/buttons/default-filled-button_dark.png differ
diff --git a/docs/components/assets/buttons/default-filled-icon-button-dark.png b/docs/components/assets/buttons/default-filled-icon-button-dark.png
new file mode 100644
index 000000000..80aa71aca
Binary files /dev/null and b/docs/components/assets/buttons/default-filled-icon-button-dark.png differ
diff --git a/docs/components/assets/buttons/default-filled-icon-button-light.png b/docs/components/assets/buttons/default-filled-icon-button-light.png
new file mode 100644
index 000000000..9c2acaf4f
Binary files /dev/null and b/docs/components/assets/buttons/default-filled-icon-button-light.png differ
diff --git a/docs/components/assets/buttons/default-filled-tonal-dark.png b/docs/components/assets/buttons/default-filled-tonal-dark.png
new file mode 100644
index 000000000..2ae8d8706
Binary files /dev/null and b/docs/components/assets/buttons/default-filled-tonal-dark.png differ
diff --git a/docs/components/assets/buttons/default-filled-tonal-light.png b/docs/components/assets/buttons/default-filled-tonal-light.png
new file mode 100644
index 000000000..22b83ceb8
Binary files /dev/null and b/docs/components/assets/buttons/default-filled-tonal-light.png differ
diff --git a/docs/components/assets/buttons/default-outlined-button-dark.png b/docs/components/assets/buttons/default-outlined-button-dark.png
new file mode 100644
index 000000000..c6c81cfab
Binary files /dev/null and b/docs/components/assets/buttons/default-outlined-button-dark.png differ
diff --git a/docs/components/assets/buttons/default-outlined-button-light.png b/docs/components/assets/buttons/default-outlined-button-light.png
new file mode 100644
index 000000000..647d3d177
Binary files /dev/null and b/docs/components/assets/buttons/default-outlined-button-light.png differ
diff --git a/docs/components/assets/buttons/default-round-shape.png b/docs/components/assets/buttons/default-round-shape.png
new file mode 100644
index 000000000..1d734778f
Binary files /dev/null and b/docs/components/assets/buttons/default-round-shape.png differ
diff --git a/docs/components/assets/buttons/default-square-shape.png b/docs/components/assets/buttons/default-square-shape.png
new file mode 100644
index 000000000..1dcfdee01
Binary files /dev/null and b/docs/components/assets/buttons/default-square-shape.png differ
diff --git a/docs/components/assets/buttons/extra-large-size.png b/docs/components/assets/buttons/extra-large-size.png
new file mode 100644
index 000000000..31ecfab6d
Binary files /dev/null and b/docs/components/assets/buttons/extra-large-size.png differ
diff --git a/docs/components/assets/buttons/extrasmall.png b/docs/components/assets/buttons/extrasmall.png
new file mode 100644
index 000000000..e6974b305
Binary files /dev/null and b/docs/components/assets/buttons/extrasmall.png differ
diff --git a/docs/components/assets/buttons/large-size.png b/docs/components/assets/buttons/large-size.png
new file mode 100644
index 000000000..04c9415a6
Binary files /dev/null and b/docs/components/assets/buttons/large-size.png differ
diff --git a/docs/components/assets/buttons/medium-size.png b/docs/components/assets/buttons/medium-size.png
new file mode 100644
index 000000000..211688f39
Binary files /dev/null and b/docs/components/assets/buttons/medium-size.png differ
diff --git a/docs/components/assets/buttons/small-size.png b/docs/components/assets/buttons/small-size.png
new file mode 100644
index 000000000..1d734778f
Binary files /dev/null and b/docs/components/assets/buttons/small-size.png differ
diff --git a/docs/components/assets/buttons/text-button-dark.png b/docs/components/assets/buttons/text-button-dark.png
new file mode 100644
index 000000000..536b92016
Binary files /dev/null and b/docs/components/assets/buttons/text-button-dark.png differ
diff --git a/docs/components/assets/buttons/text-button-light.png b/docs/components/assets/buttons/text-button-light.png
new file mode 100644
index 000000000..4250a2f17
Binary files /dev/null and b/docs/components/assets/buttons/text-button-light.png differ
diff --git a/docs/components/assets/buttons/unchecked-button-dark.png b/docs/components/assets/buttons/unchecked-button-dark.png
new file mode 100644
index 000000000..e3c921d48
Binary files /dev/null and b/docs/components/assets/buttons/unchecked-button-dark.png differ
diff --git a/docs/components/assets/buttons/unchecked-button-light.png b/docs/components/assets/buttons/unchecked-button-light.png
new file mode 100644
index 000000000..2b4538add
Binary files /dev/null and b/docs/components/assets/buttons/unchecked-button-light.png differ
diff --git a/docs/components/assets/buttons/unchecked-elevated-dark.png b/docs/components/assets/buttons/unchecked-elevated-dark.png
new file mode 100644
index 000000000..f58bf525c
Binary files /dev/null and b/docs/components/assets/buttons/unchecked-elevated-dark.png differ
diff --git a/docs/components/assets/buttons/unchecked-elevated-light.png b/docs/components/assets/buttons/unchecked-elevated-light.png
new file mode 100644
index 000000000..41fdc6bfe
Binary files /dev/null and b/docs/components/assets/buttons/unchecked-elevated-light.png differ
diff --git a/docs/components/assets/buttons/unchecked-filled-icon-button-dark.png b/docs/components/assets/buttons/unchecked-filled-icon-button-dark.png
new file mode 100644
index 000000000..ccff08fbc
Binary files /dev/null and b/docs/components/assets/buttons/unchecked-filled-icon-button-dark.png differ
diff --git a/docs/components/assets/buttons/unchecked-filled-icon-button-light.png b/docs/components/assets/buttons/unchecked-filled-icon-button-light.png
new file mode 100644
index 000000000..d53d59e36
Binary files /dev/null and b/docs/components/assets/buttons/unchecked-filled-icon-button-light.png differ
diff --git a/docs/components/assets/buttons/unchecked-filled-tonal-dark.png b/docs/components/assets/buttons/unchecked-filled-tonal-dark.png
new file mode 100644
index 000000000..2ae8d8706
Binary files /dev/null and b/docs/components/assets/buttons/unchecked-filled-tonal-dark.png differ
diff --git a/docs/components/assets/buttons/unchecked-filled-tonal-light.png b/docs/components/assets/buttons/unchecked-filled-tonal-light.png
new file mode 100644
index 000000000..22b83ceb8
Binary files /dev/null and b/docs/components/assets/buttons/unchecked-filled-tonal-light.png differ
diff --git a/docs/components/assets/buttons/unchecked-outlined-button-dark.png b/docs/components/assets/buttons/unchecked-outlined-button-dark.png
new file mode 100644
index 000000000..c6c81cfab
Binary files /dev/null and b/docs/components/assets/buttons/unchecked-outlined-button-dark.png differ
diff --git a/docs/components/assets/buttons/unchecked-outlined-button-light.png b/docs/components/assets/buttons/unchecked-outlined-button-light.png
new file mode 100644
index 000000000..647d3d177
Binary files /dev/null and b/docs/components/assets/buttons/unchecked-outlined-button-light.png differ
diff --git a/docs/components/assets/buttons/unchecked-round-shape.png b/docs/components/assets/buttons/unchecked-round-shape.png
new file mode 100644
index 000000000..2b4538add
Binary files /dev/null and b/docs/components/assets/buttons/unchecked-round-shape.png differ
diff --git a/docs/components/assets/buttons/unchecked-square-shape.png b/docs/components/assets/buttons/unchecked-square-shape.png
new file mode 100644
index 000000000..1b1cec5fe
Binary files /dev/null and b/docs/components/assets/buttons/unchecked-square-shape.png differ
diff --git a/docs/components/assets/dockedtoolbar/docked_toolbar_anatomy.png b/docs/components/assets/dockedtoolbar/docked-toolbar-anatomy.png
similarity index 100%
rename from docs/components/assets/dockedtoolbar/docked_toolbar_anatomy.png
rename to docs/components/assets/dockedtoolbar/docked-toolbar-anatomy.png
diff --git a/docs/components/assets/dockedtoolbar/docked_toolbar_theming.png b/docs/components/assets/dockedtoolbar/docked-toolbar-theming.png
similarity index 100%
rename from docs/components/assets/dockedtoolbar/docked_toolbar_theming.png
rename to docs/components/assets/dockedtoolbar/docked-toolbar-theming.png
diff --git a/docs/components/assets/dockedtoolbar/docked_toolbar.png b/docs/components/assets/dockedtoolbar/docked-toolbar.png
similarity index 100%
rename from docs/components/assets/dockedtoolbar/docked_toolbar.png
rename to docs/components/assets/dockedtoolbar/docked-toolbar.png
diff --git a/docs/components/assets/dockedtoolbar/dockedtoolbar_expressive.png b/docs/components/assets/dockedtoolbar/dockedtoolbar-expressive.png
similarity index 100%
rename from docs/components/assets/dockedtoolbar/dockedtoolbar_expressive.png
rename to docs/components/assets/dockedtoolbar/dockedtoolbar-expressive.png
diff --git a/docs/components/assets/fabs/EFAB_anatomy.png b/docs/components/assets/fabs/efab-anatomy.png
similarity index 100%
rename from docs/components/assets/fabs/EFAB_anatomy.png
rename to docs/components/assets/fabs/efab-anatomy.png
diff --git a/docs/components/assets/fabs/efab-anatomy_long.png b/docs/components/assets/fabs/efab-anatomy_long.png
new file mode 100644
index 000000000..3ea67ae96
Binary files /dev/null and b/docs/components/assets/fabs/efab-anatomy_long.png differ
diff --git a/docs/components/assets/fabs/EFAB_expressive.png b/docs/components/assets/fabs/efab-expressive.png
similarity index 100%
rename from docs/components/assets/fabs/EFAB_expressive.png
rename to docs/components/assets/fabs/efab-expressive.png
diff --git a/docs/components/assets/fabs/efab-hero.png b/docs/components/assets/fabs/efab-hero.png
new file mode 100644
index 000000000..136bed06c
Binary files /dev/null and b/docs/components/assets/fabs/efab-hero.png differ
diff --git a/docs/components/assets/fabs/EFAB_sizes.png b/docs/components/assets/fabs/efab-sizes.png
similarity index 100%
rename from docs/components/assets/fabs/EFAB_sizes.png
rename to docs/components/assets/fabs/efab-sizes.png
diff --git a/docs/components/assets/fabs/EFAB_types.png b/docs/components/assets/fabs/efab-types.png
similarity index 100%
rename from docs/components/assets/fabs/EFAB_types.png
rename to docs/components/assets/fabs/efab-types.png
diff --git a/docs/components/assets/fabs/efab_types.png b/docs/components/assets/fabs/efab_types.png
new file mode 100644
index 000000000..fe7a2bc61
Binary files /dev/null and b/docs/components/assets/fabs/efab_types.png differ
diff --git a/docs/components/assets/fabs/FAB_3sizes.png b/docs/components/assets/fabs/fab-3sizes.png
similarity index 100%
rename from docs/components/assets/fabs/FAB_3sizes.png
rename to docs/components/assets/fabs/fab-3sizes.png
diff --git a/docs/components/assets/fabs/fab-anatomy-long.png b/docs/components/assets/fabs/fab-anatomy-long.png
new file mode 100644
index 000000000..dbedce0c7
Binary files /dev/null and b/docs/components/assets/fabs/fab-anatomy-long.png differ
diff --git a/docs/components/assets/fabs/FAB_anatomy.png b/docs/components/assets/fabs/fab-anatomy.png
similarity index 100%
rename from docs/components/assets/fabs/FAB_anatomy.png
rename to docs/components/assets/fabs/fab-anatomy.png
diff --git a/docs/components/assets/fabs/fab-expressive-dark.png b/docs/components/assets/fabs/fab-expressive-dark.png
new file mode 100644
index 000000000..856889b10
Binary files /dev/null and b/docs/components/assets/fabs/fab-expressive-dark.png differ
diff --git a/docs/components/assets/fabs/fab-expressive-large-dark.png b/docs/components/assets/fabs/fab-expressive-large-dark.png
new file mode 100644
index 000000000..d3c44b6c2
Binary files /dev/null and b/docs/components/assets/fabs/fab-expressive-large-dark.png differ
diff --git a/docs/components/assets/fabs/fab-expressive-large-light.png b/docs/components/assets/fabs/fab-expressive-large-light.png
new file mode 100644
index 000000000..ec4c989fc
Binary files /dev/null and b/docs/components/assets/fabs/fab-expressive-large-light.png differ
diff --git a/docs/components/assets/fabs/fab-expressive-light.png b/docs/components/assets/fabs/fab-expressive-light.png
new file mode 100644
index 000000000..de7bfd5e9
Binary files /dev/null and b/docs/components/assets/fabs/fab-expressive-light.png differ
diff --git a/docs/components/assets/fabs/fab-expressive-medium-dark.png b/docs/components/assets/fabs/fab-expressive-medium-dark.png
new file mode 100644
index 000000000..6f6518584
Binary files /dev/null and b/docs/components/assets/fabs/fab-expressive-medium-dark.png differ
diff --git a/docs/components/assets/fabs/fab-expressive-medium-light.png b/docs/components/assets/fabs/fab-expressive-medium-light.png
new file mode 100644
index 000000000..2bb54a932
Binary files /dev/null and b/docs/components/assets/fabs/fab-expressive-medium-light.png differ
diff --git a/docs/components/assets/fabs/FAB_expressive.png b/docs/components/assets/fabs/fab-expressive.png
similarity index 100%
rename from docs/components/assets/fabs/FAB_expressive.png
rename to docs/components/assets/fabs/fab-expressive.png
diff --git a/docs/components/assets/fabs/fab_extended.png b/docs/components/assets/fabs/fab-extended.png
similarity index 100%
rename from docs/components/assets/fabs/fab_extended.png
rename to docs/components/assets/fabs/fab-extended.png
diff --git a/docs/components/assets/fabs/fab-hero.png b/docs/components/assets/fabs/fab-hero.png
new file mode 100644
index 000000000..03beb0f9b
Binary files /dev/null and b/docs/components/assets/fabs/fab-hero.png differ
diff --git a/docs/components/assets/fabs/FAB_large.png b/docs/components/assets/fabs/fab-large.png
similarity index 100%
rename from docs/components/assets/fabs/FAB_large.png
rename to docs/components/assets/fabs/fab-large.png
diff --git a/docs/components/assets/fabs/FAB_medium.png b/docs/components/assets/fabs/fab-medium.png
similarity index 100%
rename from docs/components/assets/fabs/FAB_medium.png
rename to docs/components/assets/fabs/fab-medium.png
diff --git a/docs/components/assets/fabs/fab_mini.png b/docs/components/assets/fabs/fab-mini.png
similarity index 100%
rename from docs/components/assets/fabs/fab_mini.png
rename to docs/components/assets/fabs/fab-mini.png
diff --git a/docs/components/assets/fabs/fab_regular.png b/docs/components/assets/fabs/fab-regular.png
similarity index 100%
rename from docs/components/assets/fabs/fab_regular.png
rename to docs/components/assets/fabs/fab-regular.png
diff --git a/docs/components/assets/fabs/fab_theming.png b/docs/components/assets/fabs/fab-theming.png
similarity index 100%
rename from docs/components/assets/fabs/fab_theming.png
rename to docs/components/assets/fabs/fab-theming.png
diff --git a/docs/components/assets/fabs/FAB_types.png b/docs/components/assets/fabs/fab-types.png
similarity index 100%
rename from docs/components/assets/fabs/FAB_types.png
rename to docs/components/assets/fabs/fab-types.png
diff --git a/docs/components/assets/fabs/FABs_sizes.png b/docs/components/assets/fabs/fabs-sizes.png
similarity index 100%
rename from docs/components/assets/fabs/FABs_sizes.png
rename to docs/components/assets/fabs/fabs-sizes.png
diff --git a/docs/components/assets/fabs/large-efabs-dark.png b/docs/components/assets/fabs/large-efabs-dark.png
new file mode 100644
index 000000000..5e7dc6787
Binary files /dev/null and b/docs/components/assets/fabs/large-efabs-dark.png differ
diff --git a/docs/components/assets/fabs/large-efabs-light.png b/docs/components/assets/fabs/large-efabs-light.png
new file mode 100644
index 000000000..0c8bf9822
Binary files /dev/null and b/docs/components/assets/fabs/large-efabs-light.png differ
diff --git a/docs/components/assets/fabs/largefab-anatomy-long.png b/docs/components/assets/fabs/largefab-anatomy-long.png
new file mode 100644
index 000000000..3da190040
Binary files /dev/null and b/docs/components/assets/fabs/largefab-anatomy-long.png differ
diff --git a/docs/components/assets/fabs/medium-efabs-dark.png b/docs/components/assets/fabs/medium-efabs-dark.png
new file mode 100644
index 000000000..079fe9202
Binary files /dev/null and b/docs/components/assets/fabs/medium-efabs-dark.png differ
diff --git a/docs/components/assets/fabs/medium-efabs-light.png b/docs/components/assets/fabs/medium-efabs-light.png
new file mode 100644
index 000000000..9082b469f
Binary files /dev/null and b/docs/components/assets/fabs/medium-efabs-light.png differ
diff --git a/docs/components/assets/fabs/minifab-anatomy-long.png b/docs/components/assets/fabs/minifab-anatomy-long.png
new file mode 100644
index 000000000..def652483
Binary files /dev/null and b/docs/components/assets/fabs/minifab-anatomy-long.png differ
diff --git a/docs/components/assets/fabs/small-efabs-dark.png b/docs/components/assets/fabs/small-efabs-dark.png
new file mode 100644
index 000000000..e7ab79f65
Binary files /dev/null and b/docs/components/assets/fabs/small-efabs-dark.png differ
diff --git a/docs/components/assets/fabs/small-efabs-light.png b/docs/components/assets/fabs/small-efabs-light.png
new file mode 100644
index 000000000..c1b40857e
Binary files /dev/null and b/docs/components/assets/fabs/small-efabs-light.png differ
diff --git a/docs/components/assets/floatingtoolbar/floatingtoolbar_expressive.png b/docs/components/assets/floatingtoolbar/floatingtoolbar-expressive.png
similarity index 100%
rename from docs/components/assets/floatingtoolbar/floatingtoolbar_expressive.png
rename to docs/components/assets/floatingtoolbar/floatingtoolbar-expressive.png
diff --git a/docs/components/assets/floatingtoolbar/standard-floating-toolbar.png b/docs/components/assets/floatingtoolbar/standard-floating-toolbar.png
new file mode 100644
index 000000000..d53b4ef1e
Binary files /dev/null and b/docs/components/assets/floatingtoolbar/standard-floating-toolbar.png differ
diff --git a/docs/components/assets/floatingtoolbar/vibrant-floating-toolbar.png b/docs/components/assets/floatingtoolbar/vibrant-floating-toolbar.png
new file mode 100644
index 000000000..900f019d2
Binary files /dev/null and b/docs/components/assets/floatingtoolbar/vibrant-floating-toolbar.png differ
diff --git a/docs/components/assets/navigationdrawer/navigation_drawer_anatomy.png b/docs/components/assets/navigationdrawer/navigation-drawer-anatomy.png
similarity index 100%
rename from docs/components/assets/navigationdrawer/navigation_drawer_anatomy.png
rename to docs/components/assets/navigationdrawer/navigation-drawer-anatomy.png
diff --git a/docs/components/assets/navigationdrawer/navigation_drawer_overview.png b/docs/components/assets/navigationdrawer/navigation-drawer-overview.png
similarity index 100%
rename from docs/components/assets/navigationdrawer/navigation_drawer_overview.png
rename to docs/components/assets/navigationdrawer/navigation-drawer-overview.png