README

🇧🇷 Português · 🇺🇸 English

Starter kit Laravel 13 + Filament 5 pronto para uso. Um comando cria o projeto, instala tudo, migra, popula o banco e entrega três painéis funcionando: negócio, administração e infraestrutura.

composer create-project gsferro/starter-kit-easy meu-projeto
cd meu-projeto
composer dev

Não há passo manual: o create-project já cria o .env, gera a APP_KEY, cria o banco SQLite, roda as migrations, semeia papéis/permissões/usuário, publica os assets do Filament e faz o build do front-end. Ao final ele imprime as URLs e o login inicial.

Prefere clonar? O mesmo instalador roda sozinho:

git clone https://github.com/gsferro/filament-starter-kit-easy.git meu-projeto
cd meu-projeto && rm -rf .git && git init   # descarta o histórico do kit
composer setup

Acesso de demonstração

O seeder cria um usuário master que já entra nos três painéis:


Usuário	`admin@example.com`
Senha	`password`
Papel	`master_global` (vence qualquer permissão via `Gate::before`)

Entre por /app, /admin ou /infra — a mesma sessão vale para os três, e o menu do usuário troca de painel.

⚠️ Troque a senha antes de expor o ambiente. Para nascer com outra credencial, defina KIT_ADMIN_EMAIL, KIT_ADMIN_PASSWORD e KIT_ADMIN_NAME no .env antes de rodar a instalação (os valores ficam em config/kit.php). Num projeto já instalado, troque pelo próprio painel em /admin/users ou em Meu perfil.

Para testar o recorte de acesso, crie um usuário só com o papel admin ou infra: ele entra no painel correspondente e toma 403 no outro.

Os três painéis

Painel	URL	Para quê	Quem entra
App	`/app`	A operação do negócio. Vem vazio de propósito — é aqui que seu projeto nasce	qualquer usuário autenticado
Admin	`/admin`	Usuários, papéis e permissões (Shield), catálogo de agentes de IA, autoria de onboarding	`master_global`, `admin`
Infra	`/infra`	Health checks, backups, filas, logs, auditoria, caches, comandos, Pulse, custos de IA	`master_global`, `infra`

A regra de acesso fica em App\Models\User::canAccessPanel(). O papel master_global vence qualquer gate via Gate::before (App\Providers\KitServiceProvider) — não precisa de permissions no banco.

Separar admin de infra é o ponto do kit: quem administra usuários não precisa (nem deve) enxergar logs, filas e comandos operacionais, e vice-versa.

Como cada um se parece

Login	Administração

Auth Designer em duas colunas — troque a arte em `public/images/auth/login.svg`	Usuários, papéis, agentes de IA e indicadores de administração

Infraestrutura	Negócio

Saúde, filas, trilhas, comandos e custos de IA — agrupados em Observabilidade, IA, Trilhas e Sistema	Vazio de propósito: é onde o seu projeto nasce

Mais telas: saúde da aplicação · usuários · permissões (Shield) · catálogo de agentes de IA · central de comandos · busca ⌘K · acesso negado

O que já vem pronto

Administração e segurança

Shield (papéis e permissões com UI) sobre spatie/laravel-permission
Breezy: perfil do usuário, avatar, 2FA e passkeys
Auth Designer: tela de login em duas colunas (troque a arte em public/images/auth/login.svg)
Lockscreen: bloqueio de sessão por inatividade (30 min), registrado nos 3 painéis
Impersonate, log de autenticação, auditoria de alterações (owen-it)
Panel Switch: troca de painel pelo menu do usuário

Observabilidade e manutenção (painel infra)

Spatie Health com checks de banco, cache, filas, agendador, disco, debug mode e IA local
Backup Monitor (spatie/laravel-backup), Jobs Monitor, Logs Explorer (sem botão de apagar — trilha é evidência)
Command Center: comandos Artisan pré-aprovados pela UI, com histórico
Laravel Pulse embutido como página do painel
Dependency Graph: mapa de models, relações, resources e painéis
Release Notifier: avisa quando há versão nova dos pacotes Composer

IA (opcional, local por padrão)

laravel/ai com catálogo de agentes no banco: system prompt, provider, modelo, tools e guardrails são dados, editáveis no /admin sem deploy
Guardrails encadeados: budget, prompt injection, classificador local, redação de PII e filtro de saída sensível
Ledger de execuções (ai_runs) com custo e tokens no painel infra
Widget de chat com streaming
Inferência 100% local via llama.cpp (docker compose --profile ai up -d) ou qualquer provider SaaS trocando AI_PROVIDER

Produtividade

Busca ⌘K no lugar do campo nativo da topbar: encontra registros, telas, páginas e ações de criação — tudo recortado por permissão (detalhes abaixo)
Badges de contagem animados no menu, centro de notificações com abas, indicador de ambiente
Dashboards já preenchidos nos painéis admin e infra: 20 widgets (stat cards com contador animado, funis, metas, breakdowns, timelines) sobre os dados que os painéis já têm — nada de tela vazia esperando você
Páginas de erro brandadas (Sentinel) em pt-BR — a de 403 só mostra o diagnóstico de permissão fora de produção
UI 100% em pt-BR, inclusive nos plugins que só trazem inglês (traduções em lang/vendor/)

A busca ⌘K

O campo na topbar é o nativo do Filament — mesma marcação, mesma aparência, mesmo Ctrl/⌘+K. O que muda é o que acontece ao clicar: em vez de digitar ali, abre o overlay do Spotlight, que busca em quatro frentes:

Categoria	O que encontra
Registros	a busca global nativa do Filament (respeita `getGloballySearchableAttributes()` dos seus resources)
Telas	os resources do painel, filtrados por `canAccess()`
Páginas	as páginas do painel, também por `canAccess()`
Ações	"Criar X" para cada resource, com `canAccess()` + `canCreate()` + `shouldRegisterNavigation()`

O filtro por permissão é a razão de existirem App\Filament\Spotlight\* no kit: as categorias do pacote não chamam canAccess(), e sem isso a busca oferece telas que resultariam em 403 — vazamento de affordance. As sugestões "Criar X" também são do kit (AcoesDeCriacao), pelo mesmo motivo e mais um: o discovery do pacote resolve URLs sem checar contexto e derruba a tela de login com 500.

Trabalhando com agentes de IA

O kit já vem preparado para você desenvolver com um agente de código (Claude Code, Codex, Cursor, Junie, OpenCode) — e, mais importante, com a documentação que o agente precisa ler para não reinventar nem quebrar o que já está pronto.

📚 `wikis/` — a documentação do kit

wikis/README.md é o ponto de entrada. É onde mora tudo que um agente (ou uma pessoa nova no time) precisa saber antes da primeira linha de código:

Documento	O que responde
`wikis/arquitetura.md`	três painéis, a "cola" do kit, ciclo de um request, os três níveis de autorização
`wikis/convencoes.md`	as regras inegociáveis e as armadilhas já resolvidas — o documento que evita o "conserto" que quebra
`wikis/ia.md`	agente como dado, guardrails fail-closed, ledger de execuções
`wikis/receitas.md`	passo a passo: Resource, página, widget, health check, comando, agente
`wikis/agentes-e-skills.md`	Boost, MCP, as skills instaladas e o trio de execução
`wikis/pacotes.md`	qual pacote é dono de qual tela — para não reimplementar vendor

É também a pasta onde você escreve o que for do seu projeto: wikis/specs/{branch}/{feature}/ recebe uma pasta por feature, criada pela skill abaixo.

As skills instaladas

O Laravel Boost está configurado (boost.json) para cinco agentes, com servidor MCP (php artisan boost:mcp) e nove skills sincronizadas — entre elas laravel-best-practices, pest-testing, ai-sdk-development, tailwindcss-development, pulse-development, laravel-backup e blaze-optimize.

A que muda o fluxo de trabalho é a feature-wiki: invocada antes de implementar qualquer feature, ela cria wikis/specs/{branch}/{feature}/ com plano de ação (PRD), decisões arquiteturais (ADR), progresso e casos de teste — além de fixar o padrão de log do projeto.

💡 Feature nova? Chame /feature-wiki. É o primeiro passo, antes de qualquer php artisan make:*. A skill pesquisa o código, escreve o plano e só então começa a implementação. Para typo, ajuste de config, refactor puro ou bump de dependência, pule — ela mesma diz quando não vale a pena.

No Claude Code ela trabalha com dois plugins já habilitados em .claude/settings.json, cada um cobrindo uma camada diferente:

Camada	Ferramenta	Papel
Comunicação	Caveman	resposta enxuta — não se aplica a wiki, código, commits e avisos de segurança
Planejamento	feature-wiki	PRD + ADR + casos de teste + tracking
Execução	Ponytail	mínimo código que funciona — sem cortar validação, segurança ou tratamento de erro

php artisan boost:add-skill gsferro/laravel-ai-skills   # a skill
php artisan boost:update                                # sincroniza para todos os agentes

AGENTS.md e CLAUDE.md são gerados pelo Boost — editar à mão é trabalho perdido no próximo boost:update. Regra durável vai em .ai/rules (ferramenta record-rule) ou na wikis/.

Requisitos

PHP 8.3+ e Composer 2
Node 20+ (opcional — sem ele a instalação segue e avisa como fazer o build depois)
Docker (opcional — só para Postgres, Redis, IA local e e-mail)

Banco de dados

O kit instala com SQLite para não depender de nada. Para Postgres, suba os containers e copie as variáveis:

docker compose up -d              # pgsql (com pgvector) + redis
# copie o bloco de banco de .env.docker para o seu .env
php artisan migrate --seed

Docker

Tudo é opt-in por profile. Um container por feature:

docker compose up -d                            # pgsql + redis
docker compose --profile ai up -d               # + llama.cpp (chat e embeddings)
docker compose --profile mail up -d             # + mailpit (1025 / 8025)
docker compose --profile full up -d             # infra completa
docker compose --profile app up -d --build      # a aplicação containerizada
docker compose --profile realtime up -d reverb pulse

Serviço	Porta	Profile
PostgreSQL 17 + pgvector	5432	base
Redis 7 (só cache)	6379	base
llama.cpp (chat)	8080	`ai`
llama.cpp (embeddings)	8081	`ai`
Mailpit	1025 / 8025	`mail`
App (nginx + php-fpm)	8000	`app`
Reverb (WebSocket)	8090	`app`, `realtime`

O Reverb usa 8090 e não o default 8080 para não colidir com o llama.cpp.

Comandos

composer dev          # servidor + fila + vite juntos
composer test         # pint + phpstan + a suíte inteira
composer test:kit     # só os testes do kit (a fundação)
composer lint         # formata o código
php artisan kit:install --force   # reinstala do zero (apaga o SQLite)
php artisan kit:update            # traz melhorias de uma versão nova do kit

Os testes do kit

O kit traz sua própria suíte, isolada em tests/Kit/ — acesso aos três painéis, telas de infra e admin de pé, invariantes da fundação (uuid, gates, auditoria) e o contrato da camada de IA.

Ela fica separada da sua de propósito: depois de um kit:update você quer saber se a fundação continua íntegra, sem esperar a suíte do seu negócio.

composer test:kit                     # atalho
php artisan test --testsuite=Kit      # equivalente
php artisan test --group=kit          # mesma coisa, por grupo do Pest
php artisan test --testsuite=Feature  # só os SEUS testes

Seus testes vão em tests/Feature e tests/Unit, como de costume — o kit não encosta neles.

Personalize seu projeto

Nome — APP_NAME no .env
Arte do login — public/images/auth/login.svg
Cores — ->colors([...]) em cada app/Providers/Filament/*PanelProvider.php
Acesso aos painéis — App\Models\User::canAccessPanel()
Matriz de permissões — database/seeders/PapeisSeeder.php
Health checks — KitServiceProvider::configureHealthChecks()
Comandos da UI — config/command-center.php
Credenciais do seeder — KIT_ADMIN_EMAIL / KIT_ADMIN_PASSWORD no .env
Backups — destino e agenda em config/backup.php
Agente de IA — /admin → Agentes de IA (ou database/seeders/AssistenteSeeder.php)

Configuração global do Filament

Um único arquivo define como toda tabela, toggle, modal e coluna do projeto se comporta: app/Providers/Concerns/ConfiguraFilamentGlobal.php (aplicado pelo KitServiceProvider). Mudou ali, mudou em todo lugar — inclusive nas telas dos plugins de terceiros, que você não conseguiria editar de outro jeito.

Toda tabela nasce com:

Comportamento	Por quê
`deferLoading()`	a tela aparece antes da query terminar
`striped()` + `stackedOnMobile()`	leitura em lista no desktop, cartão no celular
`persistFilters/Search/Sort/ColumnSearchesInSession()`	o recorte do usuário sobrevive à navegação
`reorderableColumns()` + `dragReorderableColumns()` + `stickableColumns()`	colunas reordenáveis, arrastáveis e fixáveis
colunas redimensionáveis (`asmit/resized-column`)	largura ajustável pelo usuário, preservada na sessão
`filtersLayout(Modal)` + `filtersFormColumns(2)` + `deferFilters()`	com 3+ filtros o dropdown vira rolagem; o modal não
`defaultPaginationPageOption(10)` + `extremePaginationLinks()`	paginação previsível, com atalhos de primeira/última
`deselectAllRecordsWhenFiltered(false)`	filtrar não descarta a seleção

Também são globais: modal que não fecha no Esc (um toque acidental descartaria o formulário), toggles com cor e ícone de estado, coluna de ícone booleana com check/x colorido, CreateAction com ícone padrão e o alternador de painéis.

Colunas redimensionáveis em telas novas: o comportamento padrão já vale para qualquer tabela; para que a largura escolhida seja lembrada, a página de listagem precisa do trait:
use Asmit\ResizedColumn\HasResizableColumn;

class ListProdutos extends ListRecords
{
    use HasResizableColumn;
}

📌 TODO: transformar esses defaults num Settings em /admin, para que paginação, densidade, persistência de filtros e colunas redimensionáveis virem preferência do projeto pela interface, sem editar código. O filament/spatie-laravel-settings-plugin já está instalado para isso.

Convenções do kit

UUID nas rotas, id int como PK. Toda tabela nova ganha $table->uuid('uuid')->unique() e o model usa App\Traits\TemUuid. URL com id numérico devolve 404 e ninguém enumera registros por sequência. UUID não é autorização — policies continuam obrigatórias.
Auditoria no que é editável. App\Traits\AuditsFillables audita exatamente o $fillable, sem vazar colunas técnicas para a trilha.
Seeder nunca usa factory nem faker. fakerphp/faker é require-dev e a imagem Docker roda --no-dev.
Permissões vêm de seeder, não de shield:generate interativo — é o que permite instalar sem intervenção. Depois de criar Resources novos, rode php artisan db:seed --class=Database\\Seeders\\ShieldPermissionsSeeder.
Nada de affordance sem permissão. Menu, busca e ações consultam canAccess()/canCreate() antes de aparecer. Encontrar algo que resulta em 403 é considerado bug.
Tradução de plugin vai em lang/vendor/. Vários pacotes só trazem inglês; o kit traduz sem tocar no vendor.

Armadilhas já resolvidas

Coisas que custaram tempo para descobrir e que o kit já entrega prontas — se você mexer nelas, saiba o porquê:

Onde	O quê
Lockscreen	precisa estar registrado nos três painéis: o `routes/web.php` do pacote resolve o plugin pelo painel corrente e estoura `LogicException` em todo request — até `artisan package:discover` morre
Command Center	sem `->cluster()`: com cluster a página raiz devolve 500
`databaseNotifications()`	declarado depois de `plugins()`, senão o Notification Center apaga o recorte, sem erro nenhum
Dependency Graph	`canAccessUsing()` substitui a regra local-only do pacote (sem ele, 404 em homologação)
Logs Explorer	`deletable(false)`: o delete do pacote faz `@unlink()` sem gravar rastro
Ações de filtro	fora do `configureUsing()` global: em tabela sem filtro a ação nasce sem nome e derruba a página
Pulse + resized-column	os dois bundles declaram constantes no escopo global; carregados como ES module para o segundo não morrer calado
Busca ⌘K	gatilho no hook `GLOBAL_SEARCH_BEFORE` (o `USER_MENU_BEFORE` renderiza dentro do dropdown) e overlay aberto em `setTimeout`, senão o próprio clique fecha o painel

Depois de criar seus Resources

php artisan make:filament-resource Produto --panel=app
php artisan db:seed --class=Database\\Seeders\\ShieldPermissionsSeeder
php artisan db:seed --class=Database\\Seeders\\PapeisSeeder

Adicione os dois traits do kit ao que foi gerado:

// No Resource — badge de contagem animado no menu:
use App\Filament\Concerns\BadgeContagemNavegacao;

class ProdutoResource extends Resource
{
    use BadgeContagemNavegacao;
}

// Na List page — lembra a largura das colunas escolhida pelo usuário:
use Asmit\ResizedColumn\HasResizableColumn;

class ListProdutos extends ListRecords
{
    use HasResizableColumn;
}

Badges de contagem

Todos os Resources do kit já têm badge no menu (Usuários, Agentes de IA, Execuções de IA). A contagem sai de getEloquentQuery(), nunca de Model::count(): a query do resource carrega os escopos que valem para aquele painel, e contar direto no model mostraria um número que a listagem não confirma. Zero não vira badge — um "0" cinza em todo item só polui.

Resources de plugins de terceiros (Auditoria, Logins, Filas, Pacotes do Composer, Comandos, Funções do Shield, Onboarding) ficam sem badge: getNavigationBadge() é um método estático do resource, e o Filament não oferece API para sobrescrevê-lo de fora — a ResourceConfiguration do painel só permite trocar o slug. Dar badge a eles exigiria estender cada resource de vendor e impedir o plugin de registrar o seu, o que quebra a cada atualização do pacote. Se algum for importante no seu projeto, o caminho é esse — resource por resource, conscientemente.

Atualizando um projeto que já nasceu do kit

O kit é um ponto de partida, não uma dependência. Depois do create-project o projeto é seu: você renomeia painéis, muda canAccessPanel(), edita seeders. Por isso não existe um kit:update que sobrescreve arquivos — ele reescreveria justamente o que você personalizou, e um starter kit que estraga o projeto do usuário não serve para nada.

O que muda separa-se em três camadas, e cada uma tem um caminho próprio:

Camada	O que é	Como atualizar
Dependências	Filament, plugins, Laravel	`composer update` — é a maior parte das melhorias e chega sozinha
Cola do kit	providers, traits, widgets, views de erro	diff manual contra a tag nova (abaixo)
Seu negócio	tudo que você escreveu	nunca é tocado

O jeito fácil: `php artisan kit:update`

O comando automatiza a etapa do git inteira e não aplica nada sem sua aprovação:

php artisan kit:update --dry-run   # só mostra o que mudou
php artisan kit:update             # revisa e aplica, arquivo a arquivo

O que ele faz, em ordem:

Confere o terreno — exige repositório git com a árvore limpa. Sem isso não haveria como reverter, e ele recusa rodar (mostrando os comandos para versionar o projeto).
Vincula o kit temporariamente — adiciona o remote kit com push bloqueado e busca as tags num namespace próprio (kit-v*), para não colidirem com as versões do seu projeto.
Compara — da versão em config('kit.version') até a tag escolhida, restrito aos caminhos que pertencem ao kit. Seu código de negócio nunca entra na conta.
Oferece um branch temporário (kit-update/v0.2.0) para não sujar o seu.
Pergunta arquivo a arquivo — ver o diff, aplicar, pular ou parar. Dá para mudar de ideia no meio e aplicar o resto em lote. Arquivo removido do kit nunca é apagado automaticamente: ele só avisa.
Desfaz o vínculo — remove o remote e as tags kit-* ao sair, mesmo se você interromper no meio. O projeto não fica com nada de terceiros pendurado.
Marca a versão aplicada em config/kit.php — só aquela linha, sem tocar no resto do arquivo. É o ponto de partida da próxima comparação.

Dois detalhes que aparecem na prática:

config/kit.php sempre consta como "modificado" (ele carrega a marca de versão). Aplicá-lo traz as chaves novas do kit, mas substitui o arquivo inteiro — se você mudou credenciais do seeder ou adicionou chaves próprias ali, veja o diff e copie só o que interessa em vez de aplicar.
O próprio kit:update se atualiza. Como o PHP já carregou a classe em memória, o comportamento novo (e as mensagens novas) só valem a partir da execução seguinte. O comando avisa quando isso acontece.

Ao final nada está commitado: você revisa com git diff, roda composer test:kit (a fundação) e commita. Deu errado? git checkout -- . desfaz, ou apague o branch e volte para o seu.

Não precisa aprovar 30 arquivos um a um. Durante a revisão, o menu oferece "Aplicar todos os arquivos NOVOS daqui em diante" e "Aplicar TUDO daqui em diante" — uma confirmação vale para o conjunto. E dá para começar já em lote:

php artisan kit:update --only-new   # só o que ainda não existe no projeto
php artisan kit:update --all        # tudo, inclusive o que sobrescreve

A distinção é o ponto: arquivo novo não tem o que sobrescrever, então aplicá-los em massa é seguro — é o caso dos widgets, do Spotlight e das concerns. Já um modificado substitui o conteúdo atual, e se você editou aquele arquivo a sua versão se perde (recuperável com git checkout -- <arquivo>, já que nada é commitado). Por isso --only-new é o lote recomendado para a primeira passada, deixando os modificados para revisar com calma.

Opção	Para quê
`--only-new`	aplica de uma vez só os arquivos novos (não sobrescreve nada)
`--all`	aplica tudo de uma vez, com uma confirmação para o conjunto
`--dry-run`	só o relatório, não altera nada
`--tag=v0.3.0`	comparar com uma versão específica
`--from=v0.1.0`	dizer de qual versão o projeto partiu (quando `config/kit.php` não sabe)
`--branch=nome`	escolher o nome do branch temporário
`--no-branch`	aplicar no branch atual
`--keep-remote`	manter o remote e as tags do kit ao final

Sem terminal (CI, --no-interaction) o comando vira relatório e não altera nada — a menos que você passe --only-new ou --all, que são a aprovação, dada na linha de comando.

O jeito manual

Se preferir controlar cada passo — ou entender o que o comando faz por baixo:

Adicione o kit como um segundo remote, uma única vez. Seu origin continua sendo o seu projeto; o kit é só uma fonte de leitura:

git remote add kit https://github.com/gsferro/filament-starter-kit-easy.git

# o remote do kit é somente-leitura: evita um `git push kit main` acidental
# mandar o SEU projeto para dentro do repositório do kit
git remote set-url --push kit no_push

As tags do kit vão para um namespace próprio (kit-v*). Isso importa: um git fetch kit --tags traria v0.1.0, v0.2.0… para o seu projeto e colidiria com as suas versões depois.

git fetch --no-tags kit 'refs/tags/*:refs/tags/kit-*'
git tag -l 'kit-*'      # kit-v0.1.0, kit-v0.2.0, ...

Depois, a cada versão, veja o que mudou e traga só o que interessa:

# 1. panorama entre a sua versão e a nova
git diff kit-v0.1.0..kit-v0.2.0 --stat

# 2. o diff da "cola" do kit (ignore o que você já reescreveu)
git diff kit-v0.1.0..kit-v0.2.0 -- app/Providers app/Filament/Concerns \
        app/Filament/Spotlight app/Traits resources/views/errors config/kit.php

# 3. traga arquivo a arquivo, revisando
git checkout kit-v0.2.0 -- resources/views/errors
git checkout kit-v0.2.0 -- app/Filament/Concerns/BadgeContagemNavegacao.php

Faça isso num branch (git switch -c atualiza-kit) e rode composer test antes do merge. Arquivos que você reescreveu: leia o diff e aplique à mão — é o único caminho seguro.

💡 TODO / rumo do projeto: extrair a "cola" para um pacote Composer próprio (gsferro/kit-core) com os providers, traits, widgets e páginas de infra. Aí a camada do meio vira composer update gsferro/kit-core e o skeleton fica mínimo — só o que é mesmo ponto de partida. É a evolução natural deste kit.

Solução de problemas

/infra ou /admin dando 403 — seu usuário precisa do papel master_global, admin ou infra. A tela de 403 mostra qual permissão faltou, mas só fora de produção: em produção ela não revela papéis nem permissões.
Assets do Filament sumidos — php artisan filament:assets.
Pulse sem dados — falta o daemon: php artisan pulse:check (ou o serviço pulse do compose).
Sininho não atualiza em tempo real — BROADCAST_CONNECTION=reverb exige o processo Reverb no ar; sem ele o kit cai para polling de 30s.
Assistente de IA indisponível — suba docker compose --profile ai up -d (o primeiro boot baixa ~4,5 GB de modelo) ou troque AI_PROVIDER para um provider SaaS com API key.

Pacotes instalados

Tudo abaixo já vem instalado, publicado e registrado nos painéis — não existe passo de "agora instale o plugin X". A fonte da verdade das versões é o composer.json; a tabela diz para que serve cada um dentro do kit.

Base

Pacote	Para quê
laravel/framework	o framework
filament/filament	os painéis, tabelas, formulários e widgets
laravel/tinker	REPL do Laravel
livewire/blaze	otimiza componentes Blade dobrando-os no template pai

Administração e segurança

Pacote	Para quê
bezhansalleh/filament-shield	papéis e permissões com UI, sobre spatie/laravel-permission
jeffgreco13/filament-breezy	perfil do usuário, avatar, 2FA e passkeys
caresome/filament-auth-designer	tela de login em duas colunas
marjose123/filament-lockscreen	bloqueio de sessão por inatividade, sem deslogar
stechstudio/filament-impersonate	entrar como outro usuário
tapp/filament-authentication-log	histórico de logins, IP e dispositivo
owen-it/laravel-auditing	trilha de alterações dos models
tapp/filament-auditing	a tela dessa trilha no painel
syriable/filament-activitylog	log de atividades (spatie/laravel-activitylog) no Filament
bezhansalleh/filament-panel-switch	troca de painel pelo menu do usuário

Observabilidade e manutenção

Pacote	Para quê
shuvroroy/filament-spatie-laravel-health	health checks (banco, cache, filas, agendador, disco, IA)
spatie/laravel-backup	backup da aplicação e do banco
brimham/filament-backup-monitor	histórico e saúde dos backups por destino
croustibat/filament-jobs-monitor	monitor de filas para qualquer driver
laboiteacode/filament-logs-explorer	leitura e busca nos logs sem sair do painel
ssbityukov/filament-command-center	comandos Artisan pré-aprovados pela UI, com histórico
laravel/pulse	performance e uso da aplicação em tempo real
dotswan/filament-laravel-pulse	o Pulse embutido como página do painel
laboiteacode/filament-dependency-graph	mapa visual de models, relações, resources e painéis
mominalzaraa/filament-composer-release-notifier	avisa quando há versão nova dos pacotes Composer
cms-multi/filament-clear-cache	limpar caches pelo painel

IA

Pacote	Para quê
laravel/ai	o SDK oficial de IA do Laravel (agentes, tools, streaming)
fomvasss/laravel-ai-tasks	orquestração das tarefas de IA: roteamento, fila, auditoria e budget

UI e produtividade

Pacote	Para quê
wezlo/filament-search-spotlight	o overlay da busca ⌘K
prodstarter/filament-notification-center	centro de notificações com abas e categorias
pxlrbt/filament-environment-indicator	indicador de ambiente (local, homologação, produção)
gsferro/filament-odometer-easy	contadores animados em tabelas, infolists, stats e badges
gsferro/odometer-easy	a base do odometer fora do Filament
gsferro/filament-stat-plus-easy	stat cards com ícone de canto, borda colorida e skeleton
awcodes/filament-badgeable-column	badges dentro de colunas de tabela
asmit/resized-column	colunas redimensionáveis pelo usuário
laboiteacode/filament-dashboard-widgets	widgets prontos de métrica, meta, breakdown e tendência
mddev31/filament-dynamic-dashboard	dashboard configurável pelo usuário: arrastar e redimensionar widgets
lara-zeus/progress	barras de progresso em colunas e entries
wallacemartinss/filament-onboarding	checklists e tours guiados, com autoria no `/admin`
anselmokossa/filament-sentinel	páginas de erro (403, 404, 419, 500, 503) com a cara do painel
flowframe/laravel-trend	agregação por período para os gráficos dos widgets

Dados e serviços

Pacote	Para quê
filament/spatie-laravel-settings-plugin	páginas de configuração no painel
spatie/laravel-settings	as configurações persistidas por trás delas
mike-bronner/laravel-model-caching	cache automático de queries do Eloquent
predis/predis	cliente Redis em PHP puro (sem extensão)
laravel/reverb	WebSocket para as notificações em tempo real

Motores por baixo dos plugins, instalados como dependência (você não os declara, mas eles são o que de fato roda): spatie/laravel-permission (Shield), spatie/laravel-health (os checks), spatie/laravel-activitylog (o log de atividades) e livewire/livewire (o Filament inteiro).

Desenvolvimento (`require-dev`)

Pacote	Para quê
pestphp/pest + pest-plugin-laravel	a suíte de testes
phpunit/phpunit	o motor por baixo do Pest
larastan/larastan	análise estática (`composer types:check`)
laravel/pint	formatação (`composer lint`)
laravel-lang/common	traduções pt-BR do Laravel
laravel/pail	logs em tempo real no terminal
laravel/pao	ferramentas de desenvolvimento do Laravel
nunomaduro/collision	erros legíveis no terminal
mockery/mockery	mocks nos testes
fakerphp/faker	dados falsos só em teste — seeder do kit nunca usa

Front-end (`package.json`)

Pacote	Para quê
vite + laravel-vite-plugin	o build dos assets
tailwindcss + @tailwindcss/vite	o CSS (v4, sem arquivo de config)
concurrently	roda servidor, fila e vite juntos no `composer dev`
@laravel/multiplex	agrupa requests do Livewire (opcional)

Licença

MIT.

gsferro / starter-kit-easy

Maintainers

Package info

Statistics

Security

README

Acesso de demonstração

Os três painéis

Como cada um se parece

O que já vem pronto

A busca ⌘K

Trabalhando com agentes de IA

📚 `wikis/` — a documentação do kit

As skills instaladas

Requisitos

Banco de dados

Docker

Comandos

Os testes do kit

Personalize seu projeto

Configuração global do Filament

Convenções do kit

Armadilhas já resolvidas

Depois de criar seus Resources

Badges de contagem

Atualizando um projeto que já nasceu do kit

O jeito fácil: `php artisan kit:update`

O jeito manual

Solução de problemas

Pacotes instalados

Base

Administração e segurança

Observabilidade e manutenção

IA

UI e produtividade

Dados e serviços

Desenvolvimento (`require-dev`)

Front-end (`package.json`)

Licença

gsferro / starter-kit-easy

Maintainers

Package info

Statistics

Security

README

Acesso de demonstração

Os três painéis

Como cada um se parece

O que já vem pronto

A busca ⌘K

Trabalhando com agentes de IA

📚 wikis/ — a documentação do kit

As skills instaladas

Requisitos

Banco de dados

Docker

Comandos

Os testes do kit

Personalize seu projeto

Configuração global do Filament

Convenções do kit

Armadilhas já resolvidas

Depois de criar seus Resources

Badges de contagem

Atualizando um projeto que já nasceu do kit

O jeito fácil: php artisan kit:update

O jeito manual

Solução de problemas

Pacotes instalados

Base

Administração e segurança

Observabilidade e manutenção

IA

UI e produtividade

Dados e serviços

Desenvolvimento (require-dev)

Front-end (package.json)

Licença

📚 `wikis/` — a documentação do kit

O jeito fácil: `php artisan kit:update`

Desenvolvimento (`require-dev`)

Front-end (`package.json`)