Download the PHP package karabinse/fabriq without Composer

Fabriq CMS

Upgrade guides

• See UPGRADE-v3.md for upgrading an existing project from v2.x to v3.x.

Installation instructions 💻

Add the customer repository url for the make-user-command in your composer.json file:

Install Fabriq:

If you're planning on using AWS s3:

Install the Mailgun driver

Install Laravel Sanctum as well for authentication

Add the domain to the .env file:

Publish the configurations:

Setup your database using the .env

Modify the user model 🧘

The user model need to extend the Fabriq\Models\User::class

Run the fabriq:install command:

This command will publish front end assets and views. It will also run the migrations

Important Delete the files app.js and bootstrap.js in the resources/js directory

Run pnpm install and pnpm production to build assets

Auth configuration 🗝

Laravel v11 and above

[!NOTE] On Laravel 11 and up the step below is not necessary since the files are overwritten when installing

Laravel below v11

Enable the Laravel Sanctum middleware in app\Http\Kernel.php

Register routes 🛣

[!NOTE] On Laravel 11 and up the this is not necessary since the files are overwritten when installing

Register the routes that makes sense for your app. See below examples

Create your first user in the database, or by using a package like michaeldyrynda/laravel-make-user

Publishing assets 🗄️

Assets can be published using their respective tags. The tags that are available are:

• config - The config file
• fabriq-translations - Translations for auth views and validation messages
• fabriq-frontend-assets - Front end build system and Vue project files
• fabriq-views - Blade views and layouts

You can publish these assets using the command below:

If you want to overwrite your old published assets with new ones (for example when the package has updated views) you can use the --force flag

Note Above tags have been published when the fabriq:install was run

Broadcasting 📢

Fabriq leverages laravel/echo as a front end dependency to communicate with a pusher server. This package is preconfigured to use Ikoncept's own websocket server, but a pusher implementation can be swapped in.

For the migrated Inertia admin, Echo is initialized on demand from the package runtime when websocket config is available. There is no manual resources/js/plugins/index.js import step anymore, and there is no client-side route middleware wiring to maintain.

Don't forget to add the proper .env variables:

Presence and broadcast subscriptions for the migrated admin are package-owned and are wired from the relevant Inertia surfaces, primarily the page editor/comments runtime. Host apps only need the websocket configuration and backend broadcasting setup.

Updating ♻️

You can publish new front end assets with the php artisan fabriq:update command. This command will publish new front end assets and run migrations.

Done? 🎉

That should be it, serve the app and login at /login

License

The MIT License (MIT). Please see License File for more information.

Testing