Skip to content

Getting Started

In this guide, you will learn how to create your first native build using Capawesome Cloud Native Builds.

Prerequisites

Before you begin, ensure you have:

  • A Capawesome Cloud account and organization.
  • A Capacitor app in a Git repository.

Step 1: Create an App

To identify your app in Capawesome Cloud, you need to create an app in the console. If you have already created an app, you can skip this step and proceed to Step 2.

To create an app using the Capawesome CLI, use the apps:create command:

npx @capawesome/cli apps:create

You will be prompted to select the organization you want to create the app in and to provide a name for the app. The CLI will then create the app.

To create an app using the Capawesome Cloud Console, select the organization you want to create the app in and click on the "Create App" button.

Step 2: Connect Git Repository

Before you can create native builds, you need to connect your Git repository to Capawesome Cloud. This allows the build service to access your source code and build your app.

Follow these steps to connect your repository:

  1. Navigate to the Git page of your app in the Capawesome Cloud Console.
  2. In the Git Providers section, select your Git provider (GitHub, GitLab, Bitbucket, etc.) and click Connect to authorize Capawesome Cloud to access your account. If you've already connected a provider, you can skip this step.
  3. In the Git Repositories section, select your Git provider from the dropdown, choose the repository owner, and select the repository you want to connect.
  4. Click Save to finalize the connection.

Your Git repository is now connected to Capawesome Cloud and ready for building.

Step 3: Trigger First Build

Once your Git repository is connected, you can trigger your first build:

  1. Navigate to the Builds page of your app in Capawesome Cloud.
  2. Click on the Build from Git button.
  3. Select the Git reference (branch, tag, or commit) you want to build from.
  4. Select the Platform (iOS or Android) and Build Type. Choose Debug or Simulator for initial testing.
  5. Click on Build to start the build process.

Wait for the build to complete. You can monitor the build progress in the build details page and download the build artifact once it's finished.

Congratulations! You have successfully created your first native build using Capawesome Cloud. 🎉

Next Steps

Now that you have Native Builds set up, explore the following guides to make the most out of it.

  • Build Types

    Learn about different build types available for iOS and Android platforms.

    Build Types

  • Certificates

    Set up signing certificates for production builds on iOS and Android.

    Certificates

  • Configuration

    Configure build settings and customize your build process.

    Configuration

  • Troubleshooting

    Find solutions to common issues and learn how to debug build problems.

    Troubleshooting