webmodern/alpaca-engine

Start kit for new laravel project with admin from Filament and some packages.

v0.1.1-beta.5 2025-07-30 14:43 UTC

Requires

• php: ^8.4
• bezhansalleh/filament-shield: ^4.0@beta
• filament/filament: ^4.0
• laravel/framework: ^12.0
• laravel/tinker: ^2.10.1
• plesk/ext-laravel-integration: *
• webmodern/alpaca-activitylog: ^0.1.0

Requires (Dev)

• fakerphp/faker: ^1.23
• laravel/pail: ^1.2.2
• laravel/pint: ^1.13
• laravel/sail: ^1.41
• mockery/mockery: ^1.6
• nunomaduro/collision: ^8.6
• phpunit/phpunit: ^11.5.3

MIT

• framework
• laravel
• start-kit
• alpaca-engine

README

Alpaca Engine

🚀 Laravel 12 Starter Kit

A Starter Kit for rapid project development based on Laravel 12. Includes a modern admin panel powered by filamentphp, along with a set of popular libraries to speed up your workflow. Perfect for building admin panels and web applications with a flexible architecture.

Deployment and Environment Configuration Script

This project includes a utility script for safely switching and managing .env files on the server.

Usage

• Apply an environment profile (e.g., server, local, staging):

./deploy/env_switch.sh [profile]

Replace [profile] with the desired environment name (e.g., server, local).
The script expects a file named env.[profile] in the project root (for example: env.server).

• Restore the last .env backup:

./deploy/env_switch.sh restore

What the Script Does

• Backs up the current .env file to /deploy before replacing it.
• Switches .env to the specified profile (env.[profile]).
• Keeps a profile-specific log file in /deploy (e.g., env_server.log).
• Cleans up old logs automatically (older than 3 months).
• Restores the last backup if run with restore.
• Clears Laravel config cache, runs migrations, and updates Composer dependencies.

Additional Notes

• The /deploy directory is git-ignored except for the script itself.
• All other files in /deploy (backups, logs, etc.) are never committed to git.
• Make sure the script is executable:

chmod +x deploy/env_switch.sh

License

The Laravel framework is open-sourced software licensed under the MIT license.