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
- Atomic Design Methodology (libro Atomic Design de Brad Frost)
- Blade Templates | Laravel 13.x (documentación oficial de Laravel)
- Asset Bundling (Vite) | Laravel 13.x (documentación oficial de Laravel)
¿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.