Add Your First App

An app represents a single iOS, macOS, Android, Flutter, or React Native project. Each app has its own pipeline configuration, variables, signing settings, and build history.

What is an App?

An app in RunnerHub is:

• A single mobile or desktop application project
• Connected to a Git repository (one per provider: GitHub, GitLab, or Bitbucket)
• Home to pipeline configuration and secrets
• The unit of organization for CI/CD settings
• Separate from other apps in the same workspace (but they can share workspace-level variables and signing credentials)

Most teams have one app per repository. However, you can connect multiple apps to the same repository — useful for white-label apps that share a codebase but have different configurations, variables, and signing settings.

Create an App

1. Go to your workspace — Sign in to app.runnerhub.net and select your workspace
2. Click “Create App” in the Apps tab of your workspace
3. Fill in the app details:
   • App name — Something descriptive like “My Cool App” or “iOS-Main”
   • Platform — Choose iOS, macOS, Android, Flutter, or React Native

     • Note

       All platforms are fully supported with code signing and deploy integrations.

4. Click Create

Your app is now created and ready for configuration.

Tip

You can rename or delete your app later in App Settings. Deleting an app does not delete your repository or build history.

App-Level Features

Once your app is created, you can access the following tabs:

Overview

• View recent builds and build history
• See logs, artifacts, and timing information
• Re-run previous builds

Cloud YAML (feature-flagged)

• Optionally store pipeline config in the dashboard instead of in your repository (useful for testing without committing)

Deploy (feature-flagged)

• Configure deploy targets and settings

Environment

• Define app-specific environment variables
• Distinct from workspace-level variables
• Useful for app-specific secrets, API keys, or bundle identifiers
• Learn more in the variables guide

Schedules (feature-flagged)

• Create scheduled builds for nightly tests, weekly releases, or performance benchmarks
• Define triggers and frequency

Code Signing

• Choose how code signing is handled for this app
• Use automatic signing (PAYG+ plans) or manual certificates
• Set bundle identifier and signing type (automatic, manual, app-store)
• Learn more in the Apple code signing guide

Note

Cloud YAML, Deploy, and Schedules are feature-flagged and may not be visible to all users.

Next Steps

Now that your app is created:

1. Connect a repository — Link your GitHub, GitLab, or Bitbucket repo so RunnerHub can access your code (guide →)
2. Write your first pipeline — Create .runnerhub/runnerhub.yml in your repository root (guide →)
3. Push to trigger — Commit and push to your main branch to start your first build

Note

If you’re coming from GitHub Actions, GitLab CI, or similar platforms, the concept of an “app” is similar to a repository. One repository = typically one app in RunnerHub.