Laravel Blade
Agent Workflow (MANDATORY)
Before ANY implementation, use TeamCreate to spawn 3 agents:
- fuse-ai-pilot:explore-codebase - Check existing views, components structure
- fuse-ai-pilot:research-expert - Verify latest Blade docs via Context7
- mcp__context7__query-docs - Query specific patterns (components, slots)
After implementation, run fuse-ai-pilot:sniper for validation.
Overview
Blade is Laravel's templating engine. It provides a clean syntax for PHP in views while compiling to pure PHP for performance.
| Component Type |
When to Use |
| Anonymous |
Simple UI, no logic needed |
| Class-based |
Dependency injection, complex logic |
| Layout |
Page structure, reusable shells |
| Dynamic |
Runtime component selection |
Critical Rules
- Always escape output - Use
{{ }} not {!! !!} unless absolutely necessary
- Use @props - Declare expected props explicitly
- Merge attributes - Allow class/attribute overrides with
$attributes->merge()
- Prefer anonymous - Use class components only when logic is needed
- Use named slots - For complex layouts with multiple content areas
- CSRF in forms - Always include
@csrf in forms
Decision Guide
Component Type Selection
Need dependency injection?
├── YES → Class-based component
└── NO → Anonymous component
│
Need complex props logic?
├── YES → Class-based component
└── NO → Anonymous component
Layout Strategy
Simple page structure?
├── YES → Component layout (<x-layout>)
└── NO → Need fine-grained sections?
├── YES → @extends/@section
└── NO → Component layout
Key Concepts
| Concept |
Description |
Reference |
| @props |
Declare component properties |
components.md |
| $attributes |
Pass-through HTML attributes |
slots-attributes.md |
| x-slot |
Named content areas |
slots-attributes.md |
| @yield/@section |
Traditional layout inheritance |
layouts.md |
| $loop |
Loop iteration info |
directives.md |
Reference Guide
Concepts (WHY & Architecture)
| Topic |
Reference |
When to Consult |
| Components |
components.md |
Class vs anonymous, namespacing |
| Slots & Attributes |
slots-attributes.md |
Data flow, $attributes bag |
| Layouts |
layouts.md |
Page structure, inheritance |
| Directives |
directives.md |
@if, @foreach, @auth, @can |
| Security |
security.md |
XSS, CSRF, escaping |
| Vite |
vite.md |
Asset bundling |
| Advanced Directives |
advanced-directives.md |
@once, @use, @inject, @switch, stacks |
| Custom Directives |
custom-directives.md |
Blade::if, Blade::directive |
| Advanced Components |
advanced-components.md |
@aware, shouldRender, index |
| Forms & Validation |
forms-validation.md |
@error, form helpers |
| Fragments |
fragments.md |
@fragment, HTMX integration |
Templates (Complete Code)
| Template |
When to Use |
| ClassComponent.php.md |
Component with logic/DI |
| AnonymousComponent.blade.md |
Simple reusable UI |
| LayoutComponent.blade.md |
Page layout structure |
| FormComponent.blade.md |
Form with validation |
| CardWithSlots.blade.md |
Named slots pattern |
| DynamicComponent.blade.md |
Runtime component |
| AdvancedDirectives.blade.md |
@once, @use, @inject, @switch |
| CustomDirectives.php.md |
Create custom directives |
| AdvancedComponents.blade.md |
@aware, shouldRender, index |
| Fragments.blade.md |
HTMX partial updates |
Quick Reference
Anonymous Component
{{-- resources/views/components/alert.blade.php --}}
@props(['type' => 'info', 'message'])
<div {{ $attributes->merge(['class' => 'alert alert-'.$type]) }}>
{{ $message }}
</div>
Class Component
// app/View/Components/Alert.php
class Alert extends Component
{
public function __construct(
public string $type = 'info',
public string $message = ''
) {}
public function render(): View
{
return view('components.alert');
}
}
Named Slots
<x-card>
<x-slot:header class="font-bold">
Title
</x-slot>
Content goes here
<x-slot:footer>
Footer content
</x-slot>
</x-card>
Attribute Merging
@props(['disabled' => false])
<button {{ $attributes->merge([
'type' => 'submit',
'class' => 'btn btn-primary'
])->class(['opacity-50' => $disabled]) }}
@disabled($disabled)
>
{{ $slot }}
</button>
Best Practices
DO
- Use
@props to document expected props
- Use
$attributes->merge() for flexibility
- Prefer anonymous components for simple UI
- Use named slots for complex layouts
- Keep components focused and reusable
DON'T
- Use
{!! !!} without sanitization
- Forget
@csrf in forms
- Put business logic in Blade templates
- Create deeply nested component hierarchies
- Hardcode classes (allow overrides)
1---2name: laravel-blade-33description: Create Blade templates with components, slots, layouts, and directives. Use when building views, reusable components, or templating.4metadata:5 source: https://skillmd.com/skills/fusengine/laravel-blade-36---78# Laravel Blade910## Agent Workflow (MANDATORY)1112Before ANY implementation, use `TeamCreate` to spawn 3 agents:13141. **fuse-ai-pilot:explore-codebase** - Check existing views, components structure152. **fuse-ai-pilot:research-expert** - Verify latest Blade docs via Context7163. **mcp__context7__query-docs** - Query specific patterns (components, slots)1718After implementation, run **fuse-ai-pilot:sniper** for validation.1920---2122## Overview2324Blade is Laravel's templating engine. It provides a clean syntax for PHP in views while compiling to pure PHP for performance.2526| Component Type | When to Use |27|----------------|-------------|28| **Anonymous** | Simple UI, no logic needed |29| **Class-based** | Dependency injection, complex logic |30| **Layout** | Page structure, reusable shells |31| **Dynamic** | Runtime component selection |3233---3435## Critical Rules36371. **Always escape output** - Use `{{ }}` not `{!! !!}` unless absolutely necessary382. **Use @props** - Declare expected props explicitly393. **Merge attributes** - Allow class/attribute overrides with `$attributes->merge()`404. **Prefer anonymous** - Use class components only when logic is needed415. **Use named slots** - For complex layouts with multiple content areas426. **CSRF in forms** - Always include `@csrf` in forms4344---4546## Decision Guide4748### Component Type Selection4950```51Need dependency injection?52├── YES → Class-based component53└── NO → Anonymous component54 │55 Need complex props logic?56 ├── YES → Class-based component57 └── NO → Anonymous component58```5960### Layout Strategy6162```63Simple page structure?64├── YES → Component layout (<x-layout>)65└── NO → Need fine-grained sections?66 ├── YES → @extends/@section67 └── NO → Component layout68```6970---7172## Key Concepts7374| Concept | Description | Reference |75|---------|-------------|-----------|76| **@props** | Declare component properties | [components.md](references/components.md) |77| **$attributes** | Pass-through HTML attributes | [slots-attributes.md](references/slots-attributes.md) |78| **x-slot** | Named content areas | [slots-attributes.md](references/slots-attributes.md) |79| **@yield/@section** | Traditional layout inheritance | [layouts.md](references/layouts.md) |80| **$loop** | Loop iteration info | [directives.md](references/directives.md) |8182---8384## Reference Guide8586### Concepts (WHY & Architecture)8788| Topic | Reference | When to Consult |89|-------|-----------|-----------------|90| **Components** | [components.md](references/components.md) | Class vs anonymous, namespacing |91| **Slots & Attributes** | [slots-attributes.md](references/slots-attributes.md) | Data flow, $attributes bag |92| **Layouts** | [layouts.md](references/layouts.md) | Page structure, inheritance |93| **Directives** | [directives.md](references/directives.md) | @if, @foreach, @auth, @can |94| **Security** | [security.md](references/security.md) | XSS, CSRF, escaping |95| **Vite** | [vite.md](references/vite.md) | Asset bundling |96| **Advanced Directives** | [advanced-directives.md](references/advanced-directives.md) | @once, @use, @inject, @switch, stacks |97| **Custom Directives** | [custom-directives.md](references/custom-directives.md) | Blade::if, Blade::directive |98| **Advanced Components** | [advanced-components.md](references/advanced-components.md) | @aware, shouldRender, index |99| **Forms & Validation** | [forms-validation.md](references/forms-validation.md) | @error, form helpers |100| **Fragments** | [fragments.md](references/fragments.md) | @fragment, HTMX integration |101102### Templates (Complete Code)103104| Template | When to Use |105|----------|-------------|106| [ClassComponent.php.md](references/templates/ClassComponent.php.md) | Component with logic/DI |107| [AnonymousComponent.blade.md](references/templates/AnonymousComponent.blade.md) | Simple reusable UI |108| [LayoutComponent.blade.md](references/templates/LayoutComponent.blade.md) | Page layout structure |109| [FormComponent.blade.md](references/templates/FormComponent.blade.md) | Form with validation |110| [CardWithSlots.blade.md](references/templates/CardWithSlots.blade.md) | Named slots pattern |111| [DynamicComponent.blade.md](references/templates/DynamicComponent.blade.md) | Runtime component |112| [AdvancedDirectives.blade.md](references/templates/AdvancedDirectives.blade.md) | @once, @use, @inject, @switch |113| [CustomDirectives.php.md](references/templates/CustomDirectives.php.md) | Create custom directives |114| [AdvancedComponents.blade.md](references/templates/AdvancedComponents.blade.md) | @aware, shouldRender, index |115| [Fragments.blade.md](references/templates/Fragments.blade.md) | HTMX partial updates |116117---118119## Quick Reference120121### Anonymous Component122123```blade124{{-- resources/views/components/alert.blade.php --}}125@props(['type' => 'info', 'message'])126127<div {{ $attributes->merge(['class' => 'alert alert-'.$type]) }}>128 {{ $message }}129</div>130```131132### Class Component133134```php135// app/View/Components/Alert.php136class Alert extends Component137{138 public function __construct(139 public string $type = 'info',140 public string $message = ''141 ) {}142143 public function render(): View144 {145 return view('components.alert');146 }147}148```149150### Named Slots151152```blade153<x-card>154 <x-slot:header class="font-bold">155 Title156 </x-slot>157158 Content goes here159160 <x-slot:footer>161 Footer content162 </x-slot>163</x-card>164```165166### Attribute Merging167168```blade169@props(['disabled' => false])170171<button {{ $attributes->merge([172 'type' => 'submit',173 'class' => 'btn btn-primary'174])->class(['opacity-50' => $disabled]) }}175 @disabled($disabled)176>177 {{ $slot }}178</button>179```180181---182183## Best Practices184185### DO186- Use `@props` to document expected props187- Use `$attributes->merge()` for flexibility188- Prefer anonymous components for simple UI189- Use named slots for complex layouts190- Keep components focused and reusable191192### DON'T193- Use `{!! !!}` without sanitization194- Forget `@csrf` in forms195- Put business logic in Blade templates196- Create deeply nested component hierarchies197- Hardcode classes (allow overrides)