algolia-prod-checklist

# Algolia Production Checklist ## Overview Complete checklist for deploying Algolia search to production. Covers index configuration, API key security, replica setup, monitoring, and rollback procedures. ## Pre-Production Checklist ### Index Configuration - [ ] `searchableAttributes` ordered by priority (first = highest) - [ ] `attributesForFaceting` set for all filterable attributes - [ ] `customRanking` configured (business metrics as tie-breakers) - [ ] `unretrievableAttributes` set for fields that should be searchable but not returned - [ ] `attributesToRetrieve` limited to fields needed by the UI - [ ] `typoTolerance` tested (default: enabled, min 4 chars for 1 typo, min 8 for 2) - [ ] `removeStopWords` configured for your language(s) - [ ] `distinct` set if deduplication needed (e.g., one result per product group) ```typescript // Verify production settings const settings = await client.getSettings({ indexName: 'products' }); console.log(JSON.stringify(settings, null, 2)); ``` ### API Key Security - [ ] Admin key in backend env vars only (never frontend) - [ ] Search-Only key used in frontend with `referers` restriction - [ ] `maxQueriesPerIPPerHour` set on all public keys - [ ] `maxHitsPerQuery` limited on search keys - [ ] Secured API keys used for multi-tenant data isolation - [ ] Keys restricted to specific `indexes` where possible ### Replicas (Alternate Sorting) ```typescript // Replicas give users alternate sort orders await client.setSettings({ index...