#Organization Structure

Zephyr Cloud organizes your deployments using three levels: Organizations, Projects, and Applications.

#Overview

• Organizations - Based on your Git provider
• Projects - Groups of related applications from monorepos
• Applications - Individual deployable apps

#Organizations

Organizations are automatically created from your Git repository's origin.

#How Organizations Are Created

Zephyr determines your organization using this order:

1. Git Organization Name - GitHub/GitLab organization or group name
2. Repository Owner - Falls back to repository owner username
3. Custom Git Providers - Handles self-hosted Git instances

Examples:

• github.com/acme-corp/my-repo → Organization: acme-corp
• gitlab.company.com/frontend-team/project → Organization: company-com
• git.internal.company.com/web-platform/apps → Organization: internal-company-com

#Projects

Projects are automatically created from your Git repository name. All applications from the same repository are grouped under one project.

#What Projects Enable

• Configure which applications deploy to which cloud integrations
• Bulk update deployment settings
• Coordinate environment promotions
• Share environment variables and secrets
• Manage team access for multiple applications

#Example Structure

Organization: acme-corp
�� Project: ecommerce-platform
    �� Application: header-component
    �� Application: product-catalog
    �� Application: shopping-cart
    �� Application: checkout-flow

#Applications

Applications are individual deployable units. Each application has its own build output and can be deployed and versioned independently.

#Application Features

• Independent deployment - Own build and deployment lifecycle
• Version management - Independent versioning with tags and environments
• Dependency resolution - Can consume other applications as remote dependencies
• Custom environments - Staging, production, and feature branch environments

#Per-Application Configuration

Each application can have:

• Different cloud deployment targets
• Unique build settings and bundler configurations
• Independent access controls
• Custom domain configurations

#How It Works in the Dashboard

The dashboard follows this hierarchy:

1. Organization View - All projects and recent activity
2. Project View - Applications in a project, shared settings
3. Application View - Detailed management, versions, and deployments