Skip to content

Add a new custom icon

Alexander Harding edited this page Dec 9, 2023 · 3 revisions

Adding a new custom icon is a lengthy and annoying process.

  1. Resize icon to 1024x1024 PNG
  2. Run through https://tinypng.com
  3. Determine a good name for it: a-z characters only
  4. Add to public/alternateIcons and ios/App/App/public/AlternateIcons
  5. In Android project, go to Resource Manager -> (plus) -> Image Asset
  6. Add image with name to foreground layer source asset

Foreground Layer -> Scaling -> Resize 67%, Trim -> No

Background Layer -> Source Asset = "Image", for image choose 1x1 transparent PNG

  1. Add another activity-alias to AndroidManifest.xml
  2. For iOS, add image to image assets. IMPORTANT: Append _v2 to name!
  3. In appIconSlice.tsx, add icon name to APP_ICONS. Fix resulting typescript errors.
Clone this wiki locally