// Step-by-step interactive installer for takielias/lab (laravel-ajax-builder) — composer require, lab:install artisan command (patches resources/js/app.js and scaffolds config), CSRF meta tag check, smoke @submit + @alert Blade directive test. Pause for user approval at every shell command.
Step-by-step interactive installer for takielias/tablar-crud-generator (dev dep) into a Laravel app already running tablar + tablar-kit — composer require dev, optional config publish, smoke `make:crud` scaffold, route + view registration. Pause for user approval at every shell command.
Step-by-step interactive installer for takielias/tablar-kit on top of an existing takielias/tablar app — composer require, config publish, confirm-modal mount in master.blade.php, JS init wiring, build step. Pause for user approval at every shell command. Idempotent on rerun.
Author tablar sidebar/top menus via config/tablar.php — full item schema (text, url/route, icon, submenu, can, label, type), filter pipeline (GateFilter, HrefFilter, ActiveFilter, etc.), permission gating with Laravel Gate, special widget items (search, darkmode, fullscreen, notification), dynamic runtime menus.
Install, upgrade, and configure the takielias/tablar starter kit — composer require, tablar:install, layout selection, post-install patches (SoftDeletes on User, base Controller class for L11+), and recovery from common install failures.
| name | install-laravel-ajax-builder |
| description | Step-by-step interactive installer for takielias/lab (laravel-ajax-builder) — composer require, lab:install artisan command (patches resources/js/app.js and scaffolds config), CSRF meta tag check, smoke @submit + @alert Blade directive test. Pause for user approval at every shell command. |
Slash command: /laravel-boost:install-laravel-ajax-builder
Note: composer name is takielias/lab (the GitHub repo is laravel-ajax-builder, but the Packagist + composer name is lab).
Walk one step at a time. Pause for user approval before every shell command.
Laravel version:
php artisan --version
Lab supports Laravel 11.x / 12.x / 13.x.
PHP ≥ 8.3 (Lab's minimum):
php -v
resources/js/app.js exists (lab:install patches it):
test -f resources/js/app.js && echo PRESENT || echo MISSING
If missing — Laravel default skeleton has it; recent Vite-based skeletons too. If missing, user is on a custom JS structure and lab:install will error. Either restore resources/js/app.js OR install JS pieces manually.
package.json present (lab:install requires it):
test -f package.json && echo PRESENT || echo MISSING
CSRF meta tag in main layout — required for fetch requests:
grep -rn "csrf-token" resources/views/layouts/ resources/views/vendor/tablar/master.blade.php 2>/dev/null
If missing, plan to add: <meta name="csrf-token" content="{{ csrf_token() }}"> inside <head>. tablar's published master.blade.php already includes it.
Already installed?:
composer show takielias/lab
If present → skip step 1, jump to step 4 (smoke).
composer require takielias/lab
Service provider Takielias\Lab\LabServiceProvider auto-discovered. Facade alias Lab → Takielias\Lab\Facades\Lab registered automatically.
php artisan lab:install
What it does (read src/Commands/InstallLAB.php):
package.json exists.resources/js/app.js exists.resources/js/app.js to import Lab's JS helpers (the window.ajax* family + .ajax-submit-button auto-binding).config/lab.php (publishes the package config).After it finishes, the command prints:
LAB is now installed 🚀
Once the installation is done, run "npm run dev"
npm install # if dependencies need refresh
npm run dev # or: npm run build
This compiles the Lab JS helpers into the Vite manifest. Without build, window.ajaxPost will be undefined.
Confirmed in pre-flight check 5. If missing from the active layout, propose this insertion inside <head>:
<meta name="csrf-token" content="{{ csrf_token() }}">
If user is on tablar layout — already present.
Lab is a server-side response builder, not a JS DSL. The flow is:
<button class="ajax-submit-button"> to auto-submit a form).Lab::...->setMessage(...)->asAjax() and returns JsonResponse.message, redirect, alert, etc. from the JSON and renders accordingly.For smoke, suggest a minimal route + view:
Route (routes/web.php):
Route::post('/lab-smoke', function () {
return Lab::setMessage('It works!')->setAlertView('success')->renderAlert()->asAjax();
})->middleware('web');
View (any Blade view):
<form action="/lab-smoke" method="POST">
@csrf
@alert
<button type="submit" class="ajax-submit-button btn btn-primary">@submit('Test')</button>
</form>
The @alert directive emits the alert-target div, @submit emits the button label markup. The .ajax-submit-button class triggers Lab's JS auto-binder.
Click the button → expect:
/lab-smoke via fetch (no full page reload).<button> shows loading state during request.Verify in DevTools Network tab — request should be a fetch (Type: xhr or fetch), NOT a form-submission navigation.
config/lab.php after install:
Inspect after install for the full key list. Every key has a fluent setter on Lab (e.g. setFadeOutTime, setRedirectDelay).
lab:install is safe to re-run — won't double-patch app.js if pattern already present (reads + checks before writing).Lab:: undefined — facade alias missing. Should auto-discover; if not, run php artisan optimize:clear then php artisan package:discover --ansi..ajax-submit-button clicks do nothing — JS not built; run npm run dev or npm run build.lab:install failed silently. Re-run lab:install and check resources/js/app.js for the Lab import lines.@alert directive renders one slot; previous content accumulates. Clear via setMessage(null) or use disableFadeOut()->setFadeOutTime(...) to control lifecycle.For a delete flow:
<x-confirm> triggers AJAX DELETE on user approval.Lab::setMessage('Deleted')->renderAlert()->asAjax().tablar-kit.confirm.toast.This is a common pattern — both packages cooperate cleanly because both expect the same JSON message key.
laravel-ajax-builder-development — full Lab method catalog (server-side fluent API).tablar-kit-confirm-modal-development — pair confirm modal with Lab responses.packages/takielias/laravel-ajax-builder/src/Lab.php, src/Commands/InstallLAB.php, resources/js/.@alert, @submit) — defer to dev skill.