CONFIGURATION GUIDE

Configuring Codemagic

Let's set up Codemagic - your automated build and deployment platform. Codemagic connects directly to your GitHub repository and handles your app's entire build pipeline using their cloud-based build machines.

Why Codemagic? 🎯

We've chosen Codemagic as our CI/CD platform for several key reasons:

1. Isolated Build Environment

   • Your builds run in a clean, isolated environment
   • This ensures your project is properly configured and can run on any machine
   • No more "it works on my machine" problems!

2. Automated App Store Deployment

   • Push your code to a GitHub branch
   • Codemagic automatically builds and deploys to both app stores
   • No manual build process or store uploads needed

3. Shorebird Integration

   • Seamlessly integrates with Shorebird for automatic patch deployment
   • Push a fix, and your users get it instantly

While Codemagic does have associated costs, it's an invaluable investment if you're serious about app development. The time saved on manual builds and deployments, combined with the reliability of isolated builds, makes it the clear choice for professional app development.

Getting Your Codemagic API Key

Tutorial Video

Video recording in progress. Available soon.

First, we'll need to give Codika the ability to communicate with your Codemagic account. Here's how to set that up:

1. Navigate to the Teams tab and click on your Personal Account
2. Locate the Integrations section
3. Scroll down to the Codemagic API at the bottom
4. Click Show and copy your API key
5. Let's tell Codika about this key using the configure command:

   codika configure codemagic-api-key
6. Paste your API key and press Enter

Info

For your security, this API key will be stored encrypted in your local machine's .codika/config/codika.yaml file. We never store or transmit your API keys - they remain solely on your device, encrypted for maximum security.

Creating Your Codemagic Team

Tutorial Video

Video recording in progress. Available soon.

While you could use your personal account, we recommend setting up a dedicated team for better organization. Here's how:

1. Head to the Teams section in Codemagic
2. Click the Create Team button
3. Name your team and click Next
4. Tell Codika about your team name by entering both the name and the team id:

   codika configure codemagic-teams

Free Codemagic account

If you prefer not to add payment info right now, you can stick with your personal account. In that case, you don't need to configure the team in Codika.

What's Next?

Great! With Codemagic configured, we're ready to move on to setting up your Apple Developer account credentials. This will enable us to deploy your apps to the App Store seamlessly.