Download the PHP package josenildotiago/crud without Composer

Laravel CRUD Generator v3.0.18

Um pacote moderno para Laravel que gera operações CRUD completas com integração React.js e sistema de temas dinâmicos.

🚀 Características Principais

✨ Compatibilidade Laravel 12

• Arquitetura Moderna: Totalmente atualizado para Laravel 12+ com suporte PHP 8.2+
• Integração AppLayout: Usa AppLayout (ao invés do AuthenticatedLayout descontinuado)
• Sistema de Breadcrumbs: Navegação hierárquica abrangente
• Campos Inteligentes: Detecção automática de campos fillable para React useForm
• Organização de Rotas: Arquivos de rota separados por modelo com middleware adequado
• Suporte Multi-Database: Compatível com MySQL, PostgreSQL, SQLite e SQL Server
• Design RESTful: Gera controllers e rotas RESTful limpos

🎨 Sistema de Temas Dinâmicos

• Sistema de Cores OKLCH: Suporte ao espaço de cor moderno para temas vibrantes e consistentes
• CSS Custom Properties: Mudança de tema em tempo real sem reload da página
• Integração React: Hooks e componentes integrados para gerenciamento de temas
• Temas Persistentes: Preferências do usuário salvas entre sessões
• Criação Automática: Comando para criar novos temas personalizados

⚛️ Integração React.js + shadcn/ui

• Suporte Inertia.js: SSR sem complicações com backend Laravel
• TypeScript Pronto: Suporte completo ao TypeScript para type safety
• Componentes Modernos: AppLayout com navegação breadcrumb
• shadcn/ui Integration: Uso completo de Button, Card, Input, Label
• Formulários Inteligentes: Integração fillableColumns com useForm
• Design Responsivo: Padrões mobile-first

🛠️ Funcionalidades CRUD Avançadas

• Operações em Lote: Ações multi-select para gerenciamento eficiente de dados
• Busca Avançada: Busca em tempo real com debouncing
• Paginação Inteligente: Paginação otimizada com preservação de estado
• Validação de Formulários: Validação client e server-side
• Upload de Arquivos: Manipulação integrada de arquivos com preview
• Export/Import: Exportação CSV com colunas customizáveis

📦 Instalação

🎯 Início Rápido

1. Instalar Sistema de Temas (Opcional)

Este comando irá:

• Detectar seu stack frontend (React.js + Inertia.js)
• Instalar configuração de temas
• Gerar componentes React TypeScript
• Configurar CSS custom properties

2. Criar Seu Primeiro Tema (Opcional)

Prompts interativos irão guiá-lo através de:

• Nome e identificador do tema
• Cores primárias e secundárias (formato OKLCH)
• Seleção de tema claro/escuro
• Geração automática de paleta de cores

3. Gerar Recursos CRUD

Este comando gera:

• Model: app/Models/User.php com relacionamentos
• Controller: app/Http/Controllers/UserController.php otimizado para Inertia.js
• Componentes React: Interface CRUD completa em TypeScript
  • Create.tsx - Formulário de criação com shadcn/ui
  • Edit.tsx - Formulário de edição
  • Index.tsx - Listagem com paginação e busca
  • Show.tsx - Visualização de registro
• Routes: routes/user.php com middleware auth e verified
• Form Request: app/Http/Requests/UserRequest.php para validação

Opções Avançadas

🎨 Sistema de Temas

Como Usar no React

Temas Disponíveis

• Padrão: Preto e branco clássico
• Azul: Profissional e confiável
• Verde: Natureza e crescimento
• Roxo: Moderno e criativo
• Vermelho: Energia e ação
• + Personalizados: Crie quantos quiser!

📋 Comandos Disponíveis

🎯 Exemplo de Uso Completo

1. Instalação e Configuração

2. Gerar CRUD para Produtos

3. Resultado Gerado

Controller (app/Http/Controllers/ProductController.php)

Componente React (resources/js/pages/Product/Create.tsx)

Rotas (routes/product.php)

🔧 Configuração Avançada

Arquivo de Configuração

Publique e customize as configurações:

Arquivo config/crud.php:

📱 Características da Interface

Componentes shadcn/ui

• Cards: Layout moderno com header, content e footer
• Buttons: Com estados de loading e ícones
• Inputs: Com labels e validação integrada
• Tables: Responsivas com paginação
• Forms: Grid responsivo e validação em tempo real

Design Responsivo

• Mobile-first: Otimizado para dispositivos móveis
• Grid System: sm:grid-cols-12 para layout flexível
• Breakpoints: Tailwind CSS responsivo
• Touch-friendly: Interface amigável ao toque

🚀 Performance

Otimizações

• Lazy Loading: Componentes carregados sob demanda
• Code Splitting: Divisão automática de código
• CSS Optimization: Custom properties para temas
• Database Queries: Queries otimizadas com Eloquent

Caching

• Template Caching: Stubs em cache durante desenvolvimento
• Query Caching: Colunas de banco em cache
• Asset Optimization: CSS e JS otimizados para produção

🧪 Testes

Execute os testes do pacote:

Cobertura

• Unit Tests: Commands, Manager, Generator
• Integration Tests: Geração completa de CRUD
• Component Tests: Temas e componentes React

📚 Documentação Adicional

• Documentação Técnica: Arquitetura detalhada do sistema
• Changelog: Histórico de versões e mudanças
• Contribuição: Como contribuir para o projeto

🤝 Contribuição

Contribuições são bem-vindas! Por favor, leia o guia de contribuição para detalhes sobre nosso código de conduta e o processo para enviar pull requests.

📄 Licença

Este projeto está licenciado sob a Licença MIT - veja o arquivo LICENSE para detalhes.

🆘 Suporte

Se você encontrar algum problema ou tiver dúvidas:

1. Issues: Abra uma issue no GitHub
2. Discussões: Use as discussões do GitHub para perguntas
3. Email: [email protected]

🎉 Créditos

Desenvolvido com ❤️ por Josenildo Tiago

Tecnologias Utilizadas

• Laravel 12: Framework PHP moderno
• React.js: Biblioteca JavaScript para UI
• Inertia.js: Stack moderno sem API
• TypeScript: JavaScript tipado
• shadcn/ui: Componentes React modernos
• Tailwind CSS: Framework CSS utility-first
• OKLCH: Espaço de cor moderno