Add

airfoil add [env | appcenter | adr | keystore | appicon]

add env

Adds ENV vars to your React Native app. Updates the following files in one go:

.env
.env.example
app/constants.ts
appcenter-pre-build.sh

Usage

airfoil add env MY_VAR=thingamajig
airfoil add env DEV=true # [true|false] infers boolean value in constants.ts
airfoil add env easyAs=abc123 # anyCase key converts to CONSTANT_CASE
airfoil add env # if args omitted -> prompts to get ENV key, value

Options

Flag	Alias	Explanation
`--boolean`	[`--bool`, `-b`]	process as boolean ENV var
`--comment`	[`-c`]	add a comment for this ENV var
`--dry`	[`-d`]	perform a dry test run (print Git diff without permanent changes)
`--verbose`	[`-v`]	print more detailed logs
`--debug`	[]	print all stdout for debugging

Rationale

Adding ENV vars is often a pain point for RN apps. In addition to updating the necessary .env file, we would often forget to also update appcenter-pre-build.sh. This would lead to a loss of 30 min, which definitely adds up.

This command makes it super easy to add new ENV vars to your RN app.

add appcenter

Adds dependencies and some boilerplate needed to set up AppCenter.

The add appcenter command makes file changes and installs dependencies based on the AppCenter Getting Started guide.

Usage

airfoil add appcenter # follow prompts

Options

Flag	Alias	Explanation
`--dry`	[`-d`]	perform a dry test run (print Git diff without permanent changes)
`--verbose`	[`-v`]	print more detailed logs
`--debug`	[]	print all stdout for debugging

Rationale

We use AppCenter at Airship to streamline our React Native deployments. Setting up AppCenter for the first time can be a little intimidating if developers haven't ever worked with ObjectiveC or Java code before.

add adr

Add an Architecture Design Record (ADR).

Usage:

airfoil add adr # follow prompts
airfoil add adr "Choose Cognito for Auth" # specify ADR title as arg1

add keystore

Add an Android keystore.

This command automatically generates credentials and generates a .keystore file, and instructs the developer as to next steps (saving credentials in password manager, etc.).

Usage:

airfoil add keystore

Rationale:

Typos and syntax errors in the Certificate Authority can lead to App Center builds not working. Automating this process removes some of the human error involved in generating keystores.

add appicon

Generate app icons for iOS and Android from a single .png file.

Usage:

First upload AppIcon.png to your project root
- File name must exactly match "AppIcon.png"
- Image must be at least 1024x1024
- Image must be square

Then run:

airfoil add appicon

Rationale:

Adding correctly-sized app icons to their appropriate places is tedious and error-prone. This command greatly simplifies this process.