Enraiged Laravel v0.4.x

**Laravel 12 • Vue v3.5 • Inertia.js v2.3 • Primevue v4.5 • TailwindCSS v4.2 **

Enraiged Laravel is a starter kit implementing Laravel 12, Vite, VueJS, InertiaJS, Primevue, and TailwindCSS.

Table of Contents

• Installation
  • Retrieve Repository
  • Init Environment
  • Build Database
  • Build Client
  • Patch Packages
  • Serve Application
• Licence

Install Application

Retrieve Repository

There are currently 3 variants of Enraiged Laravel:

Laravel 13

The 0.5.x branch is Laravel 13 (newest) and can be cloned with the following:

cd /path/to/your/repos/ # traverse into your repositories directory
git clone --depth 1 --single-branch --branch 0.5.x https://github.com/tcytra/enraiged-laravel
cd enraiged-laravel/

Laravel 12

The 0.4.x branch is Laravel 12 (also the master branch) and can be cloned with the following:

cd /path/to/your/repos/ # traverse into your repositories directory
git clone --depth 1 https://github.com/tcytra/enraiged-laravel
cd enraiged-laravel/

Laravel 10

The 0.3.x branch is Laravel 10 and is not recommended for use in new projects.

Once the repository is downloaded, install the vendor packages:

Add the --no-dev flag when installing in a production environment.

composer install

Init Environment

Create the initial environment configuration:

cp .env.example .env     # create the .env file from the example config
php artisan key:generate # create the application key

The setup from the .env.example will be enough to get you started in a local environment. At minimum, valid DB_ parameters will need to be added, and the developer may want to double-check the basic APP_ config.

Build Database

The migration and seeder assets can now be run:

php artisan migrate --seed

Note: The initial administrator account is defined in ~/resources/seeds/users.json and will be created with the above command. The default email:password for this user is administrator@enraiged.local:changeme. Please change this to something suitable for your project.

Build Client

Finally, we will install the node packages and build the front-end resources. Start with:

Add the --omit=dev flag when installing in a production environment.

npm install

Launch the vite development build (during development):

npm run dev

When complete, build the app for service:

npm run build

Patch Packages

In the v4.x distribution of Primevue Datatable, a previously existing feature to display column data in a 'stack' format under a provided breakpoint was removed for unknown reasons. Enraiged Laravel 0.4.x includes an optional patch to restore this feature.

Apply the patch by running the following command:

Note: The npm run build command will need to be reexecuted after applying this patch.

patch -p0 < patches/primevue-datatable-4.5.4-restore-responsive-stack.patch

Revert these changes by using -Rp0 instead of -p0.

Serve Application

The simplest way to launch and preview this application is with artisan serve:

php artisan serve

Now, navigate to (http://127.0.0.1:8000/), et voilà.

Run the SSR server:

php artisan inertia:start-ssr

Serving this application by other means is beyond the scope of this README.

License

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