goognet/ui

Componentes Blade para Laravel e Tailwind CSS v4: navegação, avaliação, carrossel, galeria, mídia, modal e mais — acessíveis (WCAG 2.2) e com filtro de URL em todo href e src.

Requisitos

• PHP 8.4+
• Laravel 13
• Tailwind CSS 4 com Vite

Instalação

composer require goognet/ui
php artisan goognet-ui:install
npm install swiper fslightbox

O goognet-ui:install publica config/goognet-ui.php, acrescenta o import do CSS depois do @import 'tailwindcss' em resources/css/app.css e o initUi() em resources/js/app.js. Pode rodar de novo sem duplicar nada; --force sobrescreve o config, --css e --js apontam outros arquivos.

As cores da marca se trocam no @theme do site, depois do import:

@theme {
    --color-primary-500: var(--color-blue-500);
}

Uso

<x-ui.button variant="primary" href="/contato">Fale conosco</x-ui.button>

<x-ui.gallery :columns="['base' => 2, 'md' => 4]" lightbox="obras">
    <x-ui.gallery-item src="obra-1.jpg" alt="Fachada" />
</x-ui.gallery>

O prefixo ui. é configurável em config/goognet-ui.php ('gn-' → <x-gn-button>).

Personalização

Três camadas, nenhuma copia arquivo do pacote — atualizar não apaga nada.

Tokens no @theme do site mudam a identidade inteira:

@theme {
    --radius-control: 0;
    --font-weight-control: 700;
    --spacing-control: 3rem;
}

Classe na chamada substitui a do componente para a mesma propriedade:

<x-ui.button class="rounded-full uppercase">Enviar</x-ui.button>

Por projeto, no AppServiceProvider:

use Goognet\Ui\Ui;

Ui::button()
    ->defaults(['variant' => 'primary'])
    ->variant('inverted', 'bg-white text-neutral-900 hover:bg-neutral-100')
    ->part('base', 'uppercase tracking-wide');

Documentação

https://goognet.github.io/ui — todos os componentes, com exemplos funcionando e as props lidas do código. É publicada a cada versão.

Para ver uma mudança antes de publicar: composer docs gera a página e composer docs:serve abre em http://localhost:8080. Dentro de um site, a mesma página abre em /dev/components com GOOGNET_UI_CATALOGUE=true.

Configuração

config/goognet-ui.php reúne prefixo, segurança (esquemas e hosts de iframe), dados da empresa, redes sociais, menu, WhatsApp e o catálogo.

O e-mail público da empresa vem de CONTACT_EMAIL no .env:

CONTACT_EMAIL="[email protected]"

Em configurações já publicadas, ajuste company.mail para env('CONTACT_EMAIL') e renomeie a chave antiga no .env. Evite MAIL: no Linux, essa variável pode conter o caminho da caixa postal do usuário e prevalecer sobre o .env. Depois de atualizar o servidor, recrie o cache com php artisan config:cache.

Imagens e vídeos responsivos

x-ui.image e x-ui.video-background usam as variantes geradas no build do site (foto-400.webp, video.webm). Sem esse passo no vite.config.js, a imagem sai sem srcset e o vídeo não encontra os arquivos.

Testes

composer test

Licença

MIT. Veja LICENSE e, para reportar falhas de segurança, SECURITY.md.