A single-command setup script that bootstraps Laravel projects with Flux UI, Keycloak SSO, and common packages.

• Installs and activates Flux UI with Tailwind CSS v4
• Configures Keycloak SSO via Laravel Socialite
• Installs Horizon and Sanctum
• Copies your template files (routes, providers, views, etc.)
• Injects config into routes/web.php and config/services.php
• Sets up environment variables

• A fresh Laravel project with a clean git working tree
• Flux UI license
• Node.js and Composer

export FLUX_USERNAME="your-flux-username"
export FLUX_LICENSE_KEY="your-flux-license-key"

php laravel-init.php /path/to/your-laravel-project

Composer:

• livewire/flux
• laravel/socialite
• socialiteproviders/keycloak
• laravel/horizon
• laravel/sanctum

NPM:

• vite
• tailwindcss
• @tailwindcss/vite
• laravel-vite-plugin

Fork this repo and modify to suit your stack:

Place your boilerplate files alongside laravel-init.php. The script copies everything except files in $excludeFiles. Existing files prompt before overwriting (unless matched by $autoCopyPatterns).

Example structure:

laravel-init/
├── laravel-init.php
├── app/
│   └── Providers/
│       └── SSOServiceProvider.php
├── routes/
│   └── sso-auth.php
├── resources/
│   └── views/
│       └── ...
└── config/
    └── ...

The following are added to .env and .env.example:

KEYCLOAK_BASE_URL=https://
KEYCLOAK_REALM=
KEYCLOAK_CLIENT_ID=name-in-keycloak
KEYCLOAK_CLIENT_SECRET=secret-in-keycloak
KEYCLOAK_REDIRECT_URI=http://your-app/auth/callback
SSO_ENABLED=false
SSO_AUTOCREATE_NEW_USERS=false
SSO_ALLOW_STUDENTS=false
SSO_ADMINS_ONLY=false

MIT