Project Environments

Understanding Project Environments

Each project can have its own set of environments with different variable values. This allows you to easily switch between Development, Staging, and Production without changing your endpoint configurations.

Project-Scoped

Project environments are separate from global environments. They're specific to each project and don't affect other projects or Box requests.

Project vs Global Environments

Project Environments
  • •Specific to one project
  • •Managed in project's Environments panel
  • •Used by project endpoints
  • •Can override global variables
Global Environments
  • •Available everywhere
  • •Managed in sidebar dropdown
  • •Used by Box and regular requests
  • •Can be shared with projects (via merge)

Accessing Project Environments

To open the Environments panel for a project:

1

Open Project Menu

Click the three-dot menu (⋮) next to the project name.

2

Select "Environments"

Click the "Environments" option in the dropdown.

3

Modal Opens

A modal opens with environment management.

Environments Modal

The modal shows the environment list. Select an environment to manage its variables.

Environments
Order API
✕
DevelopmentActive
Staging
Production
Variables
baseUrl3 envs
apiKey3 envs

Managing Environments

Add Environment

Click "Add Environment" and enter a name (e.g., "Development", "Staging", "Production"). The new environment is created with all existing variables set to empty values.

Set Active Environment

Click an environment to make it active. The active environment is marked with a green dot. All project endpoints will use values from the active environment.

Rename Environment

Hover over an environment and click the edit icon to rename it.

Delete Environment

Hover over an environment and click the delete icon to remove it. A confirmation dialog appears. All variable values for this environment are lost.

Managing Variables

Variables are defined once but have different values for each environment.

Add Variable

Click "+ Add" in the Variables section. A modal opens where you can:

  • • Enter the variable name
  • • Set a value for each environment
Add Variable
Variable Name
baseUrl
Development
http://localhost:3000
Staging
https://staging.api.example.com
Production
https://api.example.com
Edit Variable

Click a variable name in the list to edit its values across all environments.

Delete Variable

Click the delete icon next to a variable to remove it from all environments.

Using Variables in Endpoints

Reference project environment variables using the same double-curly-brace syntax:

URL:
{{baseUrl}}/api/users
Header:
Authorization: Bearer {{apiKey}}

When you send a request, Tigrister replaces {{baseUrl}}with the value from the active environment.

Environment Resolution Modes

Projects can use different strategies for resolving variables. Configure this in Settings → Projects.

ModeBehaviorUse Case
projectOnly project environment variablesIsolated projects with their own variables
mergeProject variables override global variablesShare common variables, override specific ones
globalOnly global environment variablesProjects that don't need their own variables

Merge Mode Example

If global has apiKey=global123 and project has apiKey=project456, the project value wins. But a global-only variable like commonHeader is still available.

Environment Tips

💡Consistent Naming

Use consistent environment names across projects (Development, Staging, Production) to make switching easier.

💡Base URL Variable

Always create a baseUrl variable. Use it in all endpoint URLs for easy environment switching.

💡Sensitive Data

Store API keys and tokens in environment variables instead of hardcoding them in requests.

💡Test Locally First

Use Development environment for local testing before switching to Staging or Production.

EndpointsServers