diff --git a/docs/README.md b/docs/README.md
index e7a5782..d91f266 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -7,10 +7,10 @@
SigPro UI
- Reactive Design System
- "Atomic components for high-performance interfaces. Zero-boilerplate, pure Tailwind v4 elegance."
+ Reactive Design System for SigPro
+ "Atomic components for high-performance interfaces. Zero-boilerplate, pure DaisyUI v5 elegance."
@@ -102,15 +102,19 @@ The visual DNA. All components are mapped to daisyUI v5 semantic classes, provid
-----
-\
-\
-\
-\
Design at Runtime.\
-\
Combine the best of three worlds: \SigPro\ for logic, \Tailwind v4\ for speed, and \daisyUI v5\ for beauty. Build interfaces that feel as fast as they look.\
-\
-\
-\
+
+
+
+
Design at Runtime.
+
+ Combine the best of three worlds: SigPro for logic,
+ Tailwind v4 for speed, and daisyUI v5 for beauty.
+ Build interfaces that feel as fast as they look.
+
+
+
+
-\
-Atomic UI System — Built for SigPro — NatxoCC
-\
+
+ Atomic UI System — Built for SigPro — NatxoCC
+
diff --git a/docs/_sidebar.md b/docs/_sidebar.md
index c089820..25c37ae 100644
--- a/docs/_sidebar.md
+++ b/docs/_sidebar.md
@@ -1,21 +1,54 @@
+
+
* [**Home**](README.md)
* **Introduction**
* [Installation](install.md)
- * [Examples](examples.md)
- * [Vite Plugin](vite/plugin.md)
+ * [Quick Reference](quick.md)
-* **API Reference**
- * [Quick Start](api/quick.md)
- * [$ signals](api/signal.md)
- * [$watch](api/watch.md)
- * [$if](api/if.md)
- * [$for](api/for.md)
- * [$router](api/router.md)
- * [$mount](api/mount.md)
- * [$html](api/html.md)
- * [Tags](api/tags.md)
- * [Global Store](api/global.md)
+* **Forms & Inputs**
+ * [Button](components/button.md)
+ * [Input](components/input.md)
+ * [Select](components/select.md)
+ * [Autocomplete](components/autocomplete.md)
+ * [Datepicker](components/datepicker.md)
+ * [Colorpicker](components/colorpicker.md)
+ * [Checkbox](components/checkbox.md)
+ * [Radio](components/radio.md)
+ * [Range](components/range.md)
+ * [Rating](components/rating.md)
+ * [Swap](components/swap.md)
-* **UI Components**
- * [Quick Start](ui/quick.md)
\ No newline at end of file
+* **Data Display**
+ * [Table](components/table.md)
+ * [List](components/list.md)
+ * [Badge](components/badge.md)
+ * [Stat](components/stat.md)
+ * [Timeline](components/timeline.md)
+ * [Stack](components/stack.md)
+ * [Indicator](components/indicator.md)
+
+* **Feedback & Overlays**
+ * [Alert](components/alert.md)
+ * [Modal](components/modal.md)
+ * [Toast](components/toast.md)
+ * [Loading](components/loading.md)
+ * [Tooltip](components/tooltip.md)
+
+* **Navigation & Layout**
+ * [Navbar](components/navbar.md)
+ * [Menu](components/menu.md)
+ * [Drawer](components/drawer.md)
+ * [Tabs](components/tabs.md)
+ * [Accordion](components/accordion.md)
+ * [Dropdown](components/dropdown.md)
+ * [Fieldset](components/fieldset.md)
+
+* **Utilities**
+ * [Fab](components/fab.md)
+ * [Toast](components/toast.md)
+
+* **Advanced**
+ * [Reactivity Guide](advanced/reactivity.md)
+ * [i18n Guide](advanced/i18n.md)
+ * [Theming](advanced/theming.md)
\ No newline at end of file
diff --git a/docs/components/button.md b/docs/components/button.md
new file mode 100644
index 0000000..84df933
--- /dev/null
+++ b/docs/components/button.md
@@ -0,0 +1,221 @@
+# Button
+
+Styled button with full DaisyUI support and reactive states.
+
+## Tag
+
+`Button`
+
+## Props
+
+| Prop | Type | Default | Description |
+| :--- | :--- | :--- | :--- |
+| `class` | `string` | `''` | Additional CSS classes (DaisyUI + Tailwind) |
+| `disabled` | `boolean \| Signal` | `false` | Disabled state |
+| `loading` | `boolean \| Signal` | `false` | Shows loading spinner |
+| `badge` | `string \| Signal` | `-` | Badge text displayed on corner |
+| `badgeClass` | `string` | `'badge-secondary'` | Badge styling classes |
+| `tooltip` | `string \| Signal` | `-` | Tooltip text on hover |
+| `icon` | `string \| VNode \| Signal` | `-` | Icon displayed before text |
+| `onclick` | `function` | `-` | Click event handler |
+| `type` | `string` | `'button'` | Native button type |
+
+## Live Examples
+
+### Basic Button
+
+
+
+
+
+```javascript
+Button({ class: "btn-primary" }, "Click Me")
+```
+
+### With Loading State
+
+
+
+
+
+```javascript
+const isSaving = $(false);
+
+Button({
+ class: "btn-success",
+ loading: isSaving,
+ onclick: async () => {
+ isSaving(true);
+ await saveData();
+ isSaving(false);
+ }
+}, "Save Changes")
+```
+
+### With Badge
+
+
+
+
+
+```javascript
+Button({
+ class: "btn-outline",
+ badge: "3",
+ badgeClass: "badge-accent"
+}, "Notifications")
+```
+
+### With Tooltip
+
+
+
+
+
+```javascript
+Button({
+ class: "btn-ghost",
+ tooltip: "Delete item"
+}, "Delete")
+```
+
+### Disabled State
+
+
+
+
+
+```javascript
+const isDisabled = $(true);
+
+Button({
+ class: "btn-primary",
+ disabled: isDisabled
+}, "Submit")
+```
+
+### All Variants
+
+
+
+
+
+```javascript
+Div({ class: "flex flex-wrap gap-2" }, [
+ Button({ class: "btn-primary" }, "Primary"),
+ Button({ class: "btn-secondary" }, "Secondary"),
+ Button({ class: "btn-accent" }, "Accent"),
+ Button({ class: "btn-ghost" }, "Ghost"),
+ Button({ class: "btn-outline" }, "Outline")
+])
+```
+```
+
+## Ventajas de este enfoque:
+
+1. **Ejecución real** - Los ejemplos son interactivos y funcionales
+2. **Código visible** - Debajo de cada ejemplo se muestra el código fuente
+3. **Aprendizaje visual** - Los usuarios pueden ver y probar los componentes
+4. **Reactivo** - Los ejemplos con signals demuestran la reactividad en acción
+
+## Consejos adicionales:
+
+Para mejorar la experiencia, podrías agregar estilos a los contenedores de los ejemplos:
+
+```css
+/* En tu HTML, dentro de
+
+
+
+
+
+