Um ambiente de desenvolvimento de UI para aplicações Ruby on Rails.
Documentação | Site de demonstração
O Lookbook combina um poderoso navegador de componentes e sistema de visualização com um mecanismo de documentação integrado para ajudar as equipes a construir interfaces de usuário robustas, modulares e de fácil manutenção.
É compatível com parciais ViewComponent, Phlex, ActionView e muito mais.
Leia os documentos →
Lookbook é implementado como um Rails Engine isolado e usa ViewComponent, Tailwind e Alpine para sua UI.
Este repositório contém:
O código-fonte do Lookbook ( /app
, /lib
, /config
, etc)
O código-fonte e o conteúdo do site de documentação do Lookbook ( /docs
).
Um conjunto de testes com um aplicativo fictício 'executável' ( /spec
).
O site de documentos do Lookbook foi criado em Bridgetown e os arquivos de origem podem ser encontrados no diretório ./docs
.
Para visualizar as alterações localmente, você pode executar uma versão de desenvolvimento do site de documentos:
Clonar este repositório
Instalar dependências: bundle install
Inicie o aplicativo: bin/docs
Visite http://localhost:4000
Lookbook usa RSpec para testes.
Os testes podem ser executados usando os comandos rake spec
ou bundle exec rspec
.
O aplicativo fictício no qual os testes estão sendo executados pode ser visualizado executando o comando bin/dummy
e navegando até http://localhost:9292/lookbook
Lookbook usa Release It! para automatizar o processo de liberação.
A execução de npm run release
iniciará o processo de publicação de uma nova versão e percorrerá todas as etapas, desde a escolha de um número de versão até a publicação da gema atualizada.
A publicação de um lançamento requer permissões de gravação para este repositório (lookbook-hq/lookbook) e permissões de publicação 2FA para Lookbook no RubyGems.
Lookbook é um projeto de código aberto não financiado e contribuições de todos os tipos e tamanhos são bem-vindas!
Reserve um tempo para ler o guia de contribuição antes de fazer sua primeira contribuição e, se algo não estiver claro, inicie uma discussão e faremos o possível para ajudá-lo.
Lookbook foi criado por Mark Perkins e continua a crescer e melhorar graças às ideias, sugestões e trabalho duro de todos esses excelentes humanos:
A gema está disponível como código aberto sob os termos da licença MIT.