Appollo is a tool to help developers setup and release their Flutter apps on iOS. Thanks for checking it out.
Appollo is a CLI utility developed in Python. It is easily installed with pip.
pip install appollo
To start using Appollo simply run appollo
in your console.
Start by creating an account
appollo signup
Your Appollo account is now created and you can either start a build machine in configuration mode : to configure XCode or test your app in the iOS simulator.
appollo build start --build-type configuration
Or you can build an IPA or release your app by linking your Apple Developer Account to Appollo and creating an app identifier
appollo apple add --apple-id APPLE_TEAM_ID --name TEXT --key-id APPLE_KEY_ID --issuer-id APPLE_ISSUER_ID --private-key LOCATION_APPLE_PRIVATE_KEY appollo app mk --name MY_APP_NAME --bundle-id COM.COMPANY.APP_NAME
To create the IPA to install on a physical device for testing purposes
appollo build start --build-type ad-hoc appollo build ipa
To publish directly to the App Store
appollo build start --build-type publication
Your build failed ? No worries, you can check the logs with
appollo build logs
All documentation is in the docs
directory and online at https://appollo.readthedocs.io/.
If you are getting started this is how we recommend you use the docs :
- First read our installation instructions.
- Next, check how to setup your app with Appollo at and build your Flutter app to iOS .
- Finally, if you want to know every option Appollo has to offer check our reference guide
Our mission is to reduce the time it takes to setup, build and release Flutter apps on iOS to the bare minimum.
The tool allows developers working alone or in teams and on multiple OS (Linux, Windows, MacOS) to build and publish their apps easily to the app store.
What can Appollo be used for ?
- It allows you to setup the XCode project on a remote MacOS machine if you do not own one.
- It manages common iOS specific settings for your team : certificates, devices, provisioning profiles, bundle IDs, Xcode configuration files, ...
- It builds your Flutter app on remote iOS machines.
- It hosts the iOS app artifacts or publish them to the App Store.
Thank you for considering contributing to Appollo. The main purpose of this repository is to continue evolving Appollo to make Flutter developer's lives easier.
Please report improvements, bugs and issues to Github's issue tracker. Pull requests linked to open issues are even more appreciated.
Appollo's GitHub issue tracker is not intended to provide help or support. For that check out our discord.
We are also thrilled to receive a variety of other contributions including:
- Documentation updates, enhancements, designs, or bugfixes.
- Spelling or grammar fixes.
- Blogging, speaking about, or creating tutorials about Appollo.
Giving Appollo a Github star is much appreciated by our team ! Sharing our project with other Flutter developers is too :)