PHPackages agavesoft/template-laravel - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Framework](/categories/framework) 4. / 5. agavesoft/template-laravel ActiveProject[Framework](/categories/framework) agavesoft/template-laravel ========================== The skeleton application for the Laravel framework in Agavesoft. v1.5.1(7mo ago)07MITTypeScriptPHP ^8.4 Since Jul 31Pushed 6mo agoCompare [ Source](https://github.com/agavesoft/template-laravel)[ Packagist](https://packagist.org/packages/agavesoft/template-laravel)[ RSS](/packages/agavesoft-template-laravel/feed)WikiDiscussions v12.f3 Synced 1mo ago READMEChangelog (5)Dependencies (26)Versions (10)Used By (0) 🚀 Template Laravel - Agavesoft ============================== [](#-template-laravel---agavesoft) [![Laravel](https://camo.githubusercontent.com/e0010537994e641cd56f693941a78e74b606f9d702184d2ec442599e0f7cd5e8/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c61726176656c2d31322e32312e302d7265642e737667)](https://laravel.com)[![PHP](https://camo.githubusercontent.com/d99323f769f72040b693c48a2dfaa9b767bae7f8dc307ac17c678e033fe4bdd8/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e342b2d626c75652e737667)](https://php.net)[![React](https://camo.githubusercontent.com/3f84e32576c1760518103de77743974e43cc0deb74615147420f47e51e86a3bb/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f52656163742d31392e302e302d626c75652e737667)](https://reactjs.org)[![TypeScript](https://camo.githubusercontent.com/1905f2ac564158a88fb4ac69082b856e82a270a3dd0148a81091ebbefaa7168d/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f547970655363726970742d352e372b2d626c75652e737667)](https://typescriptlang.org)[![Pest](https://camo.githubusercontent.com/9561abe55acef89a436f2470b89ae92919c6f8883efd9b33ad9380a11508a57f/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f54657374696e672d506573742d677265656e2e737667)](https://pestphp.com)[![License](https://camo.githubusercontent.com/784362b26e4b3546254f1893e778ba64616e362bd6ac791991d2c9e880a3a64e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d677265656e2e737667)](LICENSE) > Template moderno de Laravel con React, TypeScript, Filament y todas las herramientas necesarias para proyectos empresariales. 📋 Tabla de Contenidos --------------------- [](#-tabla-de-contenidos) - [🎯 Características](#-caracter%C3%ADsticas) - [🛠️ Stack Tecnológico](#%EF%B8%8F-stack-tecnol%C3%B3gico) - [📦 Instalación](#-instalaci%C3%B3n) - [🚀 Desarrollo](#-desarrollo) - [🧪 Testing](#-testing) - [📚 Estructura del Proyecto](#-estructura-del-proyecto) - [⚙️ Configuración](#%EF%B8%8F-configuraci%C3%B3n) - [🤝 Contribución](#-contribuci%C3%B3n) 🎯 Características ----------------- [](#-características) ### 🔐 **Autenticación y Autorización** [](#-autenticación-y-autorización) - Sistema completo de roles y permisos con **Spatie Laravel Permission** - Integración con **Filament** para gestión de usuarios - API authentication con **Laravel Sanctum** ### 🎨 **Frontend Moderno** [](#-frontend-moderno) - **React 19** + **TypeScript** - **Inertia.js** para SPA experience - **Tailwind CSS 4** + **shadcn/ui** + **Radix UI** - **Vite** para desarrollo rápido ### 📊 **Panel de Administración** [](#-panel-de-administración) - **Filament 3.3** completamente configurado - Gestión de roles y permisos - Sistema de logs y auditoría - Manejo de medios y archivos ### 🔧 **Características Avanzadas** [](#-características-avanzadas) - Sistema de **tags** (Spatie Laravel Tags) - **Media Library** para gestión de archivos - **Activity Log** para auditoría - Soporte para **Amazon S3** - Sistema de **colas** configurado - **Soft deletes** con tracking ### 🧪 **Testing y Calidad** [](#-testing-y-calidad) - **Pest** como framework de testing - Coverage reports configurados - **ESLint** + **Prettier** para código limpio - **Laravel Pint** para PHP 🛠️ Stack Tecnológico -------------------- [](#️-stack-tecnológico) ### Backend [](#backend) - **Laravel 12.21.0** - Framework PHP - **PHP 8.4+** - Lenguaje de programación - **SQLite/MySQL** - Base de datos - **Laravel Sanctum** - API Authentication ### Frontend [](#frontend) - **React 19** - Librería de UI - **TypeScript 5.7+** - Superset de JavaScript - **Inertia.js 2** - Modern monolith - **Tailwind CSS 4** - Framework CSS - **Vite 7** - Build tool ### Admin Panel [](#admin-panel) - **Filament 3.3** - Admin panel - **Spatie Laravel Permission** - Roles y permisos - **Spatie Media Library** - Gestión de medios ### Testing [](#testing) - **Pest 3.8** - Testing framework - **Laravel Dusk** - Browser testing (opcional) 📦 Instalación ------------- [](#-instalación) ### Prerrequisitos [](#prerrequisitos) - PHP 8.4+ - Composer 2.0+ - Node.js 18+ - npm/yarn ### 1. Crear un nuevo proyecto [](#1-crear-un-nuevo-proyecto) ``` composer create-project agavesoft/template-laravel nombredelproyecto cd nombredelproyecto ``` ### 2. Instalar dependencias [](#2-instalar-dependencias) ``` # Dependencias PHP composer install # Dependencias Node.js npm install ``` ### 3. Crear usuario administrador [](#3-crear-usuario-administrador) ``` php artisan db:user ``` 🚀 Desarrollo ------------ [](#-desarrollo) ### Comandos Disponibles [](#comandos-disponibles) #### Servidor de Desarrollo [](#servidor-de-desarrollo) ``` # Desarrollo completo (Laravel + Vite + Queue + Logs) composer run dev # Solo Laravel php artisan serve # Solo Vite npm run dev ``` #### Base de Datos [](#base-de-datos) ``` # Ejecutar migraciones php artisan migrate # Ejecutar seeders php artisan db:seed # Refresh completo php artisan migrate:refresh --seed ``` #### Frontend [](#frontend-1) ``` # Desarrollo npm run dev # Build para producción npm run build # Build con SSR npm run build:ssr # Linting npm run lint # Formateo npm run format ``` ### Tasks Predefinidas [](#tasks-predefinidas) El proyecto incluye tasks de VS Code para operaciones comunes: - **Servidor**: Laravel con/sin debug - **Base de datos**: Migraciones, seeders, rollbacks - **Modelos**: Crear modelos con controladores y migraciones - **Utils**: Rutas, middleware, eventos, etc. 🧪 Testing --------- [](#-testing) ### Ejecutar Tests [](#ejecutar-tests) ``` # Todos los tests php artisan test # Tests con coverage php artisan test --coverage # Coverage en formato Cobertura XML php artisan test --coverage-cobertura coverage/cobertura.xml # Tests específicos php artisan test --filter=UserTest ``` ### Estructura de Tests [](#estructura-de-tests) ``` tests/ ├── Feature/ # Tests de integración ├── Unit/ # Tests unitarios ├── Fixtures/ # Datos de prueba ├── Pest.php # Configuración de Pest └── TestCase.php # Clase base para tests ``` 📚 Estructura del Proyecto ------------------------- [](#-estructura-del-proyecto) ``` app/ ├── Console/Commands/ # Comandos Artisan ├── Filament/Resources/ # Recursos de Filament ├── Http/ │ ├── Controllers/ # Controladores │ ├── Middleware/ # Middleware │ └── Requests/ # Form Requests ├── Models/ # Modelos Eloquent ├── Policies/ # Políticas de autorización ├── Providers/ # Service Providers ├── Services/ # Lógica de negocio └── Traits/ # Traits reutilizables resources/ ├── css/ # Estilos CSS ├── js/ # Código React/TypeScript └── views/ # Vistas Blade (SSR) config/ ├── filament*.php # Configuración Filament ├── permission.php # Configuración permisos └── media-library.php # Configuración medios ``` ⚙️ Configuración ---------------- [](#️-configuración) ### Variables de Entorno Importantes [](#variables-de-entorno-importantes) ``` # Base de datos DB_CONNECTION=sqlite DB_DATABASE=/absolute/path/to/database.sqlite # Sanctum APP_SANCTUM_STATEFUL_DOMAINS=localhost # Filament FILAMENT_EMAILS="admin@example.com" # Storage (S3) FILESYSTEM_DISK=s3 AWS_ACCESS_KEY_ID=your-access-key AWS_SECRET_ACCESS_KEY=your-secret-key AWS_DEFAULT_REGION=us-east-1 AWS_BUCKET=your-bucket # Spatie MEDIA_DISK=local ACTIVITY_LOGGER_ENABLED=true # Queue QUEUE_CONNECTION=database ``` ### Configuración de Desarrollo [](#configuración-de-desarrollo) 1. **Herd/Valet**: El proyecto está optimizado para trabajar con Laravel Herd 2. **Xdebug**: Configurado para debugging (puerto 9003) 3. **Hot Reload**: Vite configurado para desarrollo rápido 📖 Uso ----- [](#-uso) ### Crear Nuevo Recurso [](#crear-nuevo-recurso) ``` # Crear modelo completo (modelo, migración, controlador, seeder) php artisan make:model Product -mcrs # Crear recurso de Filament php artisan make:filament-resource Product ``` Note Esto ya viene configurado por defecto al momento de crear un modelo ### Trabajar con Permisos [](#trabajar-con-permisos) ``` // En un modelo use Spatie\Permission\Traits\HasRoles; class User extends Authenticatable { use HasRoles; } // En código $user->assignRole('admin'); $user->givePermissionTo('edit articles'); ``` ### Activity Log [](#activity-log) ``` // En un modelo use Spatie\Activitylog\Traits\LogsActivity; class Product extends Model { use LogsActivity; protected static $logAttributes = ['name', 'price']; } ``` 🔧 Personalización ----------------- [](#-personalización) ### Cambiar Tema de Filament [](#cambiar-tema-de-filament) ``` // config/filament.php 'theme' => [ 'primary' => 'blue', 'secondary' => 'gray', ], ``` ### Añadir Middleware Global [](#añadir-middleware-global) ``` // app/Http/Kernel.php protected $middleware = [ // ... \App\Http\Middleware\YourMiddleware::class, ]; ``` 🤝 Contribución -------------- [](#-contribución) 1. Fork el proyecto 2. Crea una rama para tu feature (`git checkout -b feature/nueva-funcionalidad`) 3. Commit tus cambios (`git commit -am 'Añade nueva funcionalidad'`) 4. Push a la rama (`git push origin feature/nueva-funcionalidad`) 5. Abre un Pull Request ### Estándares de Código [](#estándares-de-código) - **PHP**: Seguir PSR-12, usar Laravel Pint - **JavaScript/TypeScript**: Seguir configuración ESLint/Prettier - **Tests**: Escribir tests para nueva funcionalidad 📄 Licencia ---------- [](#-licencia) Este proyecto está bajo la Licencia MIT. Ver el archivo [LICENSE](LICENSE) para más detalles. 📞 Soporte --------- [](#-soporte) - **Documentación**: [Laravel Docs](https://laravel.com/docs) - **Filament**: [Filament Docs](https://filamentphp.com/docs) - **Issues**: [GitHub Issues](https://github.com/agavesoft/template-laravel/issues) --- **Desarrollado con ❤️ por [Agavesoft](https://agavesoft.com.mx)** ### Health Score 37 — LowBetter than 83% of packages Maintenance65 Regular maintenance activity Popularity5 Limited adoption so far Community7 Small or concentrated contributor base Maturity59 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~10 days Recently: every ~15 days Total 7 Last Release 218d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/d40220cfb1782dcbe1b4b8a2c61f516b053a608c75ec2a735a27123466035bbe?d=identicon)[josesalomon](/maintainers/josesalomon) ![](https://www.gravatar.com/avatar/3193d28d7e2098101075eba84fcf069e2658d363e6252f94cc72a87ce926de74?d=identicon)[WilPaD](/maintainers/WilPaD) --- Top Contributors [![WilPaD](https://avatars.githubusercontent.com/u/72214148?v=4)](https://github.com/WilPaD "WilPaD (55 commits)") --- Tags frameworklaravel ### Code Quality TestsPest Code StyleLaravel Pint ### Embed Badge ![Health badge](/badges/agavesoft-template-laravel/health.svg) ``` [![Health](https://phpackages.com/badges/agavesoft-template-laravel/health.svg)](https://phpackages.com/packages/agavesoft-template-laravel) ``` ### Alternatives [nasirkhan/laravel-starter A CMS like modular Laravel starter project. 1.4k2.7k](/packages/nasirkhan-laravel-starter)[openclassify/openclassify The skeleton application for the Laravel framework. 2992.5k](/packages/openclassify-openclassify)[raugadh/fila-starter Laravel Filament Starter. 614.9k](/packages/raugadh-fila-starter) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)