Skip to main content
Version: Next 🚧

Troubleshooting

After upgrading, Android or the web no longer look like iOS​

Since 0.11 each platform gets its own design: Material on Android, a web design in the browser. To keep the iOS look everywhere, set <PickersProvider design="ios">.

The wheel doesn't show my selected value​

  • Values are matched with Object.is. If value is an object (or a Date) re-created each render, pass isEqual: isEqual={(a, b) => a.id === b.id}.
  • Check that value is the value of an item, not its label or index.
  • If value points at a disabled item, the nearest enabled one is shown.

onChange fires with the wrong type​

Primitive items (['S', 'M'], [1, 2, 3]) give you the primitive. With objects ({ label, value }), you get value. Mixing number and string items gives you a union.

Selected day is off by one​

You probably built a date from an ISO string or key: new Date('2026-10-14') is UTC midnight, which is the previous day in the Americas. Use new Date(2026, 9, 14), or parse YYYY-MM-DD into parts. When saving, use toDateKey(date) rather than toISOString().slice(0, 10).

markedDates don't show​

Keys must be local YYYY-MM-DD with zero padding (2026-03-05, not 2026-3-5). Build them with toDateKey.

SelectPicker shows nothing after selecting​

SelectPicker is controlled-only: you must update value in onChange.

The calendar doesn't jump to my new value​

In single mode it follows value changes. In range / multiple mode it doesn't move automatically; remount with a key or set initialMonth when you need to show a specific month.

Sheet content is hidden by the keyboard (Android)​

The sheet uses KeyboardAvoidingView on iOS. On Android, set android:windowSoftInputMode="adjustResize" (the Expo default), or give the sheet a fixed height via sheetProps.

The sheet is hidden behind the home indicator​

Pass the safe-area inset: sheetProps={{ bottomInset: insets.bottom + 8 }} (or bottomInset on BottomSheet).

Emojis render as empty boxes​

The device font doesn't support those emojis (older Android). Set maxEmojiVersion, for example 12 for Android 10.

Wheel feels sluggish in development​

Debug builds run JS without optimizations. Try a release build, and make sure items, theme and styles are stable references (see Performance).

Still stuck?​

Open an issue with a minimal reproduction. A snippet from this site's live editor is perfect.