PHPackages                             forever-prata/govbr-components-livewire - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. forever-prata/govbr-components-livewire

ActiveLibrary[Utility & Helpers](/categories/utility)

forever-prata/govbr-components-livewire
=======================================

Biblioteca de componentes Livewire com suporte a múltiplos Design Systems (GovBR, Bootstrap e Materialize).

v2.0.2(6mo ago)332MITPHPPHP ^8.1CI passing

Since Aug 21Pushed 5mo ago1 watchersCompare

[ Source](https://github.com/forever-prata/components-library-livewire)[ Packagist](https://packagist.org/packages/forever-prata/govbr-components-livewire)[ RSS](/packages/forever-prata-govbr-components-livewire/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (7)Dependencies (1)Versions (11)Used By (0)

Biblioteca de Componentes Reutilizáveis para Laravel com Livewire Uma biblioteca modular de componentes reutilizáveis para aplicações Laravel utilizando Livewire, com suporte a múltiplos sistemas de design (Bootstrap e GOV.BR).

📋 Índice

- [Instalação](#instala%C3%A7%C3%A3o)
- [Configuração](#configura%C3%A7%C3%A3o)
- [Sistemas de Design Suportados](#sistemas-de-design-suportados)
- [Componentes](#componentes)
- [Automação com Scaffold](#automa%C3%A7%C3%A3o-com-scaffold)
- [Exemplos de Uso](#exemplos-de-uso)
- [Personalização](#personaliza%C3%A7%C3%A3o)
- [Suporte](#suporte)
- [Licença](#licen%C3%A7a)

🚀 Instalação

1. Instalar dependências de frontend

```
npm install bootstrap @popperjs/core @govbr-ds/core
```

2. Instalar a biblioteca via Composer

```
composer require forever-prata/govbr-components-livewire
```

3. Publicar os arquivos da biblioteca

```
php artisan vendor:publish --provider="GovbrComponentsLivewire\GovbrComponentsLivewireServiceProvider" --force
```

⚙️ Configuração

1. Configurar pluralização em português No arquivo AppServiceProvider.php:

```
use Illuminate\Support\Pluralizer;

public function boot(): void
{
    Pluralizer::useLanguage('portuguese');
}
```

2. Configurar Vite No arquivo vite.config.js:

```
import { defineConfig } from 'vite';
import laravel from 'laravel-vite-plugin';

export default defineConfig({
    plugins: [
        laravel({
            input: [
                'resources/css/app.css',
                'resources/js/app.js',
                'resources/css/themes/govbr.css',
                'resources/css/themes/bootstrap.css',
                'resources/js/themes/govbr.js',
                'resources/js/themes/bootstrap.js',
            ],
            refresh: true,
        }),
    ],
});
```

3. Configurar o sistema de design No arquivo .env:

```
DESIGN_SYSTEM=govbr
```

Valores possíveis: govbr ou bootstrap

🎨 Sistemas de Design Suportados GOV.BR Design System - Padrão visual do governo federal brasileiro

Bootstrap - Framework CSS amplamente utilizado

📦 Componentes

1. Componente Botão Renderiza botões interativos ou links com diferentes estilos e comportamentos.

```

```

Parâmetros:

label (string) - Texto exibido no botão

type (string) - Tipo de estilo (primary, secondary, danger, etc.)

size (string) - Tamanho (small, large)

action (string) - Método Livewire a ser executado

href (string) - URL para navegação (transforma em link)

extraClass (string) - Classes CSS adicionais

buttonType (string) - Tipo HTML (submit, reset, button)

2. Componente Checkbox Caixa de seleção para formulários.

```

```

Parâmetros:

name (string) - Nome do campo no formulário

label (string) - Rótulo descritivo

id (string) - ID único (opcional, usa name como padrão)

checked (bool) - Estado inicial (true/false)

3. Componente Input Campo de entrada de texto para formulários.

```

```

Parâmetros:

type (string) - Tipo de input (text, email, password, number)

name (string) - Nome do campo

label (string) - Rótulo descritivo

id (string) - ID único (opcional)

placeholder (string) - Texto de placeholder

wireModel (string) - Binding Livewire

4. Componente Radio Botão de rádio para seleção única em grupos.

```

```

Parâmetros:

name (string) - Nome do grupo

label (string) - Rótulo da opção

value (string) - Valor submetido

id (string) - ID único (opcional)

checked (bool) - Seleção inicial

5. Componente Select Lista suspensa para seleção de opções.

```

```

Parâmetros:

name (string) - Nome do campo

label (string) - Rótulo descritivo

options (array) - Array associativo de opções

placeholder (string) - Texto padrão

id (string) - Identificador do campo

6. Componente Table Tabela dinâmica com recursos avançados.

```

```

Parâmetros:

collection (Collection) - Coleção de dados

title (string) - Título da tabela

search (bool) - Ativar busca

selectable (bool) - Seleção de linhas

columns (array) - Colunas específicas

actionsTitle (string) - Título da coluna de ações

extraClass (string) - Classes CSS adicionais

7. Componente Textarea Área de texto para conteúdo extenso.

```

```

Parâmetros:

name (string) - Nome do campo

label (string) - Rótulo descritivo

placeholder (string) - Texto de placeholder

rows (int) - Número de linhas visíveis

8. Componente Upload Upload de arquivos com suporte a múltiplos arquivos.

```

```

Parâmetros:

label (string) - Rótulo descritivo

multiple (bool) - Upload múltiplo

9. Componente Card Cards para exibição de dados estruturados.

```
{{-- Card com array --}}

{{-- Card com objeto e avatar --}}

{{-- Card com modelo Eloquent --}}

```

Parâmetros:

data (array|object) - Dados a serem exibidos

title (string) - Título do card

withAvatar (bool) - Exibir avatar (para objetos com propriedade avatar)

withImage (bool) - Exibir imagem (para objetos com propriedade imagem)

actionButtons (array) - Botões de ação

routeBase (string) - Base para rotas CRUD

imageStyle (string) - Estilos CSS para imagem

🔧 Automação com Scaffold Comando de Scaffold Automático

```
php artisan make:scaffold create_users_table
```

Parâmetros de Relacionamento

```
php artisan make:scaffold create_posts_table --belongs-to=user --has-many=comments
```

Parâmetros disponíveis:

\--belongs-to - Relacionamento belongsTo

\--has-many - Relacionamento hasMany

\--has-one - Relacionamento hasOne

\--belongs-to-many - Relacionamento belongsToMany

O comando gera automaticamente: Model com relacionamentos e fillable attributes

Controller com métodos CRUD completos

Views utilizando componentes da biblioteca

Rotas RESTful no arquivo web.php

💡 Exemplos de Uso Exemplo Completo de Página

```
@php
    $configData = [
        'ID da Aplicação' => 'APP_12345',
        'Modo de Manutenção' => false,
        'Nível de Log' => 'debug',
        'URL do Banco' => 'mysql://user:pass@host:3306/db',
        'Última Verificação' => new DateTime('2025-09-29 10:00:00'),
    ];

    $userData = new stdClass();
    $userData->id = 101;
    $userData->name = 'Maria da Silva';
    $userData->position = 'Desenvolvedora Chefe';
    $userData->email = 'maria.silva@example.com';
    $userData->avatar = 'https://i.pravatar.cc/150?img=25';
    $userActions = [
        'Ver Perfil' => [
            'route' => 'produtos.show',
            'params' => 1
        ],
        'Enviar Mensagem' => 'https://google.com'
    ];
@endphp

    Exemplos de Componentes

    {{-- Cards --}}

    {{-- Formulários --}}

    {{-- Tabela --}}

```

Exemplo com Dados Customizados

```
@php
    $dados = [
        ['nome' => 'Produto A', 'preco' => 10],
        ['nome' => 'Produto B', 'preco' => 20],
    ];
    $collection = collect($dados);
@endphp

```

🎯 Personalização Adicionar Novo Sistema de Design Crie os arquivos de estilo em resources/css/themes/novo-tema.css

Crie os arquivos JavaScript em resources/js/themes/novo-tema.js

Atualize o vite.config.js

Crie as views dos componentes em resources/views/livewire/novo-tema/

Modificar Componentes Existentes Os componentes podem ser personalizados editando os arquivos em:

Lógica: app/Livewire/

Views: resources/views/livewire/\[tema\]/

📄 Licença Este projeto está licenciado sob a MIT License.

###  Health Score

38

—

LowBetter than 84% of packages

Maintenance75

Regular maintenance activity

Popularity10

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity50

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~1 days

Total

8

Last Release

183d ago

Major Versions

v1.0.4 → v2.0.02025-11-07

### Community

Maintainers

![](https://www.gravatar.com/avatar/4fca8fab12bea690382fc5aecc9f142fcd43865fe843d5992052ae563bdc112e?d=identicon)[forever-prata](/maintainers/forever-prata)

---

Top Contributors

[![forever-prata](https://avatars.githubusercontent.com/u/111141103?v=4)](https://github.com/forever-prata "forever-prata (34 commits)")

### Embed Badge

![Health badge](/badges/forever-prata-govbr-components-livewire/health.svg)

```
[![Health](https://phpackages.com/badges/forever-prata-govbr-components-livewire/health.svg)](https://phpackages.com/packages/forever-prata-govbr-components-livewire)
```

###  Alternatives

[livewire/flux

The official UI component library for Livewire.

9385.0M85](/packages/livewire-flux)[livewire/volt

An elegantly crafted functional API for Laravel Livewire.

4195.3M84](/packages/livewire-volt)[jantinnerezo/livewire-alert

This package provides a simple alert utilities for your livewire components.

8041.2M20](/packages/jantinnerezo-livewire-alert)[leandrocfe/filament-apex-charts

Apex Charts integration for Filament PHP.

4861.2M8](/packages/leandrocfe-filament-apex-charts)[spatie/laravel-livewire-wizard

Build wizards using Livewire

4061.0M4](/packages/spatie-laravel-livewire-wizard)[spatie/laravel-dashboard

A dashboard for Laravel

568156.1k94](/packages/spatie-laravel-dashboard)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)