How do I add and configure my app on Codemagic?
Last updated: August 14, 2026
Context
If you want to build your app using Codemagic, you first need to add your application to the platform and configure your build workflow. This applies to Flutter apps as well as other types of mobile applications.
Answer
Follow these steps to get your app set up on Codemagic:
Connect your Git repository: Add your application to Codemagic by connecting your Git repository. Follow the steps for your specific Git provider here: https://docs.codemagic.io/getting-started/adding-apps/
Select your app type: Select your project platform e.g. Flutter, React Native, Native iOS, etc.
Configure your build workflow: You have two options for configuring your builds:
Workflow Editor: Flutter only. Configure your workflow directly from the Codemagic UI — no additional files required.
codemagic.yaml: Create a
codemagic.yamlfile in the root of your repository and configure your workflow using the guide here: https://docs.codemagic.io/yaml-basic-configuration/yaml-getting-started/
Both Flutter and non-Flutter apps can use the codemagic.yaml configuration approach. If you run into any issues during setup, feel free to reach out for further assistance.