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.