Starter kits: o projeto Laravel já com login e telas
Um starter kit é um projeto Laravel inicial que já traz as rotas, os controllers e as telas de cadastro, login e configurações do usuário. O instalador copia esse código para dentro da sua aplicação na criação do projeto, por isso cada tela fica no seu repositório e muda só quando você edita o arquivo.
Ficha e sumário da página
- Referência técnica
- Laravel 13.42.0
- Starter kit da Promovaweb
- laravel-starter-kit 0.2.0
- Revisão
- 13 de novembro de 2026
- Conteúdo
- Documentação oficial consultada
Os quatro starter kits oficiais
O instalador do Laravel, o comando laravel new, pergunta qual starter kit você quer usar ao criar a aplicação. A documentação do Laravel 13 descreve quatro opções oficiais. Os kits em React, Vue e Svelte usam o Inertia 3, que liga as rotas do Laravel às páginas do frontend sem uma API separada. O kit em Livewire monta as telas no servidor com componentes PHP.
- ReactInertia 3, React 19, TypeScript, Tailwind 4 e os componentes do shadcn/ui.
- VueInertia 3, Vue 3 com Composition API, TypeScript, Tailwind e shadcn-vue.
- SvelteInertia 3, Svelte 5, TypeScript, Tailwind e shadcn-svelte.
- LivewireLivewire 4, Tailwind e os componentes do Flux UI, sem frontend separado.
Todos usam o Laravel Fortify na autenticação. O Fortify registra as rotas e os controllers de login, cadastro, recuperação de senha e verificação de e-mail. Ele não tem interface própria, então as telas vêm do kit. A autenticação em dois fatores, com qualquer aplicativo compatível com TOTP, já vem ligada por padrão em config/fortify.php. Cada kit traz dois layouts para a área logada, um com barra lateral e outro com cabeçalho. As telas de login e cadastro têm três variações de layout.
A criação da aplicação também oferece o recurso de teams. Com ele, cada usuário pertence a um ou mais grupos e tem um grupo atual. No cadastro, o usuário novo recebe um grupo pessoal. As telas de criar grupos, trocar de grupo, convidar membros e editar os detalhes do grupo já vêm prontas.
O código fica na sua aplicação
O starter kit não é uma dependência instalada pelo Composer. O instalador copia o backend e o frontend do kit para dentro do seu projeto: os controllers ficam em app/, as páginas em resources/js/pages/ e as rotas em routes/. Depois da criação, uma versão nova do kit não altera a sua aplicação. Você altera uma tela de login como altera qualquer outro arquivo do projeto.
Essa cópia tem uma consequência prática nos kits com Inertia. Eles usam o Wayfinder, que gera funções TypeScript para as rotas no momento do build. Ao desligar um recurso do Fortify, como a verificação de e-mail, você também remove as referências às rotas dele no frontend. Sem essa limpeza, o build do frontend falha, porque a função da rota removida não é mais gerada.
O instalador aceita kits de fora da lista oficial. A documentação apresenta a opção --using com kits da comunidade publicados no Packagist, no formato autor/pacote. O instalador também aceita uma URL de repositório a partir da versão 5.18, conforme o README do kit da Promovaweb. Existe também uma variante dos kits oficiais com o WorkOS AuthKit no lugar do Fortify, para login social, passkeys e SSO pelo serviço da WorkOS.
O laravel-starter-kit da Promovaweb
O laravel-starter-kit é o template da Promovaweb sobre o kit oficial em React, publicado sob a licença MIT no repositório promovaweb/laravel-starter-kit. A versão de referência é a 0.2.0, com Laravel 13, React 19, Inertia 3, TypeScript e Tailwind CSS 4. O kit exige PHP 8.3 ou superior, Composer 2 e Node.js 22 ou superior. O banco padrão é o SQLite, trocado pelo DB_CONNECTION no .env.
O template traz as passkeys, com o suporte a WebAuthn do Fortify e o pacote @laravel/passkeys no frontend. Também traz os teams com papéis e as preferências de aparência. As telas ficam em pastas por área, com a autenticação, o painel do grupo atual, as configurações e os teams:
resources/js/pages/Páginas do Inertia, uma por tela.auth/Login, cadastro, recuperação de senha, verificação de e-mail e desafio de dois fatores.dashboard.tsxPainel do grupo atual, em /{current_team}/dashboard.settings/As telas profile.tsx, security.tsx e appearance.tsx cuidam do perfil, da segurança e do tema.teams/Lista de grupos, membros, convites e troca do grupo atual.welcome.tsxPágina inicial pública, na rota /.
Os teams do kit têm três papéis. O owner tem todas as permissões, inclusive excluir o grupo e gerenciar membros. O admin atualiza o grupo e cria ou cancela convites, enquanto o member participa sem permissões administrativas. Os convites saem por e-mail e valem por três dias. Uma tarefa agendada diária remove os convites expirados.
O kit também vem preparado para o trabalho com agentes de código. O .mcp.json registra o servidor MCP do Laravel Boost, que expõe ao agente a documentação do Laravel, o schema e a consulta ao banco. As skills do projeto vêm do Specsfy, o framework de especificação da Promovaweb. Elas ficam versionadas no próprio repositório do kit.
Como o projeto sai do kit
O kit é um template do GitHub. A criação passa pelo botão de template do repositório ou pelo instalador oficial, a partir da versão 5.18, com laravel new minha-app --using=https://github.com/promovaweb/laravel-starter-kit. Nesse caminho, o instalador baixa o código sem o histórico do Git e roda o composer install.
Depois disso, o comando composer setup copia o .env.example para .env, gera a chave da aplicação, roda as migrations e compila o frontend. O composer run dev sobe junto o servidor PHP, o worker da fila, os logs pelo Pail e o Vite. O último assunto do portal são os pacotes oficiais que entram depois, quando a aplicação precisa de API com token, login social ou cobrança, em Pacotes de primeira parte.