Short map of published guides. Start with the Golden path for a linear first-hour setup, or Getting Started for concepts first.
| Guide | Purpose |
|---|---|
| Common mistakes | Evidence-led pitfalls (symptom → wrong model → fix) with links back to canonical guides. |
| Getting started | Mental model: what you configure, where sync and search live in the app. |
| Golden path | Checklist from mix.exs through first Scrypath.search/3 with inline sync. |
| Meilisearch operations | Where Meilisearch runs, provisioning sketches, recovery paths, and footguns—through a Scrypath lens. |
| Phoenix walkthrough | End-to-end Phoenix adoption: schema → context → controller → LiveView. |
| Phoenix contexts | Context-owned search and sync boundaries. |
| Phoenix controllers and JSON | JSON APIs and thin controller callers. |
| Phoenix LiveView | LiveView calling Scrypath.search/3 and related patterns. |
| Faceted search with Phoenix LiveView | Facets, filters, and catalog-style UIs. |
| Multi-index search | Federated / multi-index queries. |
| Sync modes and visibility | Inline, Oban, and manual sync semantics and what “done” means. |
| Operator Mix tasks | CLI entrypoints over Scrypath.* operator APIs. |
| Drift recovery | Operator path when DB and search disagree or work is stuck. |
| Relevance tuning | Meilisearch settings, verification, and tuning from schema declarations. |
| Per-query tuning pipeline | Request-time Meilisearch search parameters vs index-time settings — canonical merge and mapping spec. |
The runnable Phoenix example (Postgres + Meilisearch + Oban) lives under examples/phoenix_meilisearch/.