Volver al resumen
Block Libraries
Bibliotecas de componentes reutilizables por sector para sitios web consistentes.
¿Qué son las Block Libraries?
Una Block Library es una colección de componentes reutilizables (bloques) agrupados por sector o estilo. Piensa en una biblioteca para dentistas, restaurantes, inmobiliarias o salones.
Cada biblioteca contiene:
• Un conjunto de componentes (ej. Hero, Menú, Horarios)
• Design tokens (colores, fuentes, espaciado)
• Un número de versión (semver: 1.0.0)
Crear una biblioteca
Haz clic en "Nueva biblioteca" y rellena:
1. Nombre – Un nombre reconocible (ej. "Restaurant Pro")
2. Widget – El sector al que está destinada la biblioteca (dentista, restaurante, inmobiliaria, salón, legal o genérico)
Después de crear, puedes seleccionar componentes y configurar los design tokens.
Componentes y design tokens
En el editor de biblioteca puedes:
• Seleccionar componentes adecuados al sector
• Configurar design tokens: color primario, fuente, espaciado, border-radius
• Previsualizar cómo se ven los componentes con tus tokens
Los tokens se aplican automáticamente a todos los componentes de la biblioteca.
Consejos
- Elige tokens que coincidan con el estilo de marca del sector. Puedes sobrescribirlos por sitio.
- Cuantos más componentes añadas, más flexible será la biblioteca para diferentes sitios.
Gestión de versiones y publicación
Cada biblioteca tiene un número de versión (ej. 1.0.0). Cuando publicas cambios, eliges el tipo de actualización:
• Patch (1.0.1) – Pequeñas correcciones o ajustes
• Minor (1.1.0) – Nuevos componentes o funciones
• Major (2.0.0) – Cambios importantes
Los sitios que usan la biblioteca pueden actualizar a la última versión.
Nota
- Una actualización major puede afectar a sitios existentes. Prueba siempre en un sitio borrador antes de desplegar una versión major.
Vincular presets de tokens
Cada biblioteca puede vincularse a un conjunto de presets de design tokens. Son combinaciones predefinidas de colores, fuentes y espaciado adaptadas a un sector particular.
Para vincular un preset de tokens:
1. Abre el editor de biblioteca
2. Ve a la pestaña "Design Tokens"
3. Elige un preset existente o crea uno nuevo
4. Guarda — los tokens se aplican automáticamente a todos los componentes
Los presets de tokens garantizan que todos los sitios que usan esta biblioteca tengan un aspecto consistente.
Consejos
- Crea presets por sector: un preset de dentista con tonos azules tranquilos, un preset de restaurante con colores cálidos.
- Puedes sobrescribir los tokens por sitio si el cliente tiene su propia identidad de marca.
Asignar una biblioteca a sitios
Puedes asignar una biblioteca a uno o más sitios. Esto da a esos sitios acceso a todos los componentes y tokens de la biblioteca.
Para asignar una biblioteca:
1. Ve a la configuración de la biblioteca
2. Haz clic en "Asignar sitios"
3. Selecciona los sitios que deben usar esta biblioteca
4. Confirma — los componentes están disponibles inmediatamente en el constructor de páginas de esos sitios
Un sitio solo puede usar una biblioteca a la vez. Al cambiar de biblioteca, los bloques existentes no se eliminan, pero los componentes disponibles cambian.
Consejos
- Asigna una biblioteca al crear un sitio mediante un blueprint para la configuración más rápida.
- Después de cambiar de biblioteca, verifica que todos los bloques existentes se muestren correctamente.
Nota
- Cambiar de biblioteca en un sitio existente puede hacer que algunos bloques ya no estén disponibles en el editor.