create-expo 5.0.0 → 5.1.0

package/build/legacyTemplates.d.ts

@@ -0,0 +1,7 @@
+export declare const LEGACY_TEMPLATES: {
+    title: string;
+    value: string;
+    description: string;
+}[];
+export declare const ALIASES: string[];
+export declare function promptTemplateAsync(): Promise<any>;

package/build/log.d.ts

@@ -0,0 +1,12 @@
+export declare function error(...message: string[]): void;
+/** Print an error and provide additional info (the stack trace) in debug mode. */
+export declare function exception(e: Error): void;
+export declare function log(...message: string[]): void;
+/** Log a message and exit the current process. If the `code` is non-zero then `console.error` will be used instead of `console.log`. */
+export declare function exit(message: string | Error, code?: number): never;
+export declare const Log: {
+    error: typeof error;
+    exception: typeof exception;
+    log: typeof log;
+    exit: typeof exit;
+};

package/build/paths.d.ts

@@ -0,0 +1,2 @@
+export declare function dotExpoHomeDirectory(): string;
+export declare const getStateJsonPath: () => string;

package/build/promptSdkVersion.d.ts

@@ -0,0 +1,23 @@
+type SdkVersionsSummary = {
+    /** Highest released SDK major version (highest entry with a releaseNoteUrl). */
+    latest: number;
+    /** Major SDK version currently shipping in the App Store / Play Store version of Expo Go. */
+    expoGoCompatible: number | null;
+    /** All released SDK major versions, sorted descending. */
+    available: number[];
+};
+export declare function fetchSdkVersionsAsync(): Promise<SdkVersionsSummary | null>;
+/**
+ * If the resolved template is an Expo-published template without an explicit
+ * SDK tag, prompt the user to pick which Expo SDK to use and return the
+ * template name with the chosen SDK tag appended.
+ *
+ * Returns the template unchanged if the user is non-interactive, the template
+ * already targets a specific version, or we can't reach the versions endpoint.
+ */
+export declare function applySdkVersionToTemplateAsync(template: string, { yes, showAlternatives, projectName, }: {
+    yes: boolean;
+    showAlternatives?: boolean;
+    projectName?: string;
+}): Promise<string>;
+export {};

package/build/resolvePackageManager.d.ts

@@ -0,0 +1,12 @@
+export type PackageManagerName = 'npm' | 'pnpm' | 'yarn' | 'bun' | 'nub';
+/** Determine which package manager to use for installing dependencies based on how the process was started. */
+export declare function resolvePackageManager(): PackageManagerName;
+export declare function isPackageManagerAvailable(manager: PackageManagerName): boolean;
+export declare function formatRunCommand(packageManager: PackageManagerName, cmd: string): string;
+export declare function formatSelfCommand(): "pnpx create-expo" | "bunx create-expo" | "nubx create-expo" | "npx create-expo";
+export declare function installDependenciesAsync(projectRoot: string, packageManager: PackageManagerName, flags?: {
+    silent: boolean;
+}): Promise<void>;
+export declare function configurePackageManager(projectRoot: string, packageManager: PackageManagerName, flags?: {
+    silent: boolean;
+}): Promise<void>;

package/build/resolveProjectRoot.d.ts

@@ -0,0 +1,3 @@
+export declare function assertValidName(folderName: string): void;
+export declare function assertFolderEmpty(projectRoot: string, folderName: string): void;
+export declare function resolveProjectRootAsync(input: string): Promise<string>;

package/build/sessionStorage.d.ts

@@ -0,0 +1,8 @@
+type SessionData = {
+    sessionSecret: string;
+    userId: string;
+    username: string;
+    currentConnection: 'Username-Password-Authentication';
+};
+export declare function getSession(): SessionData | null;
+export {};

package/build/telemetry.d.ts

@@ -0,0 +1,29 @@
+type AnalyticsMessage = {
+    context?: {
+        [key: string]: unknown;
+    };
+    integrations?: {
+        [destination: string]: boolean;
+    };
+    properties?: {
+        [key: string]: unknown;
+    };
+    timestamp?: Date;
+    [key: string]: unknown;
+};
+export declare function _resetGlobals(): void;
+export declare function initializeAnalyticsIdentityAsync(): Promise<void>;
+export declare function identify(): void;
+export declare function track(message: AnalyticsMessage & {
+    event: string;
+}): void;
+export declare function flushAsync(): Promise<void>;
+export declare enum AnalyticsEventTypes {
+    CREATE_EXPO_APP = "create expo app"
+}
+export declare enum AnalyticsEventPhases {
+    ATTEMPT = "attempt",
+    SUCCESS = "success",
+    FAIL = "fail"
+}
+export {};

package/build/utils/__tests__/args.test.d.ts

@@ -0,0 +1 @@
+export {};

package/build/utils/__tests__/array.test.d.ts

@@ -0,0 +1 @@
+export {};

package/build/utils/__tests__/log.test.d.ts

@@ -0,0 +1 @@
+export {};

package/build/utils/__tests__/npm.test.d.ts

@@ -0,0 +1 @@
+export {};

package/build/utils/__tests__/obj.test.d.ts

@@ -0,0 +1 @@
+export {};

package/build/utils/args.d.ts

@@ -0,0 +1,33 @@
+import type { Spec } from 'arg';
+import arg from 'arg';
+/**
+ * Parse args and assert unknown options.
+ *
+ * @param schema the `args` schema for parsing the command line arguments.
+ * @param argv extra strings
+ * @returns processed args object.
+ */
+export declare function assertWithOptionsArgs(schema: arg.Spec, options: arg.Options): arg.Result<arg.Spec>;
+export declare function printHelp(info: string, usage: string, options: string, extra?: string): never;
+/**
+ * Enables the resolution of arguments that can either be a string or a boolean.
+ *
+ * @param args arguments that were passed to the command.
+ * @param rawMap raw map of arguments that are passed to the command.
+ * @param extraArgs extra arguments and aliases that should be resolved as string or boolean.
+ * @returns parsed arguments and project root.
+ */
+export declare function resolveStringOrBooleanArgsAsync(args: string[], rawMap: arg.Spec, extraArgs: arg.Spec): Promise<{
+    args: Record<string, string | true | undefined>;
+    projectRoot: string;
+}>;
+export declare function _resolveStringOrBooleanArgs(multiTypeArgs: Spec, args: string[]): {
+    args: Record<string, string | true | undefined>;
+    projectRoot: string;
+};
+/** Convert all aliases to fully qualified flag names. */
+export declare function collapseAliases(arg: Spec, args: string[]): string[];
+/** Assert that the spec has unknown arguments. */
+export declare function assertUnknownArgs(arg: Spec, args: string[]): void;
+/** Asserts that a duplicate flag has been used, this naively throws without knowing if an alias or flag were used as the duplicate. */
+export declare function assertDuplicateArgs(args: string[], argNameAliasTuple: [string, string][]): void;

package/build/utils/array.d.ts

@@ -0,0 +1 @@
+export declare function replaceValue<T>(values: T[], original: T, replacement: T): T[];

package/build/utils/dir.d.ts

@@ -0,0 +1 @@
+export declare function getConflictsForDirectory(projectRoot: string): string[];

package/build/utils/env.d.ts

@@ -0,0 +1,14 @@
+declare class Env {
+    /** Enable debug logging */
+    get EXPO_DEBUG(): boolean;
+    /** Enable the beta version of Expo (TODO: Should this just be in the beta version of expo releases?) */
+    get EXPO_BETA(): boolean;
+    /** Is running in non-interactive CI mode */
+    get CI(): boolean;
+    /** Disable all API caches. Does not disable bundler caches. */
+    get EXPO_NO_CACHE(): boolean;
+    /** Disable telemetry (analytics) */
+    get EXPO_NO_TELEMETRY(): boolean;
+}
+export declare const env: Env;
+export {};

package/build/utils/fetch.d.ts

@@ -0,0 +1,2 @@
+/** Export a fetch method that ensures fetch is available */
+export declare const fetch: typeof globalThis.fetch;

package/build/utils/git.d.ts

@@ -0,0 +1 @@
+export declare function initGitRepoAsync(root: string): Promise<boolean>;

package/build/utils/github.d.ts

@@ -0,0 +1,2 @@
+import { type ExtractProps } from './npm';
+export declare function downloadAndExtractGitHubRepositoryAsync(repoUrl: URL, output: string, props: ExtractProps): Promise<string>;

package/build/utils/log.d.ts

@@ -0,0 +1,6 @@
+import type { Ora } from 'ora';
+export declare function withSectionLog<T>(action: (spinner: Ora) => Promise<T>, message: {
+    pending: string;
+    success: string;
+    error: (errror: Error) => string;
+}): Promise<T>;

package/build/utils/npm.d.ts

@@ -0,0 +1,52 @@
+export interface ExtractProps {
+    expName: string;
+    filter?(path: string): boolean | undefined | null;
+    strip?: number;
+    disableCache?: boolean;
+}
+/** Applies the `@beta` npm tag when `EXPO_BETA` is enabled. */
+export declare function applyBetaTag(npmPackageName: string): string;
+/** Split a package name from its tag. */
+export declare function splitNpmNameAndTag(npmPackageName: string): [string, string | undefined];
+/**
+ * Applies known shortcuts to an NPM package name and tag.
+ * - If the name is `blank`, `blank-typescript`, `tabs`, or `bare-minimum`, apply the prefix `expo-template-`.
+ * - If a tag is a numeric value like `45`, and the name is a known template, then convert the tag to `sdk-X`.
+ *
+ * @example `blank@45` => `expo-template-blank@sdk-45`
+ */
+export declare function getResolvedTemplateName(npmPackageName: string): string;
+export declare function applyKnownNpmPackageNameRules(name: string): string | null;
+/**
+ * Extracts a tarball stream to a directory.
+ */
+export declare function extractNpmTarballAsync(stream: ReadableStream, output: string, props: ExtractProps): Promise<string>;
+export declare function extractLocalNpmTarballAsync(tarFilePath: string, output: string, props: ExtractProps): Promise<string>;
+/** Normalize the npm pack JSON formats used before and after npm 12 */
+export declare function normalizeNpmPackResult(result: unknown): unknown[] | null;
+export type NpmPackageInfo = {
+    /** "expo-template-blank@45.0.0" */
+    id: string;
+    /** "expo-template-blank" */
+    name: string;
+    /** "45.0.0" */
+    version: string;
+    /** 73765 */
+    size: number;
+    /** 90909 */
+    unpackedSize: number;
+    /** "2366988b44e4ee16eb2b0e902ee6c12a127b2c2e" */
+    shasum: string;
+    /** "sha512-oc7MjAt3sp8mi3Gf3LkKUNUkbiK7lJ7BecHMqe06n8vrStT4h2cHJKxf5dtAfgmXkBHHsQE/g7RUWrh1KbBjAw==" */
+    integrity: string;
+    /** "expo-template-blank-45.0.0.tgz" */
+    filename: string;
+    files: {
+        path: string;
+        size: number;
+        mode: number;
+    }[];
+    entryCount: number;
+    bundled: unknown[];
+};
+export declare function downloadAndExtractNpmModuleAsync(npmName: string, output: string, props: ExtractProps): Promise<string>;

package/build/utils/obj.d.ts

@@ -0,0 +1 @@
+export declare function deepMerge(target: any, source: any): any;

package/build/utils/tar.d.ts

@@ -0,0 +1,10 @@
+import { TarTypeFlag } from 'multitars';
+export interface ExtractOptions {
+    strip?: number;
+    filter?(name: string, type: TarTypeFlag): boolean | null | undefined;
+    rename?(name: string, type: TarTypeFlag): string | null | undefined;
+    checksumAlgorithm?: string;
+}
+export declare function extractStream(input: ReadableStream, targetOutput: string, options?: ExtractOptions): Promise<string>;
+/** Extract a tar using built-in tools if available and falling back on Node.js. */
+export declare function extractAsync(input: string, output: string, options?: ExtractOptions): Promise<void>;

package/build/utils/update-check.d.ts

@@ -0,0 +1,2 @@
+export declare const PACKAGE_NAME = "create-expo";
+export default function shouldUpdate(): Promise<void>;

package/package.json

@@ -1,31 +1,37 @@
 {
   "name": "create-expo",
-  "version": "5.0.0",
-  "bin": "./bin/create-expo.js",
-  "main": "build",
+  "version": "5.1.0",
   "description": "Create universal Expo apps",
-  "license": "BSD-3-Clause",
   "keywords": [
     "expo",
-    "react-native",
-    "react"
+    "react",
+    "react-native"
   ],
   "homepage": "https://docs.expo.dev",
+  "license": "BSD-3-Clause",
+  "author": "Evan Bacon <bacon@expo.io> (https://github.com/evanbacon)",
   "repository": {
     "type": "git",
     "url": "https://github.com/expo/expo.git",
     "directory": "packages/create-expo"
   },
-  "author": "Evan Bacon <bacon@expo.io> (https://github.com/evanbacon)",
+  "bin": {
+    "create-expo": "./bin/create-expo.js"
+  },
   "files": [
     "bin",
     "build",
     "template"
   ],
-  "engines": {
-    "node": ">=18.13.0"
+  "main": "build/index.js",
+  "exports": {
+    ".": "./build/index.js",
+    "./package.json": "./package.json"
   },
   "devDependencies": {
+    "@expo/config": "58.0.0",
+    "@expo/json-file": "11.1.0",
+    "@expo/package-manager": "1.14.0",
     "@expo/spawn-async": "^1.8.0",
     "@octokit/types": "^13.5.0",
     "@types/debug": "^4.1.7",
@@ -37,28 +43,34 @@
     "arg": "^5.0.2",
     "chalk": "^4.0.0",
     "debug": "^4.3.4",
+    "expo-module-scripts": "56.0.3",
     "getenv": "^2.0.0",
     "glob": "^13.0.0",
+    "memfs": "^3.2.0",
+    "multitars": "^1.0.2",
     "nock": "^14.0.10",
     "ora": "3.4.0",
     "picomatch": "^2.3.2",
     "prompts": "^2.4.2",
-    "multitars": "^1.0.0",
-    "update-check": "^1.5.4",
-    "@expo/config": "57.0.0",
-    "@expo/json-file": "11.0.0",
-    "expo-module-scripts": "56.0.3",
-    "@expo/package-manager": "1.13.0"
+    "resolve-workspace-root": "^2.0.0",
+    "update-check": "^1.5.4"
+  },
+  "engines": {
+    "node": "^22.13.0 || ^24.3.0 || ^26.0.0 || >=27.0.0"
   },
-  "gitHead": "e3eb896c5fdcd89e0cded98ff4e35c9db12cc9c0",
+  "gitHead": "c543a7181fc32e14f42d89550087b80ac5c490f2",
   "scripts": {
+    "prebuild": "expo-module clean",
     "build": "ncc build ./src/index.ts -o build/",
+    "prebuild:prod": "expo-module clean",
     "build:prod": "ncc build ./src/index.ts -o build/ --minify --no-cache --no-source-map-register",
     "clean": "expo-module clean",
-    "lint": "expo-module lint",
-    "typecheck": "expo-module typecheck",
-    "test": "expo-module test",
-    "test:e2e": "expo-module test --config e2e/jest.config.js --runInBand",
-    "watch": "pnpm run build --watch"
+    "lint": "oxlint --config oxlint.config.mjs .",
+    "format": "expo-module format",
+    "depscheck": "expo-module depscheck",
+    "typecheck": "tsc -p tsconfig.json",
+    "test": "jest",
+    "test:e2e": "jest --config e2e/jest.config.js --runInBand",
+    "sync-agent-templates": "node scripts/sync-agent-templates.js"
   }
 }

package/template/agent-files/AGENTS.md

@@ -0,0 +1,41 @@
+This is an Expo/React Native mobile application. Prioritize mobile-first patterns, performance, and cross-platform compatibility.
+
+## Expo has changed — do not trust your training data
+
+Expo ships breaking changes every SDK release. APIs you remember are likely renamed, moved, or removed. Before writing any code that touches an Expo, EAS, or React Native API:
+
+1. Read the major version of the `expo` package in `package.json`.
+2. Fetch the matching versioned docs: `https://docs.expo.dev/versions/v<major>.0.0/`
+3. For anything else, fetch https://docs.expo.dev/llms.txt — an index of all Expo docs with corrections to common LLM misconceptions. Follow its links to the specific page you need; never answer from memory.
+
+## Commands
+
+Use `bunx` instead of `npx` if the project uses bun (`bun.lock` present).
+
+```bash
+npx expo install <package>  # ALWAYS use instead of npm/yarn/pnpm/bun add — resolves SDK-compatible versions
+npx expo start              # start the dev server
+npx expo lint               # lint
+npx tsc --noEmit            # typecheck
+npx expo-doctor             # diagnose dependency and config issues
+npx expo install --fix      # fix incompatible package versions
+```
+
+Run lint and typecheck before declaring any task done.
+
+## Navigation & Routing
+
+- Use **Expo Router** for all navigation. Routes live in `src/app/` — every file there is a screen, `_layout.tsx` files define navigators. Keep non-route code (components, hooks, utils) outside `src/app/`.
+- Import `Link`, `router`, and `useLocalSearchParams` from `expo-router`.
+- Docs: https://docs.expo.dev/router/introduction.md
+
+## Building with EAS
+
+Use EAS to build, sign, and submit the app in the cloud (`eas build`, `eas submit`) and to ship over-the-air updates (`eas update`) — no local Xcode or Android Studio required. Run EAS CLI as `bunx eas-cli <command>` in Bun projects, or `npx eas-cli@latest <command>` otherwise; substitute that for bare `eas` in docs examples.
+Docs: https://docs.expo.dev/eas/index.md
+
+## Rules
+
+- If `ios/` and `android/` directories do not exist, they are generated (Continuous Native Generation). Never create or edit them by hand — configure native behavior in `app.json` and config plugins.
+- Expo Go only includes its bundled native modules. After adding a library with native code, the app needs a development build: `npx expo run:ios|android` locally, or `eas build --profile development`.
+- Prefer recommended Expo modules over third-party libraries, and check your available skills before adding dependencies. Docs: https://docs.expo.dev/versions/latest/index.md

package/template/agent-files/CLAUDE.md

@@ -0,0 +1 @@
+@AGENTS.md