feat: Enhance TTS player functionality and UI

- Added resume functionality to TTS player when paused.
- Display voice name or language in TTS player UI.
- Improved error handling in reader provider with debug messages.
- Updated TTS service to configure Vietnamese voice and handle platform-specific audio settings.
- Removed wakelock dependency and related code.
- Fixed search screen error handling.
- Updated settings screen to navigate to home after sign out.
- Improved splash screen with timer management.
- Enhanced main app error handling with logging.
- Removed unused package_info_plus and wakelock_plus dependencies.
- Added environment variable support for mobile runtime.
- Integrated Google Sign-In configuration for Android.
- Created logging observer for Riverpod providers.
- Added scripts for environment setup and Google Sign-In validation.

README.md

@@ -30,3 +30,88 @@ Flutter mobile app for reading novels, synced with the existing web platform.
 flutter pub get
 flutter run
 ```
+
+Run with env file (recommended for local dev):
+
+1. Create local env from sample:
+
+```bash
+cp .env.mobile.example .env.mobile
+```
+
+1. Start app using env values:
+
+```bash
+bash scripts/flutter_run_with_env.sh
+```
+
+This script reads `.env.mobile` and automatically passes:
+
+- `BASE_URL`
+- `GOOGLE_SERVER_CLIENT_ID`
+- optional `GOOGLE_CLIENT_ID`
+
+Default `BASE_URL` behavior:
+
+- Android emulator: `http://10.0.2.2:8000`
+- Others (iOS simulator, desktop, web): `http://localhost:8000`
+
+If needed, you can still override explicitly:
+
+```bash
+flutter run --dart-define=BASE_URL=http://localhost:8000
+```
+
+For Android emulator, use:
+
+```bash
+flutter run --dart-define=BASE_URL=http://10.0.2.2:8000
+```
+
+For a physical device in dev, use your computer LAN IP (same Wi-Fi):
+
+```bash
+flutter run --dart-define=BASE_URL=http://<YOUR_LAN_IP>:8000
+```
+
+Important notes for physical devices:
+
+- Use the Wi-Fi LAN IP from `en0` (example: `10.17.2.62`).
+- Do NOT use VPN/tunnel IPs from `utun` (example: `100.x.x.x`) unless your phone is connected to the same VPN.
+- Keep phone and computer on the same Wi-Fi network.
+
+Android over USB (stable local tunnel):
+
+```bash
+adb reverse tcp:8000 tcp:8000
+flutter run --dart-define=BASE_URL=http://127.0.0.1:8000
+```
+
+## Google Sign-In (Android)
+
+If you see `PlatformException ... ApiException: 10`, it is usually an OAuth config mismatch.
+
+Checklist:
+
+- `android/app/google-services.json` must exist and match package name `com.example.reader_app`.
+- Add SHA-1 and SHA-256 fingerprints of your debug keystore to Firebase Android app settings.
+- Ensure OAuth client IDs are created after adding SHA fingerprints.
+- Run with server/web client id for backend token verification:
+
+```bash
+# Bước 1: Khởi động emulator
+flutter emulators --launch Pixel_8_API_35
+flutter run
+```
+
+```bash
+flutter run \
+  --dart-define=BASE_URL=http://127.0.0.1:8000 \
+  --dart-define=GOOGLE_SERVER_CLIENT_ID=<YOUR_WEB_CLIENT_ID>.apps.googleusercontent.com
+```
+
+Optional (iOS/web):
+
+```bash
+--dart-define=GOOGLE_CLIENT_ID=<YOUR_IOS_OR_WEB_CLIENT_ID>.apps.googleusercontent.com
+```