react / react/react-native

[TypeScript] Properties missing in ImageStyle and TextStyle type

Open
#52,957 9 comments 1 reaction 0 assignees View on GitHub

Nobody has claimed this yet.

Component: Image Issue: Author Provided Repro Needs: Attention Needs: React Native Team Attention Needs: Version Info p: Software Mansion
Dominant language
C++
Stars
127k
Forks
25.3k
Avg merge
1d 23h
Merged PRs (30d)
4

Description

Description

While adding a filter property example in Reanimated example app, we noticed that the filter property doesn't exist in the ImageStyle type, whilst this property is most commonly used with image components. The filter prop is specified only in the ViewStyle type.

The same issue applies to other properties like: boxShadow (which works for Image and Text components but is specified only for the View component), mixBlendMode specified in the ViewStyle but working with the Image component, borderTopStartRadius, outlineColor and likely more other properties which are listed only under the ViewStyle type.

Steps to reproduce

Just create the Image (or Text) component and pass one of mentioned properties in the style object to see the TypeScript error.

React Native Version

0.80.0

Affected Platforms

Build - Linux, Build - Windows, Build - MacOS, Runtime - Desktop, Runtime - Web, Runtime - iOS, Runtime - Android

Output of npx @react-native-community/cli info
System:
  OS: macOS 15.5
  CPU: (11) arm64 Apple M3 Pro
  Memory: 269.23 MB / 18.00 GB
  Shell:
    version: "5.9"
    path: /bin/zsh
Binaries:
  Node:
    version: 20.10.0
    path: ~/.nvm/versions/node/v20.10.0/bin/node
  Yarn:
    version: 4.1.1
    path: ~/.nvm/versions/node/v20.10.0/bin/yarn
  npm:
    version: 10.2.3
    path: ~/.nvm/versions/node/v20.10.0/bin/npm
  Watchman:
    version: 2025.06.30.00
    path: /opt/homebrew/bin/watchman
Managers:
  CocoaPods:
    version: 1.14.3
    path: /Users/mateu/.rbenv/shims/pod
SDKs:
  iOS SDK:
    Platforms:
      - DriverKit 24.5
      - iOS 18.5
      - macOS 15.5
      - tvOS 18.5
      - visionOS 2.5
      - watchOS 11.5
  Android SDK:
    API Levels:
      - "30"
      - "33"
      - "34"
      - "35"
      - "36"
    Build Tools:
      - 30.0.3
      - 33.0.1
      - 34.0.0
      - 35.0.0
      - 36.0.0
    System Images:
      - android-34 | Android TV ARM 64 v8a
      - android-35 | Google Play ARM 64 v8a
    Android NDK: Not Found
IDEs:
  Android Studio: 2025.1 AI-251.25410.109.2511.13752376
  Xcode:
    version: 16.4/16F6
    path: /usr/bin/xcodebuild
Languages:
  Java:
    version: 17.0.15
    path: /opt/homebrew/opt/openjdk@17/bin/javac
  Ruby:
    version: 3.2.2
    path: /Users/mateu/.rbenv/shims/ruby
npmPackages:
  "@react-native-community/cli": Not Found
  react: Not Found
  react-native: Not Found
  react-native-macos: Not Found
npmGlobalPackages:
  "*react-native*": Not Found
Android:
  hermesEnabled: true
  newArchEnabled: true
iOS:
  hermesEnabled: true
  newArchEnabled: true
Stacktrace or Logs
No stack trace
MANDATORY Reproducer

https://snack.expo.dev/@matipl01/missing-style-prop-types

Screenshots and Videos
View
Image
Image
Image

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by locating the ImageStyle and TextStyle type definitions and compare them with ViewStyle, focusing on filter, boxShadow, mixBlendMode, borderTopStartRadius, and outlineColor. Use the mandatory Snack reproducer to verify the TypeScript errors; done means supported properties no longer produce errors for Image and Text styles.

Written by the indexing model from the issue text.

Assessment

Tech stack
react-native, typescript
Domain
mobile
Issue type
Bug
Difficulty
3/5
Estimated time
1-2 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.