App identity

App identity is split between the static Expo config, the dynamic Expo config, and runtime product config.

Edit the build identity

In apps/mobile/app.config.js, replace the three values above the DON'T EDIT BELOW THIS LINE marker:

apps/mobile/app.config.js

const APP_NAME = 'Acme Mobile';
const BUNDLE_ID = 'com.acme.mobile';
const SCHEMA = 'acme-mobile';

EXPO_PUBLIC_APP_ENV determines the evaluated identity:

Environment	Display name	Bundle/package ID	Scheme
`development` or unset	`Acme Mobile (Dev)`	`com.acme.mobile.dev`	`acme-mobile-dev`
`preview`	`Acme Mobile (Preview)`	`com.acme.mobile.preview`	`acme-mobile-preview`
`production`	`Acme Mobile`	`com.acme.mobile`	`acme-mobile`

The same file selects environment-specific Firebase filenames. Do not put a suffixed identifier into BUNDLE_ID; the file adds suffixes itself.

Keep base files aligned

Update these base values in apps/mobile/app.json:

apps/mobile/app.json

{
  "expo": {
    "name": "Acme Mobile",
    "slug": "acme-mobile",
    "scheme": "acme-mobile",
    "ios": { "bundleIdentifier": "com.acme.mobile" },
    "android": { "package": "com.acme.mobile" }
  }
}

Also keep amisi.config.json aligned. The Configurator and @amisi-mobile-starter/config read this file, but it does not override Expo config by itself:

amisi.config.json

{
  "appIdentity": {
    "name": "Acme Mobile",
    "scheme": "acme-mobile",
    "iosBundleIdentifier": "com.acme.mobile",
    "androidPackage": "com.acme.mobile"
  }
}

Use a stable reverse-domain identifier. Apple and Google treat an identifier as the app’s permanent store identity. The URL scheme should be unique, lowercase, and URL-safe.

Update linked services

Identity changes also affect external configuration:

Register the production, preview, and development identifiers with Apple, Google Play, and Firebase as needed.
Download Firebase files whose registered identifiers match each variant.
Update associated domains and Android intent-filter hosts in app.json when changing your web domain.
Run eas init from apps/mobile to link your own Expo project, then verify extra.eas.projectId and updates.url.
Replace starter appleTeamId and ascAppId values in app.json and eas.json.

Verify the evaluated config

Check each identity before creating native builds:

cd apps/mobile
EXPO_PUBLIC_APP_ENV=development npx expo config --type public
EXPO_PUBLIC_APP_ENV=preview npx expo config --type public
EXPO_PUBLIC_APP_ENV=production npx expo config --type public

After an identity or native config change, rebuild the app:

bun run prebuild
bun run ios
# or
bun run android

Use bun run clear only when you intentionally want to delete and regenerate both native projects.

Configuration

AI

Generators

Packages

Edit the build identity

Keep base files aligned

Update linked services

Verify the evaluated config

Next steps

​Edit the build identity

​Keep base files aligned

​Update linked services

​Verify the evaluated config

​Next steps

Edit the build identity

Keep base files aligned

Update linked services

Verify the evaluated config

Next steps