React Native Template

Test, build, and distribute React Native apps for iOS and Android (beta and release).

Note: This template requires a macOS runner for iOS builds. Android builds can run on Linux runners.

Setup

Recommended: External CI/CD Configuration

Go to Settings > CI/CD > General pipelines and set CI/CD configuration file to:

https://gitlab-ci-yaml-template.enouvo.com/react-native/.gitlab-ci.yml

Alternative: Include in .gitlab-ci.yml

include:
  - 'https://gitlab-ci-yaml-template.enouvo.com/react-native/.gitlab-ci.yml'

Required Variables

Variable	Description
`GITLAB_CI_ACCESS_TOKEN`	Token to download ci-scripts (set by admin at group level)
`MATCH_GIT_URL`	Git URL for fastlane match certificates repo
`MATCH_PASSWORD`	Password for match certificates
`FASTLANE_APPLE_APPLICATION_SPECIFIC_PASSWORD`	Apple app-specific password for uploads

Optional Variables

Variable	Default	Description
`NODE_VERSION`	14.19.1	Node.js version
`YARN_CACHE_FOLDER`	~/.yarncache/...	Yarn cache directory

Pipeline Stages

test → build → notify

Build Jobs

Job	Branch	Description
`build_ios_beta`	dev, staging	Build iOS beta via TestFlight
`build_android_beta`	dev, staging	Build Android beta APK/AAB
`build_ios_release`	release	Build iOS release for App Store
`build_android_release`	release	Build Android release for Play Store

Skip Variables

SKIP_TEST=true
SKIP_IOS_BUILD=true
SKIP_ANDROID_BUILD=true

Project Structure

react-native-app/
├── ios/
│   ├── fastlane/
│   │   ├── Fastfile
│   │   └── Matchfile
│   └── ...
├── android/
│   ├── fastlane/
│   │   └── Fastfile
│   └── ...
├── package.json
└── .gitlab-ci.yml