Environment Creation

Role: Project Manager | Solution Architect 🏗️

An Environment is a specific deployment environment of a System (Development, Staging, Production, etc.). Environments must be created first because they are prerequisites for assigning Features, Configs, and API Specs to the correct environment.

How to use

1. In System Management, select the System you want to configure from the left list.
2. Switch to the "Environments" tab.

---

Create a new Environment

1. Click the "New" button (+ icon) in the top-right corner of the tab.

2. The "New Environment" modal opens. Fill in the information:

   Field	Required	Notes
   Environment Name	Yes	Environment name (for example: Development, Staging, Production)
   Code	Yes	Uppercase short code (for example: DEV, STAGING, PROD)
   Description	No	Description of the environment's purpose
   Swagger URL	No	URL to the environment's swagger.json file (can be filled in later in API Specs)

3. Click "Save". The Environment card appears in the grid.

---

Identify Environments by color

Each environment is colored automatically based on its code:

Code	Color
PROD, PRODUCTION	Red
STAGING, UAT	Yellow
DEV, DEVELOPMENT	Blue
TEST, QA	Purple
Other codes	Gray

---

Manage Environments

Search: type into the "Search environments..." field to filter by name.

Sort: click the sort dropdown to sort by Name, Order, or Code; click the arrow icon to toggle ascending/descending.

Edit: click the pencil icon ✏️ on the card → update the information → click "Save".

Delete: click the trash icon 🗑️ → confirm in the "Delete Environment?" dialog. This action cannot be undone.

---

Typical Environments for a project

Environment	Code	Purpose
Development	DEV	Develop and test new features
Staging	STAGING	UAT, final checks before Production
Production	PROD	Live system serving end users

Create all environments upfront

Create at least 2–3 environments (Dev, Staging, Prod) right after creating the System — before adding Features and Configs. Reason: Features and Configs both require selecting an environment on creation; without environments, you cannot assign them.

Next step

After creating the environments, move on to 03 — Feature Creation to list the System's features.