Workspace Management

Overview

A workspace is the primary organizational unit in RunnerHub. It contains your apps, environment variables, signing credentials, and all associated jobs and artifacts.

Resource Hierarchy

RunnerHub organizes resources in a clear hierarchy:

User
└── Workspace
    ├── Apple Signing Credentials
    ├── Workspace Variables
    └── App
        ├── Build Configuration
        ├── Environment Variables
        ├── Schedules
        └── Jobs & Artifacts

Each user can create multiple workspaces, and each workspace can contain multiple apps. This allows you to organize projects by team, client, or any logical grouping that works for your workflow.

Creating a Workspace

To create a new workspace:

1. Navigate to Dashboard → Workspaces
2. Click Create Workspace
3. Enter a workspace name (e.g., “Mobile Team”, “Client A Projects”)
4. Click Create

Your workspace is now ready. You can immediately start adding apps and configuring build settings.

Workspace Features

Apple Code Signing

Each workspace can have one Apple signing configuration that applies to all apps within it. This centralized configuration includes:

• Apple ID credentials (API key)
• Development & distribution certificates
• Provisioning profiles
• Team identifiers

Tip

Apps within the same workspace can share the same signing configuration, eliminating the need to upload certificates multiple times.

Workspace Variables

Define environment variables at the workspace level that are available to all apps within that workspace. These are useful for:

• Build settings shared across multiple projects
• API endpoints or base URLs
• Feature flags
• Shared credentials (with encryption)

Access workspace variables in your pipeline using standard environment variable syntax:

steps:
  - name: Build with shared config
    run: |
      echo $SHARED_API_KEY
      echo $BUILD_ENVIRONMENT

Resource Limits by Plan

The number of workspaces available depends on your subscription:

Plan	Workspaces
Free	1
Pay-As-You-Go	3
Pro	Unlimited
Business	Unlimited

Managing Workspaces

Rename a Workspace

1. Open the workspace
2. Navigate to Workspaces → [workspace] → Settings tab
3. Click the edit icon next to the workspace name
4. Enter the new name and save

Delete a Workspace

Caution

Deleting a workspace is permanent. All apps, build history, and configuration will be removed. This cannot be undone.

1. Open the workspace
2. Navigate to Workspaces → [workspace] → Settings tab
3. Scroll to the danger zone
4. Click Delete Workspace
5. Confirm the deletion by typing the workspace name

Soft Deletion & Data Retention

Deleted workspaces are soft-deleted: hidden from your dashboard and excluded from usage calculations, but data is retained in the database. Contact support@runnerhub.net to permanently delete or recover deleted workspace data.

Workspace Settings

Access workspace settings at Workspaces → [Workspace Name] → Settings tab.

Available tabs:

Settings Tab

• Workspace name and ID (for API usage)
• Created date
• Delete workspace option

Environment Variables Tab

• Workspace-level environment variables available to all apps

Best Practices

Tip

Organize workspaces by logical boundaries: one workspace per team, client, or major product. This makes permission management and billing tracking much clearer.

• One workspace per team/client: Simplifies permissions and billing allocation
• Use consistent naming: Include the team or project name in workspace titles
• Set up workspace variables early: Reduce duplication by centralizing shared settings
• Review billing monthly: Monitor usage trends to anticipate plan upgrades
• Archive unused workspaces: Delete workspaces for completed projects to keep your dashboard clean