[Fork] Takeover Roadmap — v19.0.0

[amehmeto]

Context & Motivation

The original repo (mmazzarolo/react-native-modal-datetime-picker) is unmaintained — last merge was August 2024 (1.5 years of inactivity). Despite 3.1K stars and ~200K weekly downloads, it has:

• 44 open issues left unaddressed
• 13 PRs waiting without review
• Incompatible with React 19 / Expo SDK 53 (defaultProps deprecation)
• No web support
• Non-customizable modal (source of recurring dark mode issues)

This fork aims to resume active maintenance and add missing features. The positioning: native pickers + customizable modal + web support + unified API. No existing alternative combines all four.

---

Phase 1 — Quick Wins (Day 1)

Merge existing PRs that are ready:

• Add default parameters instead of defaultProps to remove console warning mmazzarolo/react-native-modal-datetime-picker#753 — Replace defaultProps with default parameters (React 19 fix, most upvoted issue WARN: defaultProps will be removed from memo components mmazzarolo/react-native-modal-datetime-picker#748 with 17 👍)
• Fix missing peerDependency on React mmazzarolo/react-native-modal-datetime-picker#741 — Add missing react peer dependency
• fix: Wrong onHide signature mmazzarolo/react-native-modal-datetime-picker#769 — Fix wrong onHide signature
• docs: add timeZoneName prop to README for picker component mmazzarolo/react-native-modal-datetime-picker#784 — Add timeZoneName prop to README
• Update component name to DateTimePicker on README.md mmazzarolo/react-native-modal-datetime-picker#733 — Fix component name in README
• Update peer deps for React 19 + latest @react-native-community/datetimepicker
• Publish to npm under a new package name

---

Phase 2 — Modal Customization (Week 1)

Merge and integrate customization PRs:

• Add animation type for the modal mmazzarolo/react-native-modal-datetime-picker#780 — animationType prop for the modal
• added seperation between confirm button text color and cancel buttton text color mmazzarolo/react-native-modal-datetime-picker#765 — Separate Confirm / Cancel button text colors
• Use spring animation on iOS mmazzarolo/react-native-modal-datetime-picker#728 — Spring animation on iOS
• Expose a renderModal or ModalComponent prop to allow fully custom modals (expo-blur, etc.)

---

Phase 3 — Web Support

• Add a web fallback using <input type="date"> / <input type="time"> via .web.tsx platform files
• Wrap the web fallback in the same customizable modal system
• Test on all 3 platforms (iOS, Android, Web)

---

Phase 4 — Review Remaining PRs

Evaluate and potentially integrate:

• Set currentDate to be prop.minimumDate if not null or the current date. mmazzarolo/react-native-modal-datetime-picker#726 — Use minimumDate as default date (7 comments, verify behavior)
• Fix/ios timepicker default date actually return the launch date mmazzarolo/react-native-modal-datetime-picker#651 — Fix iOS time picker returning launch date (2022 PR, check relevance)
• Add firstDayOfWeek prop to DateTimePickerModal mmazzarolo/react-native-modal-datetime-picker#779 — firstDayOfWeek prop
• Update Modal.js mmazzarolo/react-native-modal-datetime-picker#731 — Update Modal.js (inspect the diff)

---

Phase 5 — Hygiene & Quality

• Triage the 44 open issues (close stale ones, label the rest)
• Add CI (GitHub Actions)
• Add tests
• New README with migration guide from the original
• CHANGELOG

---

Known Issues from the Original Repo

Critical bugs

• Action buttons not visible Android 16 mmazzarolo/react-native-modal-datetime-picker#786 — Action buttons not visible on Android 16
• TypeError: Cannot read property 'validateAndroidProps' of undefined mmazzarolo/react-native-modal-datetime-picker#785 — TypeError: Cannot read property 'validateAndroidProps'
• modal preview on closing mmazzarolo/react-native-modal-datetime-picker#781 — Modal preview bug on closing
• Incompatibilidad: peer dependency de react@19.0.0 con @react-native-community/datetimepicker (Expo SDK 53) mmazzarolo/react-native-modal-datetime-picker#778 — Peer deps incompatibility with React 19 / Expo SDK 53 (resolved by Phase 1)
• Initial selected date/time bug mmazzarolo/react-native-modal-datetime-picker#775 — Initial selected date/time bug
• on iOS, onConfirm does NOT return the picked date mmazzarolo/react-native-modal-datetime-picker#771 — onConfirm does not return the picked date on iOS
• DatePicker Misaligned: Not Centered on iOS mmazzarolo/react-native-modal-datetime-picker#772 — DatePicker not centered on iOS
• WARN: defaultProps will be removed from memo components mmazzarolo/react-native-modal-datetime-picker#748 — defaultProps deprecated (resolved by Phase 1)

Dark mode (structural issue resolved by custom modal)

• Recurring dark mode issues (iOS 13.0 dark mode support mmazzarolo/react-native-modal-datetime-picker#283, iOS device with dark mode on shows no items in picker mmazzarolo/react-native-modal-datetime-picker#458, Date time labels are black when isDarkModeEnabled is true mmazzarolo/react-native-modal-datetime-picker#395, Dark mode picker showing blank in iOS 14. mmazzarolo/react-native-modal-datetime-picker#476) are caused by the native RN Modal — the customizable modal from Phase 2 resolves this structurally

Feature requests

• [Android] Material 3 support mmazzarolo/react-native-modal-datetime-picker#787 — Material 3 support on Android
• Highlight current date when selecting another date in the calendar mmazzarolo/react-native-modal-datetime-picker#767 — Highlight current date
• Can this library be used as a time duration picker? mmazzarolo/react-native-modal-datetime-picker#766 — Use as duration picker
• Web support mmazzarolo/react-native-modal-datetime-picker#481 — Web support (resolved by Phase 3)

[amehmeto]

Progress Update — March 2026

Completed (PRs #2, #15, #16, #17, #18, #19)

Phase 2 partial — iOS Customization:

• 13 new iOS style props (backgroundColorIOS, borderColorIOS, borderRadiusIOS, buttonFontSizeIOS, buttonHeightIOS, confirmButtonFontFamilyIOS, cancelButtonFontFamilyIOS, confirmButtonFontWeightIOS, cancelButtonFontWeightIOS, highlightColorIOS, backdropOpacityIOS, backdropColorIOS, animationDurationIOS)

Android Expo Config Plugin:

• Full Android theming via app.json — 4 scopes: timePickerDialog, datePickerDialog, timePickerWidget, datePickerWidget
• borderRadius with auto-generated rounded drawables
• Light/dark theme support via ThemedColor
• Closes issues feat: expose selectedTimeTextColor for Android time picker #3–feat: expose selectorColor for Android time picker #13

Phase 5 — Hygiene & Quality:

• CI with GitHub Actions (lint, test, Android build, APK artifact, Slack notification)
• Full TypeScript conversion (src/ and plugin/)
• Migrated from Jest to Vitest, ESLint to oxlint
• Migrated from Yarn to npm
• 16 unit tests covering the config plugin
• Strict tsconfig and oxlint config aligned with TiedSiren
• README updated with all new props and config plugin docs
• Node.js 22, FORCE_JAVASCRIPT_ACTIONS_TO_NODE24 for CI

Remaining

• Phase 1: upstream PR merges (defaultProps, peer deps, etc.)
• Phase 2: remaining modal customization (renderModal, spring animation)
• Phase 3: web support
• Phase 4: upstream PR evaluation