Laravel Scout

Agent Workflow (MANDATORY)

Before ANY implementation, use TeamCreate to spawn 3 agents:

1. •fuse-ai-pilot:explore-codebase - Analyze existing model and search patterns
2. •fuse-ai-pilot:research-expert - Verify Scout docs via Context7
3. •mcp__context7__query-docs - Check search and indexing patterns

After implementation, run fuse-ai-pilot:sniper for validation.

Overview

Decision Guide: Search Driver

Which driver?
├── Production (recommended) → Meilisearch (fast, self-hosted, free)
├── Managed service → Algolia (hosted, pay per search)
├── Small dataset → database (no extra infra)
└── Testing → collection (in-memory, no engine)

Quick Setup

composer require laravel/scout
composer require meilisearch/meilisearch-php http-interop/http-factory-guzzle

SCOUT_DRIVER=meilisearch
MEILISEARCH_HOST=http://127.0.0.1:7700
MEILISEARCH_KEY=masterKey

$results = Article::search('laravel tutorial')->paginate(15);

Critical Rules

1. •Use toSearchableArray() to control indexed data
2. •Queue indexing with SCOUT_QUEUE=true for performance
3. •Use searchable() for bulk import after setup
4. •Pause indexing during seeders with Scout::withoutSyncing()

Reference Guide

Best Practices

DO

• •Use Meilisearch for production (fast, typo-tolerant)
• •Queue indexing operations (SCOUT_QUEUE=true)
• •Limit indexed fields with toSearchableArray()

DON'T

• •Index sensitive data (passwords, tokens)
• •Forget to import existing records after setup
• •Use collection driver in production