Ios

.gitignore

@@ -5,9 +5,11 @@
 *.swp
 .DS_Store
 .atom/
+.build/
 .buildlog/
 .history
 .svn/
+.swiftpm/
 migrate_working_dir/
 
 # IntelliJ related

.metadata

@@ -4,7 +4,7 @@
 # This file should be version controlled and should not be manually edited.
 
 version:
-  revision: "2663184aa79047d0a33a14a3b607954f8fdd8730"
+  revision: "20f82749394e68bcfbbeee96bad384abaae09c13"
   channel: "stable"
 
 project_type: app
@@ -13,26 +13,11 @@ project_type: app
 migration:
   platforms:
     - platform: root
-      create_revision: 2663184aa79047d0a33a14a3b607954f8fdd8730
-      base_revision: 2663184aa79047d0a33a14a3b607954f8fdd8730
-    - platform: android
-      create_revision: 2663184aa79047d0a33a14a3b607954f8fdd8730
-      base_revision: 2663184aa79047d0a33a14a3b607954f8fdd8730
+      create_revision: 20f82749394e68bcfbbeee96bad384abaae09c13
+      base_revision: 20f82749394e68bcfbbeee96bad384abaae09c13
     - platform: ios
-      create_revision: 2663184aa79047d0a33a14a3b607954f8fdd8730
-      base_revision: 2663184aa79047d0a33a14a3b607954f8fdd8730
-    - platform: linux
-      create_revision: 2663184aa79047d0a33a14a3b607954f8fdd8730
-      base_revision: 2663184aa79047d0a33a14a3b607954f8fdd8730
-    - platform: macos
-      create_revision: 2663184aa79047d0a33a14a3b607954f8fdd8730
-      base_revision: 2663184aa79047d0a33a14a3b607954f8fdd8730
-    - platform: web
-      create_revision: 2663184aa79047d0a33a14a3b607954f8fdd8730
-      base_revision: 2663184aa79047d0a33a14a3b607954f8fdd8730
-    - platform: windows
-      create_revision: 2663184aa79047d0a33a14a3b607954f8fdd8730
-      base_revision: 2663184aa79047d0a33a14a3b607954f8fdd8730
+      create_revision: 20f82749394e68bcfbbeee96bad384abaae09c13
+      base_revision: 20f82749394e68bcfbbeee96bad384abaae09c13
 
   # User provided section
 

README.md

@@ -1,16 +1,113 @@
-# nettruyenreader
+# NetTruyen Reader
 
-A new Flutter project.
+A polished, ad-free comic reading experience for NetTruyen.
 
-## Getting Started
+## Features
 
-This project is a starting point for a Flutter application.
+- **Network Error Handling**: Comprehensive error handling for network connectivity issues
+- **Retry Logic**: Automatic retry with exponential backoff for failed requests
+- **User-Friendly Error Messages**: Clear, actionable error messages instead of technical jargon
+- **Network Status Indicator**: Real-time network connectivity status
+- **Offline Support**: Cached content for offline reading
 
-A few resources to get you started if this is your first Flutter project:
+## Network Error Handling
 
-- [Lab: Write your first Flutter app](https://docs.flutter.dev/get-started/codelab)
-- [Cookbook: Useful Flutter samples](https://docs.flutter.dev/cookbook)
+The app includes robust error handling for various network scenarios:
 
-For help getting started with Flutter development, view the
-[online documentation](https://docs.flutter.dev/), which offers tutorials,
-samples, guidance on mobile development, and a full API reference.
+### Connection Refused Error
+- **Cause**: Server is down, blocked, or unreachable
+- **Solution**: The app will automatically retry with exponential backoff
+- **User Action**: Check internet connection and try again later
+
+### Connection Timeout
+- **Cause**: Slow network or server response
+- **Solution**: Automatic retry with increased timeout
+- **User Action**: Check network speed and try again
+
+### DNS Resolution Issues
+- **Cause**: Unable to resolve domain names
+- **Solution**: Check internet connection and DNS settings
+- **User Action**: Try switching networks or using a VPN
+
+### Server Errors (403, 404, 500)
+- **Cause**: Server-side issues or access restrictions
+- **Solution**: App shows appropriate error messages
+- **User Action**: Wait and retry, or contact support
+
+## Troubleshooting
+
+### If you're getting "Connection refused" errors:
+
+1. **Check your internet connection**
+   - Try accessing other websites
+   - Restart your router if needed
+
+2. **Try using a VPN**
+   - The site might be blocked in your region
+   - Use a VPN service to bypass restrictions
+
+3. **Check if the site is down**
+   - Visit nettruyenvio.com in your browser
+   - Check if the site is accessible
+
+4. **Clear app cache**
+   - Go to Settings > Apps > NetTruyen Reader > Clear Cache
+   - Restart the app
+
+### If you're getting "Cloudflare blocked" errors:
+
+1. **Wait a few minutes**
+   - Cloudflare protection might be temporary
+   - Try again after 5-10 minutes
+
+2. **Use the "Verify you are human" option**
+   - The app will open a browser window
+   - Complete the Cloudflare challenge
+   - Return to the app
+
+3. **Try a different network**
+   - Switch from WiFi to mobile data
+   - Or vice versa
+
+## Error Messages
+
+The app provides user-friendly error messages:
+
+- **"Unable to connect to the server"** - Network connectivity issue
+- **"Connection timed out"** - Slow network or server response
+- **"Access blocked by Cloudflare"** - Site protection active
+- **"Server error"** - Temporary server issues
+
+## Technical Details
+
+### Retry Logic
+- Maximum 3 retry attempts
+- Exponential backoff (2s, 4s, 6s delays)
+- Different handling for different error types
+
+### Network Status Indicator
+- Shows real-time connectivity status
+- Checks both general internet and site accessibility
+- Auto-refreshes when tapped
+
+### Error Recovery
+- Automatic retry on network restoration
+- Manual retry buttons on error screens
+- Graceful degradation for offline scenarios
+
+## Development
+
+### Running the app
+```bash
+flutter pub get
+flutter run
+```
+
+### Testing network error handling
+- Disconnect from internet to test offline scenarios
+- Use network throttling tools to test slow connections
+- Block specific domains to test DNS issues
+
+## License
+
+This project is for educational purposes only.