Ir para o conteúdo
Promovaweb

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
  1. Os quatro starter kits oficiais
  2. O código fica na sua aplicação
  3. O laravel-starter-kit da Promovaweb
  4. Como o projeto sai do kit

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 /.
As telas em React do laravel-starter-kit 0.2.0, em resources/js/pages, com a rota de cada uma segundo o README do kit.

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.

StayCloud

Uma VPS para desenvolver com agentes

Servidor da StayCloud em São Paulo, com acesso root e disco NVMe, para deixar seus agentes de IA rodando o dia todo.

Montar minha VPS

Link de parceiro da Promovaweb.