create-expo-module 0.3.0 → 0.4.1

package/build/utils.d.ts

@@ -0,0 +1,19 @@
+import ora from 'ora';
+export declare type StepOptions = ora.Options;
+export declare function newStep<Result>(title: string, action: (step: ora.Ora) => Promise<Result> | Result, options?: StepOptions): Promise<Result>;
+/**
+ * Finds user's name by reading it from the git config.
+ */
+export declare function findMyName(): Promise<string>;
+/**
+ * Finds user's email by reading it from the git config.
+ */
+export declare function findGitHubEmail(): Promise<string>;
+/**
+ * Get the GitHub username from an email address if the email can be found in any commits on GitHub.
+ */
+export declare function findGitHubProfileUrl(email: string): Promise<string>;
+/**
+ * Guesses the repository URL based on the author profile URL and the package slug.
+ */
+export declare function guessRepoUrl(authorUrl: string, slug: string): Promise<string>;

package/build/utils.js

@@ -0,0 +1,79 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.guessRepoUrl = exports.findGitHubProfileUrl = exports.findGitHubEmail = exports.findMyName = exports.newStep = void 0;
+const chalk_1 = __importDefault(require("chalk"));
+const cross_spawn_1 = __importDefault(require("cross-spawn"));
+const github_username_1 = __importDefault(require("github-username"));
+const ora_1 = __importDefault(require("ora"));
+async function newStep(title, action, options = {}) {
+    const disabled = process.env.CI || process.env.EXPO_DEBUG;
+    const step = (0, ora_1.default)({
+        text: chalk_1.default.bold(title),
+        isEnabled: !disabled,
+        stream: disabled ? process.stdout : process.stderr,
+        ...options,
+    });
+    step.start();
+    try {
+        return await action(step);
+    }
+    catch (error) {
+        step.fail();
+        console.error(error);
+        process.exit(1);
+    }
+}
+exports.newStep = newStep;
+/**
+ * Finds user's name by reading it from the git config.
+ */
+async function findMyName() {
+    try {
+        return cross_spawn_1.default.sync('git', ['config', '--get', 'user.name']).stdout.toString().trim();
+    }
+    catch {
+        return '';
+    }
+}
+exports.findMyName = findMyName;
+/**
+ * Finds user's email by reading it from the git config.
+ */
+async function findGitHubEmail() {
+    try {
+        return cross_spawn_1.default.sync('git', ['config', '--get', 'user.email']).stdout.toString().trim();
+    }
+    catch {
+        return '';
+    }
+}
+exports.findGitHubEmail = findGitHubEmail;
+/**
+ * Get the GitHub username from an email address if the email can be found in any commits on GitHub.
+ */
+async function findGitHubProfileUrl(email) {
+    var _a;
+    try {
+        const username = (_a = (await (0, github_username_1.default)(email))) !== null && _a !== void 0 ? _a : '';
+        return `https://github.com/${username}`;
+    }
+    catch {
+        return '';
+    }
+}
+exports.findGitHubProfileUrl = findGitHubProfileUrl;
+/**
+ * Guesses the repository URL based on the author profile URL and the package slug.
+ */
+async function guessRepoUrl(authorUrl, slug) {
+    if (/^https?:\/\/github.com\/[^/]+/.test(authorUrl)) {
+        const normalizedSlug = slug.replace(/^@/, '').replace(/\//g, '-');
+        return `${authorUrl}/${normalizedSlug}`;
+    }
+    return '';
+}
+exports.guessRepoUrl = guessRepoUrl;
+//# sourceMappingURL=utils.js.map

package/build/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":";;;;;;AAAA,kDAA0B;AAC1B,8DAAgC;AAChC,sEAA6C;AAC7C,8CAAsB;AAIf,KAAK,UAAU,OAAO,CAC3B,KAAa,EACb,MAAmD,EACnD,UAAuB,EAAE;IAEzB,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,EAAE,IAAI,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC;IAC1D,MAAM,IAAI,GAAG,IAAA,aAAG,EAAC;QACf,IAAI,EAAE,eAAK,CAAC,IAAI,CAAC,KAAK,CAAC;QACvB,SAAS,EAAE,CAAC,QAAQ;QACpB,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM;QAClD,GAAG,OAAO;KACX,CAAC,CAAC;IAEH,IAAI,CAAC,KAAK,EAAE,CAAC;IAEb,IAAI;QACF,OAAO,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;KAC3B;IAAC,OAAO,KAAK,EAAE;QACd,IAAI,CAAC,IAAI,EAAE,CAAC;QACZ,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACrB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;KACjB;AACH,CAAC;AAtBD,0BAsBC;AAED;;GAEG;AACI,KAAK,UAAU,UAAU;IAC9B,IAAI;QACF,OAAO,qBAAK,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC;KACrF;IAAC,MAAM;QACN,OAAO,EAAE,CAAC;KACX;AACH,CAAC;AAND,gCAMC;AAED;;GAEG;AACI,KAAK,UAAU,eAAe;IACnC,IAAI;QACF,OAAO,qBAAK,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC;KACtF;IAAC,MAAM;QACN,OAAO,EAAE,CAAC;KACX;AACH,CAAC;AAND,0CAMC;AAED;;GAEG;AACI,KAAK,UAAU,oBAAoB,CAAC,KAAa;;IACtD,IAAI;QACF,MAAM,QAAQ,GAAG,MAAA,CAAC,MAAM,IAAA,yBAAc,EAAC,KAAK,CAAC,CAAC,mCAAI,EAAE,CAAC;QACrD,OAAO,sBAAsB,QAAQ,EAAE,CAAC;KACzC;IAAC,MAAM;QACN,OAAO,EAAE,CAAC;KACX;AACH,CAAC;AAPD,oDAOC;AAED;;GAEG;AACI,KAAK,UAAU,YAAY,CAAC,SAAiB,EAAE,IAAY;IAChE,IAAI,+BAA+B,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE;QACnD,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAClE,OAAO,GAAG,SAAS,IAAI,cAAc,EAAE,CAAC;KACzC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAND,oCAMC","sourcesContent":["import chalk from 'chalk';\nimport spawn from 'cross-spawn';\nimport githubUsername from 'github-username';\nimport ora from 'ora';\n\nexport type StepOptions = ora.Options;\n\nexport async function newStep<Result>(\n  title: string,\n  action: (step: ora.Ora) => Promise<Result> | Result,\n  options: StepOptions = {}\n): Promise<Result> {\n  const disabled = process.env.CI || process.env.EXPO_DEBUG;\n  const step = ora({\n    text: chalk.bold(title),\n    isEnabled: !disabled,\n    stream: disabled ? process.stdout : process.stderr,\n    ...options,\n  });\n\n  step.start();\n\n  try {\n    return await action(step);\n  } catch (error) {\n    step.fail();\n    console.error(error);\n    process.exit(1);\n  }\n}\n\n/**\n * Finds user's name by reading it from the git config.\n */\nexport async function findMyName(): Promise<string> {\n  try {\n    return spawn.sync('git', ['config', '--get', 'user.name']).stdout.toString().trim();\n  } catch {\n    return '';\n  }\n}\n\n/**\n * Finds user's email by reading it from the git config.\n */\nexport async function findGitHubEmail(): Promise<string> {\n  try {\n    return spawn.sync('git', ['config', '--get', 'user.email']).stdout.toString().trim();\n  } catch {\n    return '';\n  }\n}\n\n/**\n * Get the GitHub username from an email address if the email can be found in any commits on GitHub.\n */\nexport async function findGitHubProfileUrl(email: string): Promise<string> {\n  try {\n    const username = (await githubUsername(email)) ?? '';\n    return `https://github.com/${username}`;\n  } catch {\n    return '';\n  }\n}\n\n/**\n * Guesses the repository URL based on the author profile URL and the package slug.\n */\nexport async function guessRepoUrl(authorUrl: string, slug: string) {\n  if (/^https?:\\/\\/github.com\\/[^/]+/.test(authorUrl)) {\n    const normalizedSlug = slug.replace(/^@/, '').replace(/\\//g, '-');\n    return `${authorUrl}/${normalizedSlug}`;\n  }\n  return '';\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-expo-module",
-  "version": "0.3.0",
+  "version": "0.4.1",
   "description": "The script to create the Expo module",
   "main": "build/create-expo-module.js",
   "types": "build/create-expo-module.d.ts",
@@ -36,15 +36,19 @@
     "@expo/spawn-async": "^1.5.0",
     "chalk": "^4.1.2",
     "commander": "^8.3.0",
+    "cross-spawn": "^7.0.3",
     "download-tarball": "^2.0.0",
     "ejs": "^3.1.7",
     "fs-extra": "^10.0.0",
-    "prompts": "^2.4.2"
+    "github-username": "^6.0.0",
+    "ora": "^5.4.1",
+    "prompts": "^2.4.2",
+    "validate-npm-package-name": "^4.0.0"
   },
   "devDependencies": {
     "@types/ejs": "^3.1.0",
     "@types/prompts": "^2.0.14",
     "expo-module-scripts": "^2.0.0"
   },
-  "gitHead": "5e7c69008fe51f86e96877116602ef1a50a4655f"
+  "gitHead": "066000e04629874e1c67f2b3b9a38af805d9831c"
 }

package/src/create-expo-module.ts

@@ -5,9 +5,14 @@ import downloadTarball from 'download-tarball';
 import ejs from 'ejs';
 import fs from 'fs-extra';
 import path from 'path';
-import prompts, { PromptObject } from 'prompts';
+import prompts from 'prompts';
 
-import { PackageManagerName, resolvePackageManager } from './resolvePackageManager';
+import { createExampleApp } from './createExampleApp';
+import { installDependencies } from './packageManager';
+import getPrompts from './prompts';
+import { resolvePackageManager } from './resolvePackageManager';
+import { CommandOptions, SubstitutionData } from './types';
+import { newStep } from './utils';
 
 const packageJson = require('../package.json');
 
@@ -18,43 +23,6 @@ const CWD = process.env.INIT_CWD || process.cwd();
 // from `$package.json` file instead of the original one.
 const IGNORES_PATHS = ['.DS_Store', 'build', 'node_modules', 'package.json'];
 
-/**
- * Possible command options.
- */
-type CommandOptions = {
-  target: string;
-  source?: string;
-  name?: string;
-  description?: string;
-  package?: string;
-  author?: string;
-  license?: string;
-  repo?: string;
-  withReadme: boolean;
-  withChangelog: boolean;
-};
-
-/**
- * Represents an object that is passed to `ejs` when rendering the template.
- */
-type SubstitutionData = {
-  project: {
-    slug: string;
-    name: string;
-    version: string;
-    description: string;
-    package: string;
-  };
-  author: string;
-  license: string;
-  repo: string;
-};
-
-type CustomPromptObject = PromptObject & {
-  name: string;
-  resolvedValue?: string | null;
-};
-
 /**
  * The main function of the command.
  *
@@ -64,34 +32,38 @@ type CustomPromptObject = PromptObject & {
 async function main(target: string | undefined, options: CommandOptions) {
   const targetDir = target ? path.join(CWD, target) : CWD;
 
+  await fs.ensureDir(targetDir);
   await confirmTargetDirAsync(targetDir);
 
   options.target = targetDir;
-  await fs.ensureDir(targetDir);
 
-  const data = await askForSubstitutionDataAsync(targetDir, options);
+  const data = await askForSubstitutionDataAsync(targetDir);
+
+  // Make one line break between prompts and progress logs
+  console.log();
+
   const packageManager = await resolvePackageManager();
   const packagePath = options.source
     ? path.join(CWD, options.source)
     : await downloadPackageAsync(targetDir);
-  const files = await getFilesAsync(packagePath);
 
-  console.log('🎨 Creating Expo module from the template files...');
+  await newStep('Creating the module from template files', async (step) => {
+    await createModuleFromTemplate(packagePath, targetDir, data);
+    step.succeed('Created the module from template files');
+  });
 
-  // Iterate through all template files.
-  for (const file of files) {
-    const renderedRelativePath = ejs.render(file.replace(/^\$/, ''), data, {
-      openDelimiter: '{',
-      closeDelimiter: '}',
-      escape: (value: string) => value.replace('.', path.sep),
-    });
-    const fromPath = path.join(packagePath, file);
-    const toPath = path.join(targetDir, renderedRelativePath);
-    const template = await fs.readFile(fromPath, { encoding: 'utf8' });
-    const renderedContent = ejs.render(template, data);
+  await newStep('Installing module dependencies', async (step) => {
+    await installDependencies(packageManager, targetDir);
+    step.succeed('Installed module dependencies');
+  });
 
-    await fs.outputFile(toPath, renderedContent, { encoding: 'utf8' });
-  }
+  await newStep('Compiling TypeScript files', async (step) => {
+    await spawnAsync(packageManager, ['run', 'build'], {
+      cwd: targetDir,
+      stdio: 'ignore',
+    });
+    step.succeed('Compiled TypeScript files');
+  });
 
   if (!options.source) {
     // Files in the downloaded tarball are wrapped in `package` dir.
@@ -104,10 +76,12 @@ async function main(target: string | undefined, options: CommandOptions) {
   if (!options.withChangelog) {
     await fs.remove(path.join(targetDir, 'CHANGELOG.md'));
   }
+  if (options.example) {
+    // Create "example" folder
+    await createExampleApp(data, targetDir, packageManager);
+  }
 
-  // Install dependencies and build
-  await postActionsAsync(packageManager, targetDir);
-
+  console.log();
   console.log('✅ Successfully created Expo module');
 }
 
@@ -145,120 +119,72 @@ async function getNpmTarballUrl(packageName: string, version: string = 'latest')
   return stdout.trim();
 }
 
-/**
- * Gets the username of currently logged in user. Used as a default in the prompt asking for the module author.
- */
-async function npmWhoamiAsync(targetDir: string): Promise<string | null> {
-  try {
-    const { stdout } = await spawnAsync('npm', ['whoami'], { cwd: targetDir });
-    return stdout.trim();
-  } catch {
-    return null;
-  }
-}
-
 /**
  * Downloads the template from NPM registry.
  */
 async function downloadPackageAsync(targetDir: string): Promise<string> {
-  const tarballUrl = await getNpmTarballUrl('expo-module-template');
+  return await newStep('Downloading module template from npm', async (step) => {
+    const tarballUrl = await getNpmTarballUrl('expo-module-template');
+
+    await downloadTarball({
+      url: tarballUrl,
+      dir: targetDir,
+    });
 
-  console.log('⬇️  Downloading module template from npm...');
+    step.succeed('Downloaded module template from npm');
 
-  await downloadTarball({
-    url: tarballUrl,
-    dir: targetDir,
+    return path.join(targetDir, 'package');
   });
-  return path.join(targetDir, 'package');
 }
 
 /**
- * Installs dependencies and builds TypeScript files.
+ * Creates the module based on the `ejs` template (e.g. `expo-module-template` package).
  */
-async function postActionsAsync(packageManager: PackageManagerName, targetDir: string) {
-  async function run(...args: string[]) {
-    await spawnAsync(packageManager, args, {
-      cwd: targetDir,
-      stdio: 'ignore',
-    });
-  }
+async function createModuleFromTemplate(
+  templatePath: string,
+  targetPath: string,
+  data: SubstitutionData
+) {
+  const files = await getFilesAsync(templatePath);
 
-  console.log('📦 Installing dependencies...');
-  await run('install');
+  // Iterate through all template files.
+  for (const file of files) {
+    const renderedRelativePath = ejs.render(file.replace(/^\$/, ''), data, {
+      openDelimiter: '{',
+      closeDelimiter: '}',
+      escape: (value: string) => value.replace('.', path.sep),
+    });
+    const fromPath = path.join(templatePath, file);
+    const toPath = path.join(targetPath, renderedRelativePath);
+    const template = await fs.readFile(fromPath, { encoding: 'utf8' });
+    const renderedContent = ejs.render(template, data);
 
-  console.log('🛠  Compiling TypeScript files...');
-  await run('run', 'build');
+    await fs.outputFile(toPath, renderedContent, { encoding: 'utf8' });
+  }
 }
 
 /**
  * Asks the user for some data necessary to render the template.
  * Some values may already be provided by command options, the prompt is skipped in that case.
  */
-async function askForSubstitutionDataAsync(
-  targetDir: string,
-  options: CommandOptions
-): Promise<SubstitutionData> {
-  const defaultPackageSlug = path.basename(targetDir);
-  const defaultProjectName = defaultPackageSlug
-    .replace(/^./, (match) => match.toUpperCase())
-    .replace(/\W+(\w)/g, (_, p1) => p1.toUpperCase());
-
-  const promptQueries: CustomPromptObject[] = [
-    {
-      type: 'text',
-      name: 'slug',
-      message: 'What is the package slug?',
-      initial: defaultPackageSlug,
-      resolvedValue: options.target ? defaultPackageSlug : null,
-    },
-    {
-      type: 'text',
-      name: 'name',
-      message: 'What is the project name?',
-      initial: defaultProjectName,
-    },
-    {
-      type: 'text',
-      name: 'description',
-      message: 'How would you describe the module?',
-    },
-    {
-      type: 'text',
-      name: 'package',
-      message: 'What is the Android package name?',
-      initial: `expo.modules.${defaultPackageSlug.replace(/\W/g, '').toLowerCase()}`,
-    },
-    {
-      type: 'text',
-      name: 'author',
-      message: 'Who is the author?',
-      initial: (await npmWhoamiAsync(targetDir)) ?? '',
-    },
-    {
-      type: 'text',
-      name: 'license',
-      message: 'What is the license?',
-      initial: 'MIT',
-    },
-    {
-      type: 'text',
-      name: 'repo',
-      message: 'What is the repository URL?',
-    },
-  ];
+async function askForSubstitutionDataAsync(targetDir: string): Promise<SubstitutionData> {
+  const promptQueries = await getPrompts(targetDir);
 
   // Stop the process when the user cancels/exits the prompt.
   const onCancel = () => {
     process.exit(0);
   };
 
-  const answers: Record<string, string> = {};
-  for (const query of promptQueries) {
-    const { name, resolvedValue } = query;
-    answers[name] = resolvedValue ?? options[name] ?? (await prompts(query, { onCancel }))[name];
-  }
-
-  const { slug, name, description, package: projectPackage, author, license, repo } = answers;
+  const {
+    slug,
+    name,
+    description,
+    package: projectPackage,
+    authorName,
+    authorEmail,
+    authorUrl,
+    repo,
+  } = await prompts(promptQueries, { onCancel });
 
   return {
     project: {
@@ -268,8 +194,8 @@ async function askForSubstitutionDataAsync(
       description,
       package: projectPackage,
     },
-    author,
-    license,
+    author: `${authorName} <${authorEmail}> (${authorUrl})`,
+    license: 'MIT',
     repo,
   };
 }
@@ -312,14 +238,9 @@ program
     '-s, --source <source_dir>',
     'Local path to the template. By default it downloads `expo-module-template` from NPM.'
   )
-  .option('-n, --name <module_name>', 'Name of the native module.')
-  .option('-d, --description <description>', 'Description of the module.')
-  .option('-p, --package <package>', 'The Android package name.')
-  .option('-a, --author <author>', 'The author name.')
-  .option('-l, --license <license>', 'The license that the module is distributed with.')
-  .option('-r, --repo <repo_url>', 'The URL to the repository.')
   .option('--with-readme', 'Whether to include README.md file.', false)
   .option('--with-changelog', 'Whether to include CHANGELOG.md file.', false)
+  .option('--no-example', 'Whether to skip creating the example app.', false)
   .action(main);
 
 program.parse(process.argv);

package/src/createExampleApp.ts

@@ -0,0 +1,159 @@
+import spawnAsync from '@expo/spawn-async';
+import fs from 'fs-extra';
+import path from 'path';
+
+import { installDependencies } from './packageManager';
+import { PackageManagerName } from './resolvePackageManager';
+import { SubstitutionData } from './types';
+import { newStep } from './utils';
+
+// These dependencies will be removed from the example app (`expo init` adds them)
+const DEPENDENCIES_TO_REMOVE = ['expo-status-bar', 'expo-splash-screen'];
+
+/**
+ * Initializes a new Expo project as an example app.
+ */
+export async function createExampleApp(
+  data: SubstitutionData,
+  targetDir: string,
+  packageManager: PackageManagerName
+): Promise<void> {
+  // Package name for the example app
+  const exampleProjectSlug = `${data.project.slug}-example`;
+
+  // `expo init` creates a new folder with the same name as the project slug
+  const appTmpPath = path.join(targetDir, exampleProjectSlug);
+
+  // Path to the target example dir
+  const appTargetPath = path.join(targetDir, 'example');
+
+  if (!(await fs.pathExists(appTargetPath))) {
+    // The template doesn't include the example app, so just skip this phase
+    return;
+  }
+
+  await newStep('Initializing the example app', async (step) => {
+    await spawnAsync(
+      'expo',
+      ['init', exampleProjectSlug, '--template', 'expo-template-blank-typescript'],
+      {
+        cwd: targetDir,
+        stdio: ['ignore', 'ignore', 'inherit'],
+      }
+    );
+    step.succeed('Initialized the example app');
+  });
+
+  await newStep('Configuring the example app', async (step) => {
+    // "example" folder already exists and contains template files,
+    // that should replace these created by `expo init`.
+    await moveFiles(appTargetPath, appTmpPath);
+
+    // Cleanup the "example" dir
+    await fs.rmdir(appTargetPath);
+
+    // Move the temporary example app to "example" dir
+    await fs.rename(appTmpPath, appTargetPath);
+
+    await addMissingAppConfigFields(appTargetPath, data);
+
+    step.succeed('Configured the example app');
+  });
+
+  await prebuildExampleApp(appTargetPath);
+
+  await modifyPackageJson(appTargetPath);
+
+  await newStep('Installing dependencies in the example app', async (step) => {
+    await installDependencies(packageManager, appTargetPath);
+    await podInstall(appTargetPath);
+    step.succeed('Installed dependencies in the example app');
+  });
+}
+
+/**
+ * Copies files from one directory to another.
+ */
+async function moveFiles(fromPath: string, toPath: string): Promise<void> {
+  for (const file of await fs.readdir(fromPath)) {
+    await fs.move(path.join(fromPath, file), path.join(toPath, file), {
+      overwrite: true,
+    });
+  }
+}
+
+/**
+ * Adds missing configuration that are required to run `expo prebuild`.
+ */
+async function addMissingAppConfigFields(appPath: string, data: SubstitutionData): Promise<void> {
+  const appConfigPath = path.join(appPath, 'app.json');
+  const appConfig = await fs.readJson(appConfigPath);
+  const appId = `${data.project.package}.example`;
+
+  // Android package name needs to be added to app.json
+  if (!appConfig.expo.android) {
+    appConfig.expo.android = {};
+  }
+  appConfig.expo.android.package = appId;
+
+  // Specify iOS bundle identifier
+  if (!appConfig.expo.ios) {
+    appConfig.expo.ios = {};
+  }
+  appConfig.expo.ios.bundleIdentifier = appId;
+
+  await fs.writeJson(appConfigPath, appConfig, {
+    spaces: 2,
+  });
+}
+
+/**
+ * Applies necessary changes to **package.json** of the example app.
+ * It means setting the autolinking config and removing unnecessary dependencies.
+ */
+async function modifyPackageJson(appPath: string): Promise<void> {
+  const packageJsonPath = path.join(appPath, 'package.json');
+  const packageJson = await fs.readJson(packageJsonPath);
+
+  if (!packageJson.expo) {
+    packageJson.expo = {};
+  }
+
+  // Set the native modules dir to the root folder,
+  // so that the autolinking can detect and link the module.
+  packageJson.expo.autolinking = {
+    nativeModulesDir: '..',
+  };
+
+  // Remove unnecessary dependencies
+  for (const dependencyToRemove of DEPENDENCIES_TO_REMOVE) {
+    delete packageJson.dependencies[dependencyToRemove];
+  }
+
+  await fs.writeJson(packageJsonPath, packageJson, {
+    spaces: 2,
+  });
+}
+
+/**
+ * Runs `expo prebuild` in the example app.
+ */
+async function prebuildExampleApp(exampleAppPath: string): Promise<void> {
+  await newStep('Prebuilding the example app', async (step) => {
+    await spawnAsync('expo', ['prebuild', '--no-install'], {
+      cwd: exampleAppPath,
+      stdio: ['ignore', 'ignore', 'pipe'],
+    });
+    step.succeed('Prebuilt the example app');
+  });
+}
+
+/**
+ * Runs `pod install` in the iOS project at the given path.
+ */
+async function podInstall(appPath: string): Promise<void> {
+  await spawnAsync('pod', ['install'], {
+    cwd: path.join(appPath, 'ios'),
+    stdio: ['ignore', 'ignore', 'pipe'],
+  });
+}

package/src/packageManager.ts

@@ -0,0 +1,14 @@
+import spawnAsync from '@expo/spawn-async';
+
+import { PackageManagerName } from './resolvePackageManager';
+
+export async function installDependencies(
+  packageManager: PackageManagerName,
+  appPath: string,
+  ...args: string[]
+) {
+  await spawnAsync(packageManager, ['install', ...args], {
+    cwd: appPath,
+    stdio: 'ignore',
+  });
+}