PHPackages orange-soft/laravel-starter-kit - 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. orange-soft/laravel-starter-kit ActiveLibrary[Framework](/categories/framework) orange-soft/laravel-starter-kit =============================== Laravel starter kit with Inertia, Vue, PrimeVue, and common features v1.2.1(3mo ago)010↓50%proprietaryPHPPHP ^8.2 Since Jan 6Pushed 3mo agoCompare [ Source](https://github.com/orange-soft/laravel-starter-kit)[ Packagist](https://packagist.org/packages/orange-soft/laravel-starter-kit)[ RSS](/packages/orange-soft-laravel-starter-kit/feed)WikiDiscussions master Synced 1mo ago READMEChangelogDependencies (1)Versions (5)Used By (0) OrangeSoft Laravel Starter Kit ============================== [](#orangesoft-laravel-starter-kit) A Laravel starter kit installer that scaffolds a complete admin application with authentication, user management, and role-based access control. Requirements ------------ [](#requirements) - PHP 8.2+ - Laravel 11 or 12 - Node.js 18+ - PostgreSQL / MySQL / SQLite Installation ------------ [](#installation) ``` composer require orange-soft/laravel-starter-kit --dev php artisan os:starter:install ``` After installation, follow the manual configuration steps shown in the output, then run the post-installation commands. ### Installation Behavior [](#installation-behavior) File TypeFirst InstallRe-installWith `--force`**New files** (don't exist in fresh Laravel)CreatedSkippedReplaced**Protected files** (exist in fresh Laravel)Instructions shownInstructions shownInstructions shown**Customizable files** (e.g., RoleName.php, routes)CreatedSkippedSkipped**Protected files are never overwritten** - you must manually add the required code. Use `php artisan os:starter:check` to verify your configuration. **Customizable files** are never overwritten to preserve your changes. When skipped, a `.stub` file is created with the fresh version for comparison. You can add `*.stub` to your `.gitignore` if desired. ### Optional Features [](#optional-features) ``` php artisan os:starter:install --with=media --with=backup --with=activitylog ``` --- Manual Configuration -------------------- [](#manual-configuration) These files exist in a fresh Laravel project and require manual amendments. The installer shows these instructions automatically. ### 1. `app/Models/User.php` [](#1-appmodelsuserphp) Add imports: ``` use App\Models\Traits\HasTemporaryPassword; use App\Models\Traits\HasUuidRouteKey; use App\Notifications\Auth\ResetPasswordNotification; use App\Notifications\Auth\VerifyEmailNotification; use Illuminate\Contracts\Auth\MustVerifyEmail; use Illuminate\Database\Eloquent\SoftDeletes; use Spatie\Permission\Traits\HasRoles; ``` Update class declaration and add traits: ``` class User extends Authenticatable implements MustVerifyEmail { use HasFactory, Notifiable, HasRoles, HasTemporaryPassword, HasUuidRouteKey, SoftDeletes; ``` Add notification methods: ``` public function sendPasswordResetNotification($token): void { $this->notify(new ResetPasswordNotification($token)); } public function sendEmailVerificationNotification(): void { $this->notify(new VerifyEmailNotification); } ``` ### 2. `bootstrap/app.php` [](#2-bootstrapappphp) Add to `withMiddleware()`: ``` ->withMiddleware(function (Middleware $middleware) { $middleware->web(append: [ \App\Http\Middleware\HandleInertiaRequests::class, \App\Http\Middleware\HandleNavigationContext::class, ]); $middleware->alias([ 'password.not_temporary' => \App\Http\Middleware\EnsurePasswordIsNotTemporary::class, 'role' => \Spatie\Permission\Middleware\RoleMiddleware::class, 'permission' => \Spatie\Permission\Middleware\PermissionMiddleware::class, 'role_or_permission' => \Spatie\Permission\Middleware\RoleOrPermissionMiddleware::class, ]); }) ``` ### 3. `tests/Pest.php` [](#3-testspestphp) Add RefreshDatabase configuration: ``` pest()->extend(Tests\TestCase::class) ->use(Illuminate\Foundation\Testing\RefreshDatabase::class) ->in('Feature'); pest()->extend(Tests\TestCase::class) ->use(Illuminate\Foundation\Testing\RefreshDatabase::class) ->group('browser') ->in('Browser'); ``` ### 4. `phpunit.xml` [](#4-phpunitxml) Add Browser testsuite in ``: ``` tests/Browser ``` ### 5. `vite.config.js` [](#5-viteconfigjs) Add imports and plugins: ``` import vue from '@vitejs/plugin-vue'; import tailwindcss from '@tailwindcss/vite'; import {wayfinder} from '@laravel/vite-plugin-wayfinder'; import {resolve} from 'path'; export default defineConfig({ plugins: [ laravel({ input: ['resources/css/app.css', 'resources/js/app.js'], refresh: true, }), tailwindcss(), wayfinder({ formVariants: true }), vue({ template: { transformAssetUrls: { base: null, includeAbsolute: false }, }, }), ], resolve: { alias: { '@': resolve(__dirname, 'resources/js'), '@fonts': resolve(__dirname, 'public/fonts'), }, }, }); ``` ### 6. `.env` [](#6-env) ``` DEFAULT_USER_PASSWORD=your-secure-password ``` --- Post-Installation ----------------- [](#post-installation) After completing manual configuration: ``` npm install && npm run build php artisan migrate && php artisan db:seed --class=RoleSeeder && php artisan db:seed --class=AdminUserSeeder composer test ``` Verify your configuration: ``` php artisan os:starter:check ``` Default admin credentials: - Email: `admin@example.com` - Password: Value of `DEFAULT_USER_PASSWORD` in `.env` What's Included --------------- [](#whats-included) ### Stack [](#stack) - **Inertia.js v2** - Server-side routing with Vue frontend - **Vue 3** - Composition API with `` - **Tailwind CSS v4** - CSS-first configuration (14px compact admin UI) - **PrimeVue** - UI component library with Aura preset - **Laravel Wayfinder** - Type-safe routing - **Spatie Permission** - Role-based access control ### Features [](#features) #### Authentication [](#authentication) - Login with email/password - "Remember me" functionality - Forgot password (email link) - Reset password - Email verification - **Temporary password flow**: New users must change password on first login #### User Management [](#user-management) - List users with search and pagination - Create user with role assignment - Edit user with role assignment - Delete user (with self-delete protection) #### Navigation Context [](#navigation-context) - **Automatic pagination preservation**: Users return to the same page after CRUD operations - Session-based URL storage for index pages - Works automatically with all resource controllers #### Admin UI [](#admin-ui) - **14px base font** for compact, professional appearance - **Breadcrumbs** with automatic title fallback - Sidebar navigation - Topbar with user menu - Toast notifications - Confirmation dialogs ### Files Structure [](#files-structure) ``` app/ ├── Enums/ │ └── RoleName.php # Role enum (customize per app) ├── Http/ │ ├── Controllers/ │ │ ├── Auth/ │ │ │ ├── ChangePasswordController.php │ │ │ ├── ForgotPasswordController.php │ │ │ ├── LoginController.php │ │ │ ├── LogoutController.php │ │ │ ├── ResetPasswordController.php │ │ │ └── VerifyEmailController.php │ │ ├── Traits/ │ │ │ └── RedirectsToStoredIndex.php # Navigation context trait │ │ ├── ProfileController.php │ │ └── UserController.php │ ├── Middleware/ │ │ ├── EnsurePasswordIsNotTemporary.php │ │ ├── HandleInertiaRequests.php │ │ └── HandleNavigationContext.php # Pagination preservation │ └── Requests/ │ ├── Auth/ │ │ ├── ChangePasswordRequest.php │ │ ├── ForgotPasswordRequest.php │ │ ├── LoginRequest.php │ │ └── ResetPasswordRequest.php │ ├── ProfileUpdateRequest.php │ ├── UserStoreRequest.php │ └── UserUpdateRequest.php ├── Mail/ │ └── AppMailable.php # Base mailable class ├── Models/ │ ├── Traits/ │ │ └── HasUuidRouteKey.php │ └── User.php # With HasRoles, temp password support └── Notifications/ ├── Auth/ │ ├── ResetPasswordNotification.php │ └── VerifyEmailNotification.php └── AppNotification.php # Base notification class bootstrap/ └── app.php # Middleware registration config/ └── os.php # Kit configuration database/ ├── migrations/ │ └── 0001_01_01_000010_add_uuid_and_temp_password_to_users_table.php └── seeders/ ├── AdminUserSeeder.php ├── DatabaseSeeder.php └── RoleSeeder.php resources/ ├── css/ │ ├── app.css # Tailwind + PrimeUI + Typography │ └── fonts.css # Custom fonts ├── js/ │ ├── layouts/ │ │ ├── AdminLayout.vue # With breadcrumbs, Head component │ │ └── AuthLayout.vue │ ├── components/ │ │ ├── AppShell.vue │ │ ├── ConfirmDialog.vue │ │ ├── FormError.vue │ │ ├── Sidebar.vue │ │ ├── Toast.vue │ │ └── Topbar.vue │ ├── pages/ │ │ ├── auth/ │ │ │ ├── ChangePassword.vue │ │ │ ├── ForgotPassword.vue │ │ │ ├── Login.vue │ │ │ ├── ResetPassword.vue │ │ │ └── VerifyEmail.vue │ │ ├── dev/ │ │ │ └── Typography.vue # Typography preview page │ │ ├── profile/ │ │ │ └── Edit.vue │ │ ├── users/ │ │ │ ├── Create.vue │ │ │ ├── Edit.vue │ │ │ └── Index.vue │ │ └── Dashboard.vue │ ├── app.js │ └── bootstrap.js └── views/ ├── app.blade.php └── vendor/ ├── mail/ # Custom mail templates └── notifications/ routes/ ├── admin.php # User management routes ├── auth.php # Authentication routes └── web.php # Modified to include above tests/ ├── Browser/ │ ├── AuthTest.php │ ├── ProfileTest.php │ └── UserManagementTest.php └── Feature/ ├── Auth/ │ ├── ChangePasswordTest.php │ ├── EmailVerificationTest.php │ ├── ForgotPasswordTest.php │ ├── LoginTest.php │ ├── LogoutTest.php │ └── ResetPasswordTest.php ├── Profile/ │ └── ProfileTest.php ├── MiddlewareTest.php ├── NotificationsTest.php ├── RolesTest.php └── UserManagementTest.php ``` Customization ------------- [](#customization) ### Roles [](#roles) Edit `app/Enums/RoleName.php` to define your application's roles: ``` enum RoleName: string { case Admin = 'admin'; case Manager = 'manager'; case Staff = 'staff'; } ``` Then re-run the seeder: ``` php artisan db:seed --class=RoleSeeder ``` ### Navigation Context [](#navigation-context-1) The `HandleNavigationContext` middleware runs globally and preserves pagination/filter state. In controllers, use the `RedirectsToStoredIndex` trait: ``` use App\Http\Controllers\Traits\RedirectsToStoredIndex; class ProductController extends Controller { use RedirectsToStoredIndex; public function store(ProductStoreRequest $request) { $request->persist(); // Redirects to stored URL (e.g., /products?page=3&search=widget) return $this->redirectToIndex('products.index', 'Product created.'); } } ``` ### Breadcrumbs [](#breadcrumbs) Pass breadcrumbs to `AdminLayout`: ``` ``` If no breadcrumbs provided, the title is used as fallback. Optional Features ----------------- [](#optional-features-1) ### Media Library (`--with=media`) [](#media-library---withmedia) - Installs `spatie/laravel-medialibrary` - Publishes config and migrations ### Backup (`--with=backup`) [](#backup---withbackup) - Installs `spatie/laravel-backup` - Publishes config ### Activity Log (`--with=activitylog`) [](#activity-log---withactivitylog) - Installs `spatie/laravel-activitylog` - Publishes config and migrations - Includes `LogsActivity` trait Testing ------- [](#testing) ``` # Run all tests (excluding browser tests) composer test # Run browser tests only composer test:browser # Run specific test file php artisan test tests/Feature/UserManagementTest.php ``` ### Browser Test Cleanup [](#browser-test-cleanup) Browser tests download "Chrome for Testing" binaries. Over time, these accumulate and clutter your macOS "Open With" menu with multiple Chrome versions. To clean up old versions: ``` # Remove cached browser binaries rm -rf ~/.cache/puppeteer rm -rf ~/.cache/ms-playwright # Reset macOS Launch Services database /System/Library/Frameworks/CoreServices.framework/Frameworks/LaunchServices.framework/Support/lsregister -kill -r -domain local -domain system -domain user # Restart Finder killall Finder ``` Development Scripts ------------------- [](#development-scripts) ``` # Start all services (server, queue, logs, vite) composer dev # Initial setup composer setup ``` License ------- [](#license) Proprietary - Orange Soft ### Health Score 38 — LowBetter than 85% of packages Maintenance82 Actively maintained with recent releases Popularity6 Limited adoption so far Community6 Small or concentrated contributor base Maturity50 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 Total 4 Last Release 96d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/1e21ffc9e4aa71c5644306993e6b13e6a2204caa59ac91e9e0e63574136d112e?d=identicon)[justinmoh](/maintainers/justinmoh) --- Top Contributors [![justinmoh](https://avatars.githubusercontent.com/u/11174621?v=4)](https://github.com/justinmoh "justinmoh (8 commits)") ### Embed Badge ![Health badge](/badges/orange-soft-laravel-starter-kit/health.svg) ``` [![Health](https://phpackages.com/badges/orange-soft-laravel-starter-kit/health.svg)](https://phpackages.com/packages/orange-soft-laravel-starter-kit) ``` ### Alternatives [laravel/socialite Laravel wrapper around OAuth 1 & OAuth 2 libraries. 5.7k96.9M674](/packages/laravel-socialite)[laravel/horizon Dashboard and code-driven configuration for Laravel queues. 4.2k84.2M225](/packages/laravel-horizon)[laravel/ui Laravel UI utilities and presets. 2.7k134.9M601](/packages/laravel-ui)[laravel/jetstream Tailwind scaffolding for the Laravel framework. 4.1k19.8M136](/packages/laravel-jetstream)[stancl/tenancy Automatic multi-tenancy for your Laravel application. 4.3k6.6M40](/packages/stancl-tenancy)[internachi/modular Modularize your Laravel apps 1.1k662.4k8](/packages/internachi-modular) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)