Frequently Asked Questions
Does expo-tvos-search work with standard React Native or Expo Go?
No. It requires react-native-tvos and an Expo development build. The module includes native Swift code that compiles for tvOS, so standard React Native and Expo Go are not supported.
What tvOS versions are supported?
tvOS 15 and later. The module uses SwiftUI’s .searchable modifier introduced in tvOS 15. It runs on Apple TV 4K (all generations) and Apple TV HD.
What layout and appearance options are available?
Grid columns (1–10), card width, height, margin, and padding, overlay title font size, accent and text colors, image scaling (fill, fit, contain), marquee scrolling for long titles, and customizable state text for empty, searching, and no-results views. Titles can render overlaid on the card or below it.
How many search results can it display?
Up to 500 items per search. Results beyond 500 are truncated and the onValidationWarning callback fires with a results_truncated warning.
Does it handle the Siri Remote correctly?
Yes. Since v1.3.2 the module automatically manages gesture recognizers on Apple TV hardware so the Siri Remote keyboard input works without conflicts. It fires onSearchFieldFocused and onSearchFieldBlurred events for custom focus handling.
What image formats are supported in search results?
HTTPS URLs, HTTP URLs, and data: URIs. The module rejects file:// URLs and emits a warning for insecure HTTP connections. Images are cached asynchronously with a placeholder while loading.
