Skip to content
RunnerHub

Create a Workspace

A workspace is the top-level container in RunnerHub. All your apps, team members, signing credentials, and workspace variables live in a workspace.

Understanding Workspaces

Section titled “Understanding Workspaces”

Think of a workspace like an organization or project folder:

  • Apps — Individual iOS, macOS, Android, Flutter, or React Native projects belong to a workspace
  • Team members — Invite colleagues to collaborate on workspace-level settings and permissions
  • Apple signing credentials — Store API keys, certificates, and profiles at the workspace level, shared across apps
  • Variables — Define workspace-level environment variables available to all apps in the workspace
  • Billing — One workspace = one billing account (unless you’re on an Enterprise plan)

Most teams start with one workspace, but you can create multiple workspaces if needed (e.g., separate workspaces for production and staging environments, or for different business units).

Create Your First Workspace

Section titled “Create Your First Workspace”
  1. Log in to the dashboard — Go to app.runnerhub.net and sign in
  2. Click “Create Workspace” — Look for this option in the left sidebar or at the top of the page if you haven’t created a workspace yet
  3. Enter a workspace name — Use something descriptive like “My Team”, “Acme Inc”, or “Product Engineering”
  4. Choose your plan — Select Free (500 min/month), Pay-as-you-go, Pro, or Business
  5. Click Create

Your workspace is now active and you can start adding apps.

Workspace Settings

Section titled “Workspace Settings”

Once your workspace is created, you can access settings from the left sidebar:

General

  • Workspace name
  • Workspace ID
  • Plan and billing information
  • Delete workspace (care required)

Apple Signing

  • Store your Apple API key (issued from Apple App Store Connect)
  • Upload or manage Apple signing certificates
  • Learn more in the Apple code signing guide

Variables

  • Define workspace-level environment variables
  • These are available to all apps in the workspace
  • Useful for shared secrets, API endpoints, or team preferences
  • Learn more in the variables guide

Team & Members

  • Invite team members to your workspace
  • Manage permissions and roles (Owner, Admin, Member, Viewer)
  • Available on Pay-as-you-go, Pro, and Business plans
  • Learn more in the team management guide

Common Workspace Setups

Section titled “Common Workspace Setups”

Solo Developer

  • One workspace, one app (or a few apps)
  • Free or Pay-as-you-go plan
  • No team members needed

Small Team (2–5 people)

  • One workspace for all projects
  • Pay-as-you-go or Pro plan for team collaboration
  • Invite team members with appropriate roles

Multiple Products

  • One workspace per product or business unit
  • Each workspace has its own billing
  • Workspaces can be managed by different teams

Staging & Production

  • Separate workspaces for staging and production
  • Different signing credentials per environment
  • Independent scaling and billing

Next Steps

Section titled “Next Steps”

Now that your workspace is created:

  1. Add your first app — Create an app to represent your iOS/macOS project (guide →)
  2. Connect a repository — Link your GitHub, GitLab, or Bitbucket repo (guide →)
  3. Set up Apple signing (optional for now) — Store your signing credentials (guide →)