包简介

The skeleton application for the Laravel framework.

README 文档

README

Laravel Starter Kit

A modern, developer-friendly Laravel starter kit featuring a curated selection of tools and a polished, feature-reached admin panel — ready for production from day one.

✨ Features

Laravel 12, PHP 8.3+ support
Choose your Admin Panel during setup:
- Filament — beautiful, customizable full-stack components
- Moonshine — comfortable, user-friendly admin panel
Choose your API utility during setup:
- pepperfm/api-responder-for-laravel
- spatie/laravel-data
Ready-to-use Swagger API docs with l5-swagger
Telegram bot integration via defstudio/telegraph
Local development environment powered by Laravel Sail
Pre-configured with:
- Pest + Larastan for clean and safe testing
- Laravel Debugbar, Ray, Pint, and Git hooks

📦 Installation

laravel new example-app --using=pepperfm/laravel-starter-kit

After creating your project, the interactive starter:setup command will run automatically, helping you choose:

Whether to install Filament or Moonshine admin panel (or skip both)
API support packages and Swagger docs
Optional features like Telegram bot integration, Ray debugger, Media Library, and Permissions

You will also be prompted to configure environment variables WWWUSER and WWWGROUP for proper permissions.

✅ If you agree to automatic build and launch with Sail, the setup will:

Install selected composer packages
Build and start Sail containers
Generate an app key and run post-install artisan commands specific to installed packages (e.g., filament:install --panels or moonshine:install)

❌ If you decline, run them manually:

chmod 755 ./sail
./sail up -d --build
./sail composer install
./sail artisan key:gen
./sail artisan sto:li

⚙️ Setup Command

Run manually anytime:

php artisan starter:setup

Interactive setup will help you customize your project features and install optional packages with their post-install steps.

🛠 Post-Install Commands

For installed packages, the following post-install artisan commands will run automatically (if you use auto-build):

Package	Команды
`moonshine/moonshine`	`php artisan moonshine:install`
`filament/filament`	`php artisan filament:install --panels`
`darkaonline/l5-swagger`	`php artisan install:api`
`defstudio/telegraph`	`php artisan vendor:publish --tag="telegraph-migrations"` `php artisan migrate`
`spatie/laravel-medialibrary`	`php artisan vendor:publish --provider="Spatie\MediaLibrary\MediaLibraryServiceProvider" --tag="medialibrary-migrations"` `php artisan migrate`
`spatie/laravel-permission`	`php artisan vendor:publish --provider="Spatie\Permission\PermissionServiceProvider"` `php artisan opt:cle` `php artisan migrate`

🧪 Testing & Quality

make pint        # Show unstaged files with codestyle issues
make pint-hard   # Fix codestyle issues automatically
make stan        # Run Larastan (static analysis)
make test        # Run all tests via Pest

📚 Useful Links

pepperfm/laravel-starter-kit 适用场景与选型建议

pepperfm/laravel-starter-kit 是一款基于 PHP 开发的 Composer 扩展包，目前已累计 19 次下载、GitHub Stars 达 2，最近一次更新时间为 2025 年 05 月 26 日，在 PHP 生态内属于活跃度较高的组件。

它主要适用于以下技术方向：「framework」「laravel」「starter」等业务场景。在实际项目中，围绕这些方向常见需要落地的问题包括：接口对接、性能调优、并发安全、与既有框架（Laravel / ThinkPHP / Yii / Webman 等）的兼容适配，以及生产环境的日志埋点与稳定性保障。

我们在过去多个企业项目中使用过 pepperfm/laravel-starter-kit 或与其功能相近的方案，如果你在选型或落地过程中遇到问题，例如 版本兼容、二次改造、私有化封装、与内部系统对接、生产 BUG 排查，欢迎联系我们协助评估。

围绕 pepperfm/laravel-starter-kit 我们能提供哪些服务？

定制开发 / 二次开发

基于 pepperfm/laravel-starter-kit 在你已有业务上做功能扩展、字段裁剪、UI 适配、与内部账号 / 权限 / 日志系统的深度对接。

BUG 修复 & 性能优化

线上偶发问题、内存泄漏、慢查询、并发异常等排查修复；针对高流量场景做缓存、队列、索引层面的调优。

项目外包 & 长期维护

承接完整的项目从需求 → 设计 → 开发 → 上线 → 长期运维；也可按月提供技术保姆服务。

yvsm@zunyunkeji.com QQ：316430983 微信：yvsm316 西安尊云信息科技 · 专注 PHP / Go / 分布式系统研发