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 from the sidebar
2. Click “Create App” or “New App”** — Usually found in the sidebar or at the top of the Apps list
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 configure:

Pipeline Configuration

• YAML Settings — Upload your .runnerhub/runnerhub.yml directly to RunnerHub, or have it read from your repository
• Cloud YAML — Optionally store pipeline config in the dashboard instead of in your repository (useful for testing without committing)

Variables

• 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

Signing Configuration

• 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

Schedules

• Create scheduled builds for nightly tests, weekly releases, or performance benchmarks
• Define triggers and frequency
• Schedules are configured in the dashboard under App → Schedules

Build History

• View all builds (successful, failed, and in-progress)
• See logs, artifacts, and timing information
• Re-run previous builds

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.