algolia-multi-env-setup

name	algolia-multi-env-setup
description	Configure Algolia across dev/staging/production: index prefixing, per-environment API keys, settings-as-code, and environment isolation guards. Trigger: "algolia environments", "algolia staging", "algolia dev prod", "algolia environment setup", "algolia config by env".
allowed-tools	Read, Write, Edit, Bash(npm:*), Bash(gcloud:*), Bash(vault:*)
version	1.7.0
license	MIT
author	Jeremy Longshore <[e-mail]>
tags	["saas","search","algolia"]
compatibility	Designed for Claude Code

Algolia Multi-Environment Setup

Overview

Algolia doesn't have built-in environment separation. You either use separate Algolia applications (strongest isolation) or index prefixing within one application (simpler). This skill covers both approaches.

Prerequisites

• Separate environment names or application credentials and a clear production promotion policy.
• CI secrets scoped to the environment that performs indexing.
• A naming convention that prevents a staging job from writing to the production index.

Environment Strategies

Strategy	Isolation	Cost	Complexity
Index prefixing	Shared app, prefixed names	Lowest	Low
Separate API keys	Shared app, scoped keys	Low	Medium
Separate applications	Full isolation	Highest	High

Instructions

Examples

The index-prefix and configuration examples below demonstrate environment isolation and controlled promotion. Keep the same convention in local tooling, CI, and runtime configuration to avoid cross-environment writes.

Step 1: Index Prefixing (Recommended for Most Teams)

// src/algolia/config.ts
import { algoliasearch, type Algoliasearch } from 'algoliasearch';

type Environment = 'development' | 'staging' | 'production';

interface AlgoliaConfig {
  appId: string;
  apiKey: string;
  searchKey: string;
  environment: Environment;
}

function ():  {
   env = (process.. || )  ;

   {
    : process..!,
    : process..!,
    : process..!,
    : env,
  };
}


  ():  {
   { environment } = ();
   (environment === )  base;  
   ;
  
}

 :  |  = ;

  ():  {
   (!_client) {
     config = ();
    _client = (config., config.);
  }
   _client;
}