The Complete Production SOP: How to Deploy and Run Meilisearch Fast Typo-Tolerant Fulltext Search in Autonomous AI Agents

---
name: "meilisearch-typo-tolerant-search"
description: "Implement instant, typo-tolerant search-as-you-type in frontend and backend applications."
metadata:
  author: "Meilisearch"
  version: "1.0.0"
  runtime_compatibility:
    - "codex"
    - "claude-code"
    - "cursor"
    - "windsurf"
triggers:
  - "setup meilisearch index"
  - "configure meilisearch ranking rules"
  - "generate meilisearch tenant token"
permissions:
  fs_read: true
  fs_write: "workspace"
  shell_exec: false
  net_access: false
---

import { MeiliSearch } from 'meilisearch';

if (!process.env.MEILISEARCH_HOST || !process.env.MEILISEARCH_ADMIN_API_KEY) {
  throw new Error('Missing Meilisearch environment variables');
}

export const meiliClient = new MeiliSearch({
  host: process.env.MEILISEARCH_HOST,
  apiKey: process.env.MEILISEARCH_ADMIN_API_KEY,
});

import { meiliClient } from '../lib/meilisearch';

export async function setupProductsIndex() {
  const index = meiliClient.index('products');
  
  // Configure searchable, filterable, and sortable attributes
  const updateSettingsTask = await index.updateSettings({
    searchableAttributes: ['title', 'description', 'brand'],
    filterableAttributes: ['category', 'in_stock', 'tenant_id'],
    sortableAttributes: ['price', 'created_at'],
    rankingRules: [
      'words',
      'typo',
      'proximity',
      'attribute',
      'sort',
      'exactness'
    ],
    typoTolerance: {
      enabled: true,
      minWordSizeForTypos: {
        oneTypo: 4,
        twoTypos: 8
      }
    }
  });

  await meiliClient.waitForTask(updateSettingsTask.taskUid);
  console.log('Meilisearch index successfully configured.');
}

import { describe, it, expect } from 'vitest';
import { meiliClient } from '../src/lib/meilisearch';

describe('Meilisearch Indexing Verification', () => {
  it('should return highlighted hits for typo-tolerant query', async () => {
    const index = meiliClient.index('products');
    const results = await index.search('iphoen', {
      attributesToHighlight: ['title'],
      limit: 5,
    });
    expect(results.hits.length).toBeGreaterThanOrEqual(0);
    expect(results.processingTimeMs).toBeLessThan(50);
  });
});