Skip to main content

Environments

Environments let you manage different configurations for development, staging, and production.

Overview

Creating an Environment

  1. Click the Settings icon next to the environment selector
  2. Go to the Environments tab
  3. Click Add Environment
  4. Enter:
    • Name: e.g., "Development"
    • Color: Visual identifier

Switching Environments

Use the environment dropdown in the header to switch:

  1. Click the current environment name
  2. Select the desired environment
  3. All requests will use the new environment's variables

Environment Variables

Each environment can have its own variables:

Development

VariableValue
API_URLhttp://localhost:3000
DEBUGtrue

Staging

VariableValue
API_URLhttps://staging.example.com
DEBUGtrue

Production

VariableValue
API_URLhttps://api.example.com
DEBUGfalse

Variable Resolution

When you use {{API_URL}}:

  1. Check current environment for API_URL
  2. If not found, check global variables
  3. If still not found, leave as {{API_URL}}

Example

Global: API_URL = https://default.example.com
Development: API_URL = http://localhost:3000
Production: (not set)
Environment{{API_URL}} resolves to
Developmenthttp://localhost:3000
Productionhttps://default.example.com
No environmenthttps://default.example.com

Managing Environments

Editing

  1. Go to Environments tab
  2. Click on an environment
  3. Modify name, color, or variables

Duplicating

Right-click an environment and select Duplicate to create a copy with all variables.

Deleting

Click the trash icon to remove an environment. This doesn't affect global variables.

Color Coding

Each environment has a color for quick identification:

  • Development (Green)
  • Staging (Yellow)
  • Production (Red)

The color appears:

  • In the environment selector
  • Next to variable badges in inputs

Workflow Example

Setup

  1. Create three environments: Dev, Staging, Prod
  2. Add environment-specific variables:
# Development
API_URL = http://localhost:3000
DATABASE = dev_db

# Staging
API_URL = https://staging.api.com
DATABASE = staging_db

# Production
API_URL = https://api.com
DATABASE = prod_db

Usage

  1. Develop and test with Development environment
  2. Test integration with Staging environment
  3. Verify production with Production environment

All requests use the same variable names, only values change.

Best Practices

Consistent Variables

Keep variable names consistent across environments. Only values should differ.

Production Safety

Use distinct colors (red) for production to prevent accidental requests.

Secrets per Environment

Each environment can have different API keys, tokens, etc.

Common Setup

VariableDevelopmentStagingProduction
API_URLlocalhost:3000staging.api.comapi.com
DEBUGtruetruefalse
LOG_LEVELdebuginfoerror
API_KEYdev-keystg-keyprod-key