Gamma Multi-Environment Setup

Contents

• Overview
• Prerequisites
• Instructions
• Output
• Error Handling
• Examples
• Resources

Overview

Configure Gamma across development, staging, and production environments with proper isolation, secrets management, and environment guards.

Prerequisites

• Separate Gamma API keys per environment
• Secret management solution (Vault, AWS Secrets Manager, etc.)
• CI/CD pipeline with environment variables
• Environment detection in application

Instructions

Step 1: Create Environment Configuration

Define per-environment settings (timeout, retries, debug mode) in a typed configuration object. Use NODE_ENV to select the active config.

Step 2: Configure Per-Environment API Keys

Store separate API keys in .env.development, .env.staging, and .env.production files. Never commit keys to version control.

Step 3: Integrate Secret Management

For production, use AWS Secrets Manager or Vault to fetch keys at runtime with caching (5-minute TTL recommended).

Step 4: Build a Client Factory

Create a singleton factory that returns environment-aware Gamma clients. Production clients should fetch keys from secret manager; dev/staging can use env vars.

Step 5: Add Environment Guards

Implement requireProduction() and blockProduction() guards to prevent destructive operations in the wrong environment.

Step 6: Configure CI/CD

Set up GitHub Actions (or equivalent) with separate deployment jobs per environment, each using environment-specific secrets.

See detailed implementation for advanced patterns.

Output

• Environment-specific configuration files
• Secret management integration
• Client factory with environment detection
• CI/CD pipeline with environment isolation

Error Handling

Issue	Cause	Solution
Wrong API key used	Env var mismatch	Verify NODE_ENV matches key prefix
Secret fetch fails	IAM permissions	Check secrets manager access policy
Production data in dev	No env guard	Add blockProduction() guards

Examples

Environment Checklist

Check	Dev	Staging	Prod
Separate API key	Yes	Yes	Yes
Debug logging	On	On	Off
Mock mode available	Yes	Yes	No
Secret manager	No	Yes	Yes
Rate limit tier	Low	Medium	High

Resources

• Gamma Environments Guide
• 12-Factor App Config