diff --git a/.storybook/preview-head.html b/.storybook/preview-head.html
index dacdd64..2668e06 100644
--- a/.storybook/preview-head.html
+++ b/.storybook/preview-head.html
@@ -1,3 +1,22 @@
-
\ No newline at end of file
+
+
\ No newline at end of file
diff --git a/src/plugins/components/button/button.component.ts b/src/plugins/components/button/button.component.ts
index 05aaa48..2480db4 100644
--- a/src/plugins/components/button/button.component.ts
+++ b/src/plugins/components/button/button.component.ts
@@ -24,6 +24,7 @@ export const Button = ({
return html`
+
### Shape
@@ -30,7 +30,7 @@ Button shapes allow you to change the border radiuses.
-
+
### Size
@@ -42,7 +42,7 @@ Size allows you to change the size of the button.
-
+
### Flavor: solid
@@ -58,7 +58,7 @@ Flavors represent the visual styles applied to a button. Below are examples of t
-
+
### Flavor: pastel
@@ -72,7 +72,7 @@ Flavors represent the visual styles applied to a button. Below are examples of t
-
+
### Flavor: outline
@@ -86,27 +86,11 @@ Flavors represent the visual styles applied to a button. Below are examples of t
-
-
-### With icons
-
-Buttons can have icons, both on the left and on the right. Use svg icons inside the button slot to render an icon button.
-
-
-
-
-
-
-
-
-
-
-
-
+
### Shadow: flat
-Flavors represent the visual styles applied to a button. Below are examples of the solid flavor.
+Button can have shadows based on the selected color. Below are examples of flat static shadows.
@@ -118,11 +102,11 @@ Flavors represent the visual styles applied to a button. Below are examples of t
-
+
### Shadow: hover
-Flavors represent the visual styles applied to a button. Below are examples of the solid flavor.
+Buttons can have shadows based on the selected color. Below are examples of hover shadows.
@@ -134,12 +118,11 @@ Flavors represent the visual styles applied to a button. Below are examples of t
-
-
+
+
## State
-
### State: loading
Buttons can be shown in a loading state. The loading indicator informs the user that something is being loaded.
@@ -154,7 +137,7 @@ Buttons can be shown in a loading state. The loading indicator informs the user
-
+
### State: disabled
@@ -170,25 +153,69 @@ Buttons can be shown in a disabled state. They are a bit opaque and cannot be cl
-
-
+
+
## Slots
### Slot: default
+Button have a default slot that serves as wrapper for their inner content.
+
-
-
+
+
+### Slot: with icons
+
+Buttons can have icons, both on the left and on the right. Use svg icons inside the button slot to render an icon button.
+
+