Merge pull request #9 from melvinmt/voice

Add Speech Recognition

Author: melvinmt

.gitignore

@@ -32,6 +32,7 @@ yarn-error.log*
 .expo/
 .expo-shared/
 dist/
+dist-ios/
 web-build/
 *.jks
 *.p8

README.md

@@ -78,6 +78,8 @@ npm install
 
 #### Development Mode (Expo Go)
 
+**Note**: Speech recognition features require a native build and cannot run in Expo Go. For full functionality, use native development mode (see below).
+
 ```bash
 # Start the development server
 npm start
@@ -91,19 +93,50 @@ Then:
 - Press `a` for Android Emulator
 - Scan QR code with Expo Go app on physical device
 
-#### After Prebuild (Native Development)
+#### Native Development (Required for Speech Recognition)
 
-If you've run `npx expo prebuild` to generate native iOS/Android projects:
+Speech recognition features require a native build. Follow these steps:
 
+1. **Install dependencies and prebuild native code**:
 ```bash
-# For iOS - this will start Metro and build/run the app
-npx expo run:ios
+# Install npm dependencies
+npm install
+
+# Generate native iOS/Android projects
+# Use WITHOUT --clean to preserve existing Xcode project settings
+# Only use --clean if you need a completely fresh start
+npx expo prebuild
+
+# For iOS, install CocoaPods dependencies
+cd ios && pod install && cd ..
+```
+
+**Important**: 
+- Use `npx expo prebuild` (without `--clean`) to preserve your existing Xcode project settings
+- Only use `npx expo prebuild --clean` when you need a completely fresh native project (this will overwrite all custom settings)
+- If you have custom Xcode settings, consider using [Expo config plugins](https://docs.expo.dev/guides/config-plugins/) to apply them programmatically
 
-# For Android
+2. **Run on a physical device** (speech recognition requires a physical device):
+```bash
+# For iOS - requires physical device connected
+npx expo run:ios --device
+
+# For Android - can use emulator or physical device
 npx expo run:android
 ```
 
-**Important**: After prebuild, always use `npx expo run:ios` or `npx expo run:android` rather than opening Xcode/Android Studio directly. This ensures Metro bundler is properly configured and the entry point resolves correctly.
+**Important Notes**:
+- **iOS Simulator does NOT support speech recognition** - you must use a physical iOS device
+- After prebuild, always use `npx expo run:ios` or `npx expo run:android` rather than opening Xcode/Android Studio directly
+- The app will gracefully degrade if microphone/speech permissions are denied - it will work normally without pronunciation checks
+
+#### Permissions
+
+The app requests the following permissions:
+- **Microphone**: Required for speech recognition to help children practice pronunciation
+- **Speech Recognition**: Required to validate pronunciation accuracy
+
+Both permissions are optional - the app functions normally if permissions are denied, just without pronunciation validation features.
 
 ## 📁 Project Structure
 

app.json

@@ -16,7 +16,10 @@
     ],
     "ios": {
       "supportsTablet": true,
-      "bundleIdentifier": "com.earlyreader.app"
+      "bundleIdentifier": "com.earlyreader.app",
+      "infoPlist": {
+        "ITSAppUsesNonExemptEncryption": false
+      }
     },
     "android": {
       "adaptiveIcon": {
@@ -30,7 +33,14 @@
     },
     "scheme": "earlyreader",
     "plugins": [
-      "expo-router"
+      "expo-router",
+      [
+        "@react-native-voice/voice",
+        {
+          "microphonePermission": "Early Reader needs access to your microphone to help your child practice pronunciation.",
+          "speechRecognitionPermission": "Early Reader needs speech recognition to help your child learn to read by practicing pronunciation."
+        }
+      ]
     ],
     "newArchEnabled": true
   }

app/children.tsx

@@ -19,3 +19,4 @@ export default ChildSelectionScreen;
 
 
 
+

app/onboarding/add-children.tsx

@@ -19,3 +19,4 @@ export default AddChildrenScreen;
 
 
 
+

assets/.gitkeep

@@ -18,3 +18,4 @@
 
 
 
+

babel.config.js

@@ -26,3 +26,4 @@ module.exports = function(api) {
 
 
 
+

features.json

@@ -201,3 +201,4 @@
 
 
 
+

ios/.gitignore

@@ -1,9 +1,10 @@
 # OSX
+#
 .DS_Store
 
-# Xcode - user-specific and build artifacts
+# Xcode
+#
 build/
-DerivedData/
 *.pbxuser
 !default.pbxuser
 *.mode1v3
@@ -12,19 +13,18 @@ DerivedData/
 !default.mode2v3
 *.perspectivev3
 !default.perspectivev3
-xcuserdata/
+xcuserdata
 *.xccheckout
 *.moved-aside
+DerivedData
 *.hmap
+*.ipa
 *.xcuserstate
+project.xcworkspace
 .xcode.env.local
 
-# Keep xcworkspace but ignore user data inside it
-*.xcworkspace/xcuserdata/
-
 # Bundle artifacts
 *.jsbundle
 
-# CocoaPods - can be regenerated from Podfile
+# CocoaPods
 /Pods/
-Podfile.lock