Skip to content

feat(style): remove experimental_ prefix from backgroundImage#56668

Open
intergalacticspacehighway wants to merge 3 commits intofacebook:mainfrom
intergalacticspacehighway:remove-experimental-background-image-prefix
Open

feat(style): remove experimental_ prefix from backgroundImage#56668
intergalacticspacehighway wants to merge 3 commits intofacebook:mainfrom
intergalacticspacehighway:remove-experimental-background-image-prefix

Conversation

@intergalacticspacehighway
Copy link
Copy Markdown
Contributor

@intergalacticspacehighway intergalacticspacehighway commented May 1, 2026

Summary:

Promote backgroundImage from experimental_backgroundImage to a stable style prop. It has been available in experimental mode for some time and is already used in popular open-source projects such as NativeWind, Unstyles, Tamagui, React Strict DOM, and others, with no reported issues so far.

backgroundImage currently supports linear-gradient and radial-gradient. url() support already has a PR up (PRs), it should not be a blocker imo though as gradient is also a big unlock. Had also discussed this with @NickGerleman a while ago.

Changelog:

[GENERAL][CHANGED] - Remove experimental_ prefix from backgroundImage

Test Plan:

Tested background image screen on RNTester.

Promote `backgroundImage` from `experimental_backgroundImage` to a stable
style prop. `backgroundSize`, `backgroundPosition`, and `backgroundRepeat`
remain experimental.
@meta-cla meta-cla Bot added the CLA Signed This label is managed by the Facebook bot. Authors need to sign the CLA before a PR can be reviewed. label May 1, 2026
@intergalacticspacehighway intergalacticspacehighway changed the title feat(style): remove experimental_ prefix from backgroundImage feat(style): remove experimental_ prefix from backgroundImage May 1, 2026
@facebook-github-tools facebook-github-tools Bot added the Shared with Meta Applied via automation to indicate that an Issue or Pull Request has been shared with the team. label May 1, 2026
@github-actions
Copy link
Copy Markdown

github-actions Bot commented May 1, 2026

Warning

JavaScript API change detected

This PR commits an update to ReactNativeApi.d.ts, indicating a change to React Native's public JavaScript API.

  • Please include a clear changelog message.
  • This change will be subject to additional review.

This change was flagged as: POTENTIALLY_BREAKING

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

CLA Signed This label is managed by the Facebook bot. Authors need to sign the CLA before a PR can be reviewed. Shared with Meta Applied via automation to indicate that an Issue or Pull Request has been shared with the team.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant