mateusotabe/brelue

Esqueleto Laravel + Inertia/Vue limpo, dockerizado e localizado para o Brasil (pt-BR).

v1.0.5 2026-05-19 23:25 UTC

Requires

• php: ^8.3
• inertiajs/inertia-laravel: ^3.0
• laravel/chisel: ^0.1.0
• laravel/fortify: ^1.37.2
• laravel/framework: ^13.7
• laravel/tinker: ^3.0
• laravel/wayfinder: ^0.1.14

Requires (Dev)

• fakerphp/faker: ^1.24
• laravel/boost: ^2.2
• laravel/pail: ^1.2.5
• laravel/pao: ^1.0.6
• laravel/pint: ^1.27
• laravel/sail: ^1.53
• mockery/mockery: ^1.6
• nunomaduro/collision: ^8.9.3
• pestphp/pest: ^4.7
• pestphp/pest-plugin-laravel: ^4.1

MIT

• laravel
• brazil
• docker
• starter-kit
• vue
• inertia
• pt-BR

README

Esqueleto Laravel 13 + Inertia/Vue 3 limpo, dockerizado e localizado para o Brasil (pt-BR), pronto para iniciar novos projetos.

PHP 8.5 · Nginx · PostgreSQL 16 · Vite · pnpm

✨ O que já vem configurado

• Localização pt-BR — APP_LOCALE=pt_BR, APP_TIMEZONE=America/Sao_Paulo, faker pt-BR e traduções em lang/pt_BR/ (validação, auth, senhas, paginação) + lang/pt_BR.json.
• Formatação no frontend — resources/js/lib/format.ts e o composable useFormat para datas, números, moeda (R$), porcentagem e tempo relativo no padrão brasileiro.
• Docker Compose — nginx + PHP-FPM 8.5 (Dockerfile próprio, com Xdebug em dev) + PostgreSQL 16.
• Base enxuta — layouts, páginas e componentes do starter-kit padrão removidos; página inicial em branco e apenas os primitivos de UI reutilizáveis mantidos.
• Fortify instalado (rotas de autenticação registradas, sem views — recrie conforme o projeto).

📦 Stack

• PHP 8.5 (FPM) · Xdebug (dev)
• Nginx (Alpine)
• PostgreSQL 16
• Node.js / pnpm (Vite)
• Composer 2

🚀 Criar um novo projeto

composer create-project mateusotabe/brelue meu-app
cd meu-app

Os scripts post-create-project-cmd já geram a APP_KEY, criam o SQLite e rodam as migrações.

Caso o pacote não esteja no Packagist, adicione o repositório VCS no composer.json de destino:

"repositories": [
  { "type": "vcs", "url": "[e-mail]:mateusotabe/brelue.git" }
]

▶️ Subindo o ambiente com Docker

Requisitos: Docker >= 24 e Docker Compose >= 2.0.

# 1. Build e start dos containers
docker compose up -d --build

# 2. Arquivo de ambiente (se ainda não existir)
cp .env.example .env

# 3. Dependências PHP
docker compose exec php composer install

# 4. Dependências frontend
docker compose exec php pnpm install

# 5. Chave da aplicação e migrations
docker compose exec php php artisan key:generate
docker compose exec php php artisan migrate

# 6. Vite (hot reload)
docker compose exec php pnpm run dev

Serviço	URL / Porta
Aplicação	http://localhost:8000
Vite (HMR)	http://localhost:5173
PostgreSQL	localhost:5433 (db/usuário/senha: laravel)

Para usar PostgreSQL, descomente as variáveis DB_* no serviço php do docker-compose.yml (ou ajuste o .env).

💻 Desenvolvimento sem Docker

composer install
cp .env.example .env
php artisan key:generate
pnpm install
composer run dev   # serve + queue + logs + vite

🇧🇷 Localização

A configuração regional vive no .env.example (replicada em cada novo projeto). As traduções ficam em lang/pt_BR/. No frontend:

import { useFormat } from '@/composables/useFormat';

const { formatCurrency, formatDateTime } = useFormat();

formatCurrency(1234.5);      // "R$ 1.234,50"
formatDateTime(new Date());  // "19/05/2026 15:46"

🧪 Comandos úteis

docker compose exec php sh                       # shell no container PHP
docker compose logs -f                           # logs
docker compose up -d --build --force-recreate    # rebuild completo
docker compose down                              # parar
docker compose down -v                           # parar e remover volumes

📄 Licença

MIT.