Skip to content

Commit 57c6cee

Browse files
committed
⬆️ 📝 Minor README updates + upgrade Expo example to SDK 54
1 parent 37fd922 commit 57c6cee

File tree

4 files changed

+1279
-314
lines changed

4 files changed

+1279
-314
lines changed

README.md

Lines changed: 35 additions & 34 deletions
Original file line numberDiff line numberDiff line change
@@ -13,36 +13,37 @@ Works with Expo and bare React Native apps ✅
1313

1414
Includes iOS-style haptic and audio feedback 🍏
1515

16-
- [Demos 📱](#demos-)
17-
- [Installation 🚀](#installation-)
18-
- [Peer Dependencies 👶](#peer-dependencies-)
19-
- [Linear Gradient](#linear-gradient)
20-
- [Masked View](#masked-view)
21-
- [Examples 😎](#examples-)
22-
- [Timer Picker Modal (Dark Mode) 🌚](#timer-picker-modal-dark-mode-)
23-
- [Timer Picker Modal (Light Mode) 🌞](#timer-picker-modal-light-mode-)
24-
- [Timer Picker with Transparent Fade-Out (Dark Mode) 🌒](#timer-picker-with-transparent-fade-out-dark-mode-)
25-
- [Timer Picker with Customisation (Light Mode) 🌔](#timer-picker-with-customisation-light-mode-)
26-
- [Props 💅](#props-)
27-
- [TimerPicker ⏲️](#timerpicker-️)
28-
- [Custom Styles 👗](#custom-styles-)
29-
- [Performance](#performance)
30-
- [Custom FlatList](#custom-flatlist)
31-
- [TimerPickerModal ⏰](#timerpickermodal-)
32-
- [Custom Styles 👕](#custom-styles--1)
33-
- [Methods 🔄](#methods-)
34-
- [TimerPicker](#timerpicker)
35-
- [TimerPickerModal](#timerpickermodal)
36-
- [Picker Feedback](#picker-feedback-)
37-
- [Audio Feedback](#audio-feedback)
38-
- [Haptic Feedback](#haptic-feedback)
39-
- [Feedback Example](#feedback-example)
40-
- [Expo-Specific Audio/Haptic Feedback (DEPRECATED)](#expo-specific-audiohaptic-feedback-deprecated)
41-
- [Contributing 🧑‍🤝‍🧑](#contributing-)
42-
- [Dev Setup](#dev-setup)
43-
- [GitHub Guidelines](#github-guidelines)
44-
- [Limitations ⚠](#limitations-)
45-
- [License 📝](#license-)
16+
- [React Native Timer Picker ⏰🕰️⏳](#react-native-timer-picker-️)
17+
- [Demos 📱](#demos-)
18+
- [Installation 🚀](#installation-)
19+
- [Peer Dependencies 👶](#peer-dependencies-)
20+
- [Linear Gradient](#linear-gradient)
21+
- [Masked View](#masked-view)
22+
- [Examples 😎](#examples-)
23+
- [Timer Picker Modal (Dark Mode) 🌚](#timer-picker-modal-dark-mode-)
24+
- [Timer Picker Modal (Light Mode) 🌞](#timer-picker-modal-light-mode-)
25+
- [Timer Picker with Transparent Fade-Out (Dark Mode) 🌒](#timer-picker-with-transparent-fade-out-dark-mode-)
26+
- [Timer Picker with Customisation (Light Mode) 🌔](#timer-picker-with-customisation-light-mode-)
27+
- [Props 💅](#props-)
28+
- [TimerPicker ⏲️](#timerpicker-️)
29+
- [Custom Styles 👗](#custom-styles-)
30+
- [Performance](#performance)
31+
- [Custom FlatList](#custom-flatlist)
32+
- [TimerPickerModal ⏰](#timerpickermodal-)
33+
- [Custom Styles 👕](#custom-styles--1)
34+
- [Methods 🔄](#methods-)
35+
- [TimerPicker](#timerpicker)
36+
- [TimerPickerModal](#timerpickermodal)
37+
- [Picker Feedback 📳🔉](#picker-feedback-)
38+
- [Audio Feedack](#audio-feedack)
39+
- [Haptic Feedback](#haptic-feedback)
40+
- [Feedback Example](#feedback-example)
41+
- [Expo-Specific Audio/Haptic Feedback (DEPRECATED)](#expo-specific-audiohaptic-feedback-deprecated)
42+
- [Contributing 🧑‍🤝‍🧑](#contributing-)
43+
- [Dev Setup](#dev-setup)
44+
- [GitHub Guidelines](#github-guidelines)
45+
- [Limitations ⚠](#limitations-)
46+
- [License 📝](#license-)
4647

4748
<br>
4849

@@ -63,7 +64,7 @@ Includes iOS-style haptic and audio feedback 🍏
6364

6465
## Installation 🚀
6566

66-
Supports React Native >= 0.59.0 and React >= 16.8.0.
67+
Supports React Native >= 0.72.0 and React >= 18.2.0.
6768

6869
Just run:
6970

@@ -610,11 +611,11 @@ There is a challenge here with audio latency as we need to be able to play the c
610611
611612
Recommended libraries:
612613
613-
- [react-native-audio-api](https://www.npmjs.com/package/react-native-audio-api): this is a new library but is built by Software Mansion and has strong potential for our application with low-latency audio. It is not currently straightforward to use a local sound asset with this library; please check out the [Expo example](./examples/example-expo/App.tsx) and [Bare React Native example](./examples/example-bare//App.tsx) for a guide on how to do that. Note that this library will not work in Expo Go (you must create a development build).
614+
- [react-native-audio-api](https://www.npmjs.com/package/react-native-audio-api): this is a new library but it's built by Software Mansion and has strong potential for our application with low-latency audio. It is not currently straightforward to use a local sound asset with this library; please check out the [Expo example](./examples/example-expo/App.tsx) and [Bare React Native example](./examples/example-bare//App.tsx) for a guide on how to do that. Note that this library will not work in Expo Go (you must create a development build).
614615
615616
Libraries to avoid:
616617
617-
- [react-native-sound](https://www.npmjs.com/package/react-native-sound): this likely has low enough latency to work but has not been maintained for the 3+ years.
618+
- [react-native-sound](https://www.npmjs.com/package/react-native-sound): this likely has low enough latency to work but has not been maintained for 3+ years.
618619
- [expo-av](https://docs.expo.dev/versions/latest/sdk/av/): the latency is too high to work well. Expo are developing a new audio module [expo-audio](https://docs.expo.dev/versions/latest/sdk/audio/) that may be better, but at the time of writing (May 2025) it does not have the capability to repeatedly play the same sound.
619620
620621
### Haptic Feedback
@@ -749,7 +750,7 @@ There are two permenant branches: `main` and `develop`. You should never work di
749750
## Limitations ⚠
750751
751752
- The project is not compatibile with React Native versions prior to `v0.72.0` due to this [React Native issue](https://github.com/facebook/react-native/issues/36329).
752-
- The audio feedback provided by the `Audio` prop with `expo-av` suffers from high latency and doesn't work well when a user scrolls quickly. This has now been deprecated in place of the `pickerFeedback` prop. Please try `react-native-audio-api` for a lower latency audio library.
753+
- The audio feedback provided by the `Audio` prop with `expo-av` suffers from high latency and doesn't work well when a user scrolls quickly. This has now been deprecated in place of the `pickerFeedback` prop. Please try `react-native-audio-api` instead.
753754
754755
<br>
755756

examples/example-expo/package.json

Lines changed: 9 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -11,17 +11,16 @@
1111
"build:ios": "npx expo run:ios"
1212
},
1313
"dependencies": {
14-
"@expo/vector-icons": "^14.1.0",
14+
"@expo/vector-icons": "^15.0.2",
1515
"@react-native-masked-view/masked-view": "0.3.2",
16-
"expo": "^53.0.0",
17-
"expo-asset": "~11.1.5",
18-
"expo-av": "~15.1.4",
19-
"expo-font": "~13.3.1",
20-
"expo-haptics": "~14.1.4",
21-
"expo-linear-gradient": "~14.1.4",
22-
"react": "19.0.0",
23-
"react-native": "0.79.2",
24-
"react-native-audio-api": "0.6.0"
16+
"expo": "54.0.12",
17+
"expo-asset": "~12.0.9",
18+
"expo-font": "~14.0.8",
19+
"expo-haptics": "~15.0.7",
20+
"expo-linear-gradient": "~15.0.7",
21+
"react": "19.1.0",
22+
"react-native": "0.81.4",
23+
"react-native-audio-api": "0.9.0"
2524
},
2625
"private": true
2726
}

package.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@
66
"url": "https://github.com/troberts-28"
77
},
88
"license": "MIT",
9-
"version": "2.2.0",
9+
"version": "2.2.1",
1010
"main": "dist/commonjs/index.js",
1111
"module": "dist/module/index.js",
1212
"types": "dist/typescript/index.d.ts",

0 commit comments

Comments
 (0)