README

Pacote Laravel que injeta automaticamente TailwindCSS e SweetAlert2 em toda resposta HTML. Instale com um comando. Sem configuração. Sem build tools. Funciona na hora.

🎯 O que torna esse pacote único?

Diferente de outras soluções, este pacote resolve dois problemas ao mesmo tempo com zero configuração:

Comparação	Abordagem tradicional	Este pacote
TailwindCSS	Instalar Node.js, NPM, Vite, configurar `tailwind.config.js`, compilar	`composer require` e pronto
SweetAlert2	Instalar via NPM/CDN, criar JS customizado, integrar com Livewire manualmente	Macros `$this->alert()` e `$this->confirm()` já disponíveis
Configuração	Editar layouts, adicionar `@vite`, `<link>`, `<script>`	Nenhuma — tudo é injetado automaticamente
Dependências	Node.js + NPM + Vite + PostCSS	Apenas Composer
Deploy	Pipeline de build para CSS/JS	Sem build — assets vêm prontos no `vendor/`

💡 Ideal para

Projetos TALL Stack (Tailwind + Alpine.js + Laravel + Livewire) que querem começar rápido
Equipes que preferem não gerenciar Node.js/NPM no servidor
Pacotes Laravel que precisam de Tailwind sem afetar o projeto host
Prototipagem rápida — monte um CRUD completo com alertas em minutos

✨ Funcionalidades

🎨 TailwindCSS Built-in

TailwindCSS v2.2 completo, pronto para usar
Injetado via <link> com cache de 1 ano (não impacta performance)
Todas as classes utilitárias disponíveis sem compilação

🔔 SweetAlert2 Integrado ao Livewire

Macros $this->alert() e $this->confirm() em qualquer componente
Confirmações com callback automático — chama o método Livewire ao confirmar
Totalmente customizável via opções do SweetAlert2
5 tipos de alerta: success · error · warning · info · question

⚡ Performance Otimizada

Assets servidos via rotas HTTP com Cache-Control: immutable
Browser baixa CSS/JS uma única vez e cacheia por 1 ano
Páginas subsequentes carregam em milissegundos

🔒 Zero Configuração

Middleware global auto-registrado
Sem editar layouts, sem adicionar tags, sem tocar em nenhum arquivo
Laravel Package Discovery cuida de tudo

🚀 Instalação

composer require samuelpereiramachado/tailwindcss-sweetalert

É só isso. Não precisa publicar configs, rodar migrations, nem editar nenhum arquivo.

🔧 Uso

Alertas simples

Em qualquer componente Livewire:

// Sucesso
$this->alert('Salvo!', 'Registro criado com sucesso.', 'success');

// Erro
$this->alert('Erro!', 'Não foi possível salvar.', 'error');

// Aviso com timer
$this->alert('Aviso', 'Sessão expira em breve.', 'warning', [
    'timer' => 3000,
    'showConfirmButton' => false,
]);

Confirmação com callback

// Pedir confirmação antes de executar
$this->confirm(
    title: 'Tem certeza?',
    action: ['method' => 'delete', 'params' => $id],
    message: 'Esta ação não pode ser desfeita.',
    type: 'warning'
);

// Método chamado automaticamente ao confirmar
public function delete($id)
{
    Model::findOrFail($id)->delete();
    $this->alert('Excluído!', 'Registro removido.', 'success');
}

Exemplo completo em um Livewire Component

class Usuarios extends Component
{
    public function criar()
    {
        User::create($this->form);
        $this->alert('Sucesso!', 'Usuário criado.', 'success');
    }

    public function confirmarExclusao($id)
    {
        $this->confirm(
            'Excluir usuário?',
            ['method' => 'excluir', 'params' => $id],
            'Todos os dados serão perdidos.',
            'warning'
        );
    }

    public function excluir($id)
    {
        User::findOrFail($id)->delete();
        $this->alert('Excluído!', 'Usuário removido.', 'success');
    }
}

⚙️ Como funciona por baixo

composer require → Laravel auto-registra o ServiceProvider
                          ↓
              ServiceProvider registra:
              ├── Rotas: /tailwindcss-sweetalert/css e /js
              ├── Middleware global: InjectAssets
              └── Macros Livewire: alert() e confirm()
                          ↓
              A cada request HTML:
              ├── Middleware injeta <link> antes de </head>
              └── Middleware injeta <script> antes de </body>
                          ↓
              Browser cacheia CSS/JS por 1 ano ✅

🏗️ Estrutura do pacote

├── composer.json
├── resources/
│   ├── css/tailwind.css                  # TailwindCSS v2.2 compilado
│   └── js/sweetalert2.all.min.js         # SweetAlert2 bundled
└── src/
    ├── TailwindcssSweetalertServiceProvider.php
    └── Http/
        ├── Controllers/
        │   └── AssetController.php       # Serve assets com cache 1 ano
        └── Middleware/
            └── InjectAssets.php          # Auto-injeta <link> e <script>

📋 Requisitos

Dependência	Versão
PHP	>= 8.1
Laravel	10, 11 ou 12
Livewire	>= 3.0

📄 Licença

MIT — veja LICENSE para detalhes.

Autor: Samuel Pereira Machado

samuelpereiramachado / tailwindcss-sweetalert

Maintainers

Package info

Statistics

Security