Workflow Management

Overview

In dex, your data projects are organized to support both collaborative development and reliable production workflows, all powered by Git-native version control.

This structure allows teams to safely iterate on their data pipelines while maintaining stable, production-grade automation.

Core Concepts

The core concepts in dex follow a clear hierarchy:

Organization > Projects > Environments > Workspaces

Understanding each layer is key to managing your workflows effectively.

Concept	Description
Organization	Represents your company’s account in dex. An Organization holds one or more Projects and acts as the top-level container for everything you build.
Project	A dex Project connects directly to a Git repository. It contains your data models, ELT configurations and connectors. Each Project defines its stack (e.g., BigQuery, Athena, PostgreSQL).
Environment	A stable, remote branch of your Project’s repository. All production-grade automations, orchestration, and pipelines run on Environments.
Workspace	A local/sandboxed copy of an Environment. It allows users to edit files, run commands, and experiment without impacting production workflows. Changes are only synced back when the user pushes them to Git.

Switching Between Projects, Environments, and Workspaces

You can easily switch between different Projects, Environments, and Workspaces using the top navigation bar, as shown in the screenshot below. This allows you to move seamlessly between development, staging, and production environments or across different projects within your organization.

To create, edit, or delete Projects, Environments, and Workspaces, go to the side menu → Organization → Settings. From there, you can manage your organization’s structure, link new repositories, configure environments for automation, and create workspaces for development.

Learn more about repositories, version control, and Git integration here