setup-ci

🤔 Why?

The problem we noticed is that setting up CI is performed once, needs to be researched every time, and is often trial and error driven. The process is repetitive.

We created a tool that bootstraps CI with the most used features, which are ready for customization in the future. Running npx setup-ci generates GitHub workflows for the most popular CI tasks.

📖 Usage

Simply go to your project root directory and run:

npx setup-ci

then select the setup that matches your project - npx setup-ci generates workflows and tries to add missing configs and install necessary dependencies.

If your project has a monorepo structure, run the script from the root directory of the app for which you want to set up workflows.

[!WARNING] If you re-run npx setup-ci in the same project or already have some workflows set up manually, they might get overwritten. Therefore, we recommend running the script with no uncommitted changes, so you can easily inspect the diff after script execution.

💡 Demo

Say we want to set up GitHub actions that run Typescript and Prettier checks on our project every time we create or push to an existing Pull Request. Let's try to use npx setup-ci to do the heavy lifting and generate all the necessary configurations.

Alternatively, we can use flags --preset --ts --prettier to avoid the interactive survey at the beginning of the script. You can check the section below for more information about available flags!

⚙️ Features

• Currently, only GitHub actions are supported as your CI.
• npm and yarn are supported as package managers, and they will be detected automatically.
• Monorepo structure is supported, but make sure you run the script from the app directory, not the monorepo root.

When using npx setup-ci, you can provide additional flags to modify its default behavior.

Flag	Description
--preset	Run the script with your own preset. Combine it with feature flags to specify what workflows you want to generate.
--skip-git-check	By default, the script will prompt the user if there are uncommitted changes in the working repository. Use this flag to proceed without asking.

The following are feature flags that can be used with --preset flag (they are ignored if --preset is not provided).

Flag	Description
--lint	Generate ESLint workflow to run on every PR
--jest	Generate Jest workflow to run on every PR
--ts	Generate Typescript check workflow to run on every PR
--prettier	Generate Prettier check workflow to run on every PR
--eas	Generate Preview with EAS workflow to run on every PR (Expo projects only). The workflow uses Expo continuous-deploy-fingerprint action to publish EAS Updates and trigger EAS Builds in development profile when the fingerprint of the app changes. You can learn more with Expo documentation on EAS Build, EAS Update and Expo fingerprint. Additionally, a comment will be created in your PR with a link to the build and a QR code to scan and open the app on your device with the latest update.
--detox	Generate workflow to run Detox e2e tests on every PR
--maestro	Generate workflow to run Maestro e2e tests on every PR

🔐 Repository secrets

Some workflows generated by npx setup-ci require setting up repository secrets that can be then accessed by workflows as ${{ secrets.* }}. Make sure to read logs printed by the script as you will always be prompted to create secrets if necessary. The following table shows a summary of secrets you might have to create for generated workflows to work properly.

Secret	Description
EXPO_TOKEN	Used for authentication in workflows using your Expo account. Learn more at Expo with GitHub actions.

🔍 Troubleshooting

For known issues with npx setup-ci, please check Troubleshooting.

💬 Your feedback

[!IMPORTANT] If you have an issue using npx setup-ci, you can check Troubleshooting and Reported Bugs for a potential solution.

This tool is supposed to be helpful to as many developers as possible - and therefore we are open to your ideas and general feedback! If you want to share your opinion about npx setup-ci or have some thoughts about how it could be further developed, don't hesitate to create an issue or contact the maintainers directly.

🚸 Roadmap

• Build Expo DevClient when fingerprint changes
• Maestro support for E2E tests
• Different workflows for different branches (ex. PR, main, release)
• Upload source maps to Sentry
• Handle different vendors

📋 License

npx setup-ci is licensed under The MIT License.

💸 Credits

This project has been built and is maintained thanks to the support from Software Mansion

setup-ci is created by Software Mansion

Since 2012 Software Mansion is a software agency with experience in building web and mobile apps. We are Core React Native Contributors and experts in dealing with all kinds of React Native issues. We can help you build your next dream product – Hire us.

Changelog

0.5.0 (2024-09-23)

Bug Fixes

• adjust example maestro flow in expo projects (#113) (ded3deb)
• build dev script after name migration (#108) (08197f0)
• do not print generic error message for expected errors (#110) (46e637e)
• install typescript in eslint recipe (#97) (8214e49)
• ios app name resolution on linux (#118) (1770bb4)
• publish-dev.yml syntax error (#104) (3eaf37e)
• release workflow syntax error (#103) (c15212d)
• rename react-native-ci-cli to setup-ci after migration (#100) (b15de42)
• subprocess flaky input (#117) (e8505d4)
• use node version file in maestro and debug build workflows (#105) (887292d)

Features

• add basic integration tests (#13) (d35c96c)
• add Maestro recipe (#92) (4a125e7)
• build debug app on push to main (#107) (9e44472)
• cache dependencies between workflows (#94) (74b42dd)
• change survey to multiselect (#53) (e5709aa)
• improve EAS Update workflow to build dev client when fingerprint changes (#90) (12743c0)
• run prettier formatting on modified files (#96) (fabb744)