feat: make image fallback customizable

[V3RON]

This pull request adjusts the default fallback logic for missing images on both iOS and Android, allowing you to provide your own fallback via 'fallbackColor' and 'fallback' props.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
voltra	Ready	Preview, Comment	Feb 10, 2026 7:37am

[Angelk90]

@V3RON :

1. If fallbackColor or fbc is used it is possible to set a border smoothing, when using a Background.

<Image source={{ assetName: 'x' }} fallbackColor="#E0E0E0"
style={{
   width: 100,
   height: 100,
   borderRadius: 16
   //borderTopLeftRadius: 4, 
   //borderTopRightRadius: 4,
   //borderBottomLeftRadius: 0,
   //borderBottomRightRadius: 0,
}} />

2. You can do something like this:

<Image source={{ assetName: 'x' }} fallback={
   <Image source={{ assetName: 'y' }} fallback={<Text>Missing</Text>} />
} />

[V3RON]

@V3RON :

1. If fallbackColor or fbc is used it is possible to set a border smoothing, when using a Background.

<Image source={{ assetName: 'x' }} fallbackColor="#E0E0E0"
style={{
   width: 100,
   height: 100,
   borderRadius: 16
   //borderTopLeftRadius: 4, 
   //borderTopRightRadius: 4,
   //borderBottomLeftRadius: 0,
   //borderBottomRightRadius: 0,
}} />

2. You can do something like this:

<Image source={{ assetName: 'x' }} fallback={
   <Image source={{ assetName: 'y' }} fallback={<Text>Missing</Text>} />
} />

Updated. No 'fallbackColor'. The fallback will simply inherit from Image itself.

[Angelk90]

@V3RON : Much better, if no image is found and there is no fallback, what should it display?
Some message error or a colored default image?

If both flb and fallback are used, which one takes precedence?

<Image source={{ assetName: 'x' }} fallback={..} flb={...} />