Atomic Design: metodología y aplicación práctica
Cómo organizar componentes en cinco niveles para construir interfaces escalables y mantenibles
Atomic Design es una metodología creada por Brad Frost en 2013 que propone organizar los componentes de interfaz en cinco niveles jerárquicos inspirados en la química: átomos, moléculas, organismos, templates y páginas. Su objetivo es establecer un vocabulario compartido para pensar sobre la composición de interfaces.
Más de una década después de su publicación, Atomic Design sigue siendo la metodología más referenciada para estructurar sistemas de diseño y librerías de componentes. Esta guía explica cada nivel, cómo aplicarlo en la práctica, y cuándo tiene sentido adoptarla —y cuándo no.
Átomos: las piezas indivisibles
Los átomos son los componentes más básicos e indivisibles de la interfaz. Son elementos HTML nativos o abstracciones mínimas: botones, inputs, etiquetas, iconos, colores, tipografías. No pueden descomponerse en partes más pequeñas sin perder su función.
En la práctica, los átomos de un sistema de diseño incluyen los design tokens (colores, espaciados, tipografías) y los componentes base que no contienen otros componentes. Un botón es un átomo. Un icono es un átomo. Un campo de texto es un átomo. Son las piezas de Lego más pequeñas.
- Ejemplos: Button, Input, Label, Icon, Avatar, Badge, Divider
- Consumen design tokens directamente (colores, tipografías, espaciados)
- No dependen de otros componentes del sistema
- Deben ser altamente reutilizables y configurables mediante props
Moléculas: combinaciones simples con propósito
Las moléculas son combinaciones de átomos que forman un componente con una función específica. Un campo de búsqueda (input + botón + icono) es una molécula. Un form field (label + input + mensaje de error) es una molécula. La clave es que la combinación tiene un propósito funcional claro que los átomos individuales no tienen.
Las moléculas son el nivel donde los componentes empiezan a ser útiles en contextos reales. Un átomo aislado (un input) no resuelve ningún problema de UX. Una molécula (un search field) sí. Este salto de valor es importante porque marca el punto donde los consumidores del sistema empiezan a sentir el beneficio de la reutilización.
- Ejemplos: SearchField, FormField, NavLink, MediaCard, Pagination
- Combinan 2-5 átomos con un propósito funcional claro
- Mantienen la responsabilidad acotada: una molécula = una función
- Son lo suficientemente genéricas para reutilizarse en diferentes contextos
Organismos: secciones de interfaz completas
Los organismos son secciones de interfaz relativamente complejas formadas por grupos de moléculas y átomos. Un header con logo, navegación y búsqueda es un organismo. Un formulario de registro completo es un organismo. Una card de producto con imagen, título, precio y botón de compra es un organismo.
Los organismos son el nivel donde los componentes empiezan a ser específicos del producto. Mientras que los átomos y moléculas suelen ser genéricos y reutilizables en cualquier proyecto, los organismos reflejan la estructura y las necesidades concretas del producto para el que se diseñan.
- Ejemplos: Header, Footer, ProductCard, RegistrationForm, HeroSection
- Combinan múltiples moléculas y átomos en secciones funcionales completas
- Suelen ser más específicos del producto que los niveles inferiores
- Pueden tener lógica de negocio propia (validación, fetching de datos)
Templates: la estructura sin contenido
Los templates definen la estructura y el layout de una página sin contenido real. Son el esqueleto que establece dónde van los organismos, cómo se distribuye el espacio y cómo responde la maquetación en diferentes viewports. En un template, los textos son "lorem ipsum" y las imágenes son placeholders.
Este nivel es valioso en el proceso de diseño porque permite validar la estructura de una página antes de tener el contenido definitivo. Los equipos de diseño pueden iterar sobre la composición y el layout sin estar bloqueados por la generación de contenido.
Páginas: instancias con contenido real
Las páginas son instancias concretas de los templates con contenido real. Es donde el sistema cobra vida: los placeholders se reemplazan por textos reales, imágenes reales y datos reales. Las páginas revelan si la estructura del template funciona con contenido de distintas longitudes y formatos.
Las páginas son el nivel de mayor fidelidad y el que se presenta al usuario final. Son también el mejor contexto para testing de usabilidad, porque representan exactamente lo que el usuario verá. Detectan problemas que los niveles inferiores no pueden: títulos que no caben, imágenes con proporciones inesperadas, combinaciones de contenido que rompen el layout.
Aplicación práctica en proyectos reales
En la práctica, pocos equipos aplican Atomic Design de forma estricta en los cinco niveles. Lo más habitual es adoptar la filosofía de composición jerárquica sin adherirse rígidamente a la nomenclatura. Muchos equipos usan tres niveles (primitivos, compuestos, secciones) o cuatro (base, components, patterns, layouts) con el mismo principio subyacente.
Lo valioso de Atomic Design no es la taxonomía exacta, sino el modelo mental: las interfaces se construyen componiendo piezas pequeñas y reutilizables en estructuras progresivamente más complejas. Este principio aplica independientemente de los nombres que uses para cada nivel.
- La mayoría de equipos adaptan la nomenclatura a su contexto
- Tres niveles (base, components, patterns) suele ser suficiente en la práctica
- La estructura de carpetas del proyecto debe reflejar los niveles elegidos
- Lo importante es el principio de composición, no la taxonomía exacta
Ventajas y limitaciones
La principal ventaja de Atomic Design es que proporciona un vocabulario compartido para hablar de la composición de interfaces. Cuando un diseñador dice "átomo" o "molécula", todo el equipo entiende el nivel de complejidad y reutilización al que se refiere. Esta claridad conceptual acelera la comunicación y reduce malentendidos.
Su principal limitación es que la metáfora química se fuerza en los niveles superiores. La distinción entre template y página no siempre aporta valor en la organización del código, y la frontera entre molécula y organismo puede ser arbitraria. Cuando la clasificación genera más debate que productividad, es señal de que estás siendo demasiado rígido con la metodología.
- Ventaja: vocabulario compartido que acelera la comunicación del equipo
- Ventaja: promueve la reutilización y la composición modular
- Ventaja: fuerza a pensar en los componentes antes que en las páginas
- Limitación: la metáfora química se fuerza en los niveles superiores
- Limitación: la frontera entre molécula y organismo puede ser ambigua
- Limitación: cinco niveles pueden ser excesivos para proyectos pequeños
Puntos clave
- Atomic Design organiza los componentes en cinco niveles jerárquicos: átomos, moléculas, organismos, templates y páginas
- El valor real está en el modelo mental de composición, no en la taxonomía exacta
- La mayoría de equipos adaptan la metodología a tres o cuatro niveles prácticos
- Aporta un vocabulario compartido que mejora la comunicación entre diseño y desarrollo
- No la apliques de forma rígida: cuando la clasificación genera más debate que productividad, simplifica
¿Quieres estructurar tu sistema de diseño con una metodología clara?
Te ayudamos a definir la arquitectura de componentes de tu sistema, adaptando Atomic Design u otra metodología a las necesidades reales de tu equipo.