README

🚀 Starter Kit minimalista para desenvolvimento Full-Stack com Laravel e Vue.

🚀 Começando

📋 Pré-requisitos

Antes de começar, garanta que você tenha as seguintes ferramentas instaladas:

PHP: ^8.4
Composer: ^2.8
Laravel Installer: ^5.14

✨ Dica: Você pode usar o php.new para configurar um ambiente de desenvolvimento PHP rapidamente.

🛠️ Instalação

Crie um novo projeto usando o laravel new:

laravel new seu-projeto --using=vitorkoch/clean-starter

Acesse o diretório do projeto:
```
cd seu-projeto
```
Instale as dependências (NPM e Composer):
```
npm install && composer install
```
Inicie o ambiente de desenvolvimento:
```
composer dev
```
Pronto! Agora é só abrir http://localhost:8000 no seu navegador. 🎉

O que vem no pacote? 📦

Este Starter Kit foca em código enxuto, sem todo o excesso de código que outros stater kits possuem, focando em ser apenas um quadro em branco para você iniciar novos projetos com foco em escalabilidade, segurança e developer experience.

Backend (Laravel) 🐘

Eloquent Otimizado: Modo estrito e eager loading automático para mais performance e menos bugs. 🏎️
Datas Imutáveis: CarbonImmutable por padrão para evitar dores de cabeça. 🗓️
Código Sempre no Padrão: Pint e Rector configurados para manter tudo limpo e moderno, sem esforço. 🧹
Controle de Acesso: Integração com spatie/laravel-permission pronta para usar. 🔒
Debug Simples e Poderoso: Com Clockwork você inspeciona a aplicação direto no navegador. 🐞
DTOs com Superpoderes: Use spatie/laravel-data para criar objetos de transferência de dados de forma simples e segura. 📦
Actions como Classes: Organize a lógica de negócio com lorisleiva/laravel-actions. 🏃‍♂️
IDE Helper: barryvdh/laravel-ide-helper para um autocomplete que funciona de verdade. 💡
Stubs Modernos: spatie/laravel-stubs para gerar arquivos no padrão mais atual. 📄
Tinker no Browser: spatie/laravel-web-tinker para rodar código na sua aplicação sem sair do navegador. 🕸️

Frontend (Vue.js) 🎨

Vue 3 + TypeScript: O melhor do Vue com a segurança da tipagem. 💪
Vite: Build tool super rápido para o seu frontend. ⚡
Inertia.js: Crie SPAs com a simplicidade do Laravel. 🔗
UI Incrível com shadcn-vue: Componentes lindos e acessíveis prontos para usar. 💅
Tailwind CSS: Estilização rápida e direto no markup. 💨
Ícones com Lucide: Uma vasta biblioteca de ícones à sua disposição. 🖼️
Código Organizado: ESLint e Prettier cuidam da formatação e da qualidade do seu código JS/TS. ✨

Documentação 📚

Consulte a documentação oficial de cada ferramenta para mais detalhes:

vitorkoch / clean-starter

Maintainers

Details