Un entorno de desarrollo de UI para aplicaciones Ruby on Rails.
Documentación | Sitio de demostración
Lookbook combina un potente navegador de componentes y un sistema de vista previa con un motor de documentación integrado para ayudar a los equipos a crear interfaces de usuario sólidas, modulares y fáciles de mantener.
Es compatible con los parciales ViewComponent, Phlex, ActionView y más.
Lea los documentos →
Lookbook se implementa como un Rails Engine aislado y utiliza ViewComponent, Tailwind y Alpine para su interfaz de usuario.
Este repositorio contiene:
El código fuente del Lookbook ( /app
, /lib
, /config
, etc.)
El código fuente y el contenido del sitio de documentación de Lookbook ( /docs
).
Un conjunto de pruebas con una aplicación ficticia 'ejecutable' ( /spec
).
El sitio de documentos de Lookbook está creado con Bridgetown y los archivos fuente se pueden encontrar en el directorio ./docs
.
Para obtener una vista previa de los cambios localmente, puede ejecutar una versión de desarrollo del sitio de documentos:
Clonar este repositorio
Instalar dependencias: bundle install
Inicie la aplicación: bin/docs
Visita http://localhost:4000
Lookbook utiliza RSpec para realizar pruebas.
Las pruebas se pueden ejecutar utilizando los comandos rake spec
o bundle exec rspec
.
La aplicación ficticia con la que se ejecutan las pruebas se puede ver ejecutando el comando bin/dummy
y luego navegando a http://localhost:9292/lookbook
Lookbook utiliza Release It! para automatizar el proceso de liberación.
La ejecución de npm run release
iniciará el proceso de publicación de una nueva versión y recorrerá todos los pasos, desde elegir un número de versión hasta publicar la gema actualizada.
La publicación de una versión requiere permisos de escritura para este repositorio (lookbook-hq/lookbook) y permisos de publicación 2FA para Lookbook en RubyGems.
¡Lookbook es un proyecto de código abierto sin financiación y las contribuciones de todo tipo y tamaño son bienvenidas!
Tómese el tiempo para leer la guía de contribución antes de realizar su primera contribución y, si algo no queda claro, inicie una discusión y haremos todo lo posible para ayudarlo.
Lookbook fue creado por Mark Perkins y continúa creciendo y mejorando gracias a las ideas, sugerencias y el arduo trabajo de todos estos excelentes humanos:
La gema está disponible como código abierto según los términos de la licencia MIT.