Laravel

Diseño atómico en Laravel: guía básica para componentes reutilizables

Autorangel cruz
Actualizado
Publicado
Lectura3 min de lectura
Diseño atómico en Laravel: guía básica para componentes reutilizables

Introducción a Atomic Design

Atomic Design es una metodología creada por Brad Frost que organiza interfaces en cinco niveles: átomos, moléculas, organismos, templates y páginas. Ayuda a mantener la coherencia visual y facilita el mantenimiento en proyectos de UI. En Laravel sirve para ordenar los componentes Blade por nivel.

¿Por qué Atomic Design?

Las interfaces se arman con bloques pequeños que se repiten, así que un cambio en un componente se hace en un solo lugar, y eso pesa más a medida que el proyecto crece.

Fundamentos de Atomic Design

Átomos

Son los componentes más básicos: botones, inputs, etiquetas… En Laravel se implementan como componentes Blade individuales.

Moléculas

Combinación de átomos para formar unidades funcionales, como un campo de búsqueda con etiqueta, input y botón.

Organismos

Son áreas completas de UI, como barras de navegación o tarjetas de producto, combinando varias moléculas.

Templates y páginas

Los templates son estructuras de página con layout fijo y placeholders. Las páginas son instancias reales de esos templates con contenido concreto.

Ventajas en Laravel

Blade components

Laravel Blade facilita la creación de componentes reutilizables (<x-button/>), clasificándolos por funcionalidades según el nivel atómico.

Componentes con clase e inyección de dependencias

Cuando un componente necesita lógica o servicios, crea un componente con clase en lugar de uno anónimo: el contenedor de Laravel resuelve las dependencias que declares en su constructor, así esa lógica no termina en la vista. Los componentes anónimos, como los ejemplos de arriba, no tienen clase y no reciben inyección.

Testeo y mantenibilidad

Al separar UI en componentes pequeños, se facilitan pruebas unitarias y refactorizaciones.

Pasos para implementarlo

Crear estructura de carpetas

resources/views/
└── components/
    ├── atoms/
    ├── molecules/
    └── organisms/

Definir componentes Blade (átomo)

Un botón podría ser un ejemplo sencillo:

// resources/views/components/atoms/button.blade.php:
<button {{ $attributes->merge(['class' => 'btn']) }}>
  {{ $slot }}
</button>

Combinar en moléculas

Podría ser un input para buscar:

// components/molecules/search.blade.php
<div class="search">
  <x-atoms.input ... />
  <x-atoms.button>Buscar</x-atoms.button>
</div>

En una vista

Puede ser algo así:

<x-organisms.header />
  <main>
       <x-molecules.search />
       <!-- contenido -->
  </main>
<x-organisms.footer />

Mejores prácticas

Nombres consistentes

Usa convenciones claras como atoms, molecules.

Evitar duplicación

Usa componentes construidos con bloques existentes.

Documentar componentes

Documenta cada componente con comentarios Blade (sus props y un ejemplo de uso) o con una página interna que los muestre todos renderizados. Herramientas como Storybook no soportan Blade de forma nativa.

Dónde encaja esto con el resto de decisiones de estructura de una app Laravel: Laravel en producción.

Preguntas frecuentes

¿Laravel ya soporta Atomic Design?

No por defecto, pero Blade Components facilitan su implementación.

¿Conviene usar CSS-in-JS?

No es necesario; puedes usar Vite, la herramienta con la que Laravel compila CSS y JavaScript, con Sass o el CSS que prefieras.

¿Se puede aplicar sin Blade?

Sí, pero con Livewire o Vue, también es posible.

¿Es adecuado para apps pequeñas?

Sí, desde proyectos pequeños hasta grandes.

¿Cómo testear componentes?

Con PHPUnit / PestPHP y Laravel Dusk puedes testear lógica y UI.

¿Dónde documentar los componentes?

Con comentarios Blade que expliquen las props y un ejemplo, o con una página interna que muestre todos los componentes renderizados. Storybook y Styleguidist están pensados para frameworks de JavaScript como React y no soportan Blade de forma nativa.

Fuentes

¿Tienes un proyecto en mente?

Trabajo con Laravel, WordPress, SEO técnico y servidores MCP. El primer paso es una llamada de descubrimiento, sin costo ni compromiso, donde me cuentas qué necesitas y te digo con honestidad si puedo ayudarte.

Hablemos