Branding

Expo reads branding assets from apps/mobile/app.json. amisi.config.json also stores three branding paths for the Configurator, but the running Expo build uses app.json.

Current branding fields

Asset	Expo field
App icon	`expo.icon`
Android adaptive foreground	`expo.android.adaptiveIcon.foregroundImage`
Android adaptive background	`expo.android.adaptiveIcon.backgroundColor`
Light splash	`expo-splash-screen` plugin `image` and `backgroundColor`
Dark splash	`expo-splash-screen` plugin `dark` options
Web favicon	`expo.web.favicon`

Store app assets under apps/mobile/assets/images/ and use paths relative to apps/mobile/app.json, such as ./assets/images/icon.png.

Configure assets manually

apps/mobile/app.json

{
  "expo": {
    "icon": "./assets/images/icon.png",
    "android": {
      "adaptiveIcon": {
        "foregroundImage": "./assets/images/adaptive-icon.png",
        "backgroundColor": "#ffffff"
      }
    },
    "web": {
      "favicon": "./assets/images/favicon.png"
    },
    "plugins": [
      [
        "expo-splash-screen",
        {
          "image": "./assets/images/splash-light.png",
          "resizeMode": "cover",
          "enableFullScreenImage_legacy": true,
          "backgroundColor": "#ffffff",
          "dark": {
            "image": "./assets/images/splash-icon-dark.png",
            "backgroundColor": "#071018"
          },
          "android": {
            "image": "./assets/images/splash-icon.png",
            "imageWidth": 200,
            "resizeMode": "contain",
            "backgroundColor": "#713fff",
            "dark": {
              "image": "./assets/images/splash-icon-dark.png",
              "backgroundColor": "#071018"
            }
          }
        }
      ]
    ]
  }
}

Use a 1024×1024 PNG for the store icon. Avoid transparency in the iOS icon. Keep important Android foreground artwork inside the adaptive-icon safe area. Android 12 and later render the native splash artwork as a centered icon, so use a square transparent image with contain and a solid background color. Full-screen cover artwork and enableFullScreenImage_legacy apply to iOS only; test the iOS image on several aspect ratios. If you maintain amisi.config.json manually, keep its optional icon, adaptiveIconForeground, and splash paths aligned with app.json.

Use the Configurator

Start the local UI:

bun run configurator:dev

In App, you can edit branding paths or upload icon, adaptive foreground, and splash files. Uploads are copied without resizing or format conversion to timestamped files in apps/mobile/assets/images/. They update the in-memory app.json; click Plan to inspect the diff and Apply to write it.

The App workflow writes only apps/mobile/app.json. The Theme workflow can write amisi.config.json and .env.example. Uploading a file does not update amisi.config.json, create dark splash variants, or optimize the image.

Rebuild and test

App icons, adaptive icons, and native splash configuration require a new native build:

bun run prebuild
bun run ios
# or
bun run android

If an installed icon remains cached, uninstall the app from the simulator or device before reinstalling. Use bun run clear only when a clean native regeneration is necessary. Official references:

Configuration

AI

Generators

Packages

Current branding fields

Configure assets manually

Use the Configurator

Rebuild and test

Next steps

​Current branding fields

​Configure assets manually

​Use the Configurator

​Rebuild and test

​Next steps

Current branding fields

Configure assets manually

Use the Configurator

Rebuild and test

Next steps