Universal Android WebView App | Full Applications

✨ Key Features

• Modern WebView with Chrome-compatible features, safe browsing, and multiple windows support.
• PWA support: Service worker caching, add-to-home hints, and custom splash for web apps that support it.
• Deep links & navigation: Open internal links in-app; route external hosts via Custom Tabs or system browser.
• File upload & camera: Image/file picker, camera capture, and input[type=file] handling.
• Downloads: Integrated Android DownloadManager with notifications and runtime permissions.
• Geolocation & media: Optional GPS prompts; microphone/camera access for web meetings.
• Pull-to-refresh & smart caching: Smooth refresh, cache policies, and error/timeout screens with retry.
• Offline fallback: Graceful “no internet” page with reload and troubleshooting tips.
• AdMob & monetization: Banner/interstitial/native ads (test mode ready) and in-house promo banners.
• Push notifications: Firebase Cloud Messaging or OneSignal (topic/user targeting, optional).
• Rate & share intent: In-app rate prompts, social share, and open in browser overflow actions.
• Security: HTTPS enforcement, domain allowlist, SSL error handling, optional SSL pinning.
• JavaScript bridge: Native ↔ Web messaging hooks for advanced integrations.
• Theming: Material theming, light/dark mode, custom splash & launch screen.
• Analytics hooks: Screen load timing, error telemetry, and event tracking stubs.
• Accessibility: Larger text support, talkback labels, and focus-aware navigation.

⚙️ Technical Stack

• Language: Kotlin (primary), Java-interop friendly
• UI/Framework: AndroidX, Material Components, SplashScreen API
• Web: Android System WebView, Chrome Custom Tabs, optional Trusted Web Activity*
• Services (optional): Firebase (FCM, Analytics, Crashlytics), OneSignal, AdMob
• Min SDK: 21+ (Android 5.0 Lollipop) – configurable
• Build: Gradle (AGP 8+), Android Studio (latest stable)
• Server requirements: HTTPS with valid TLS, CORS configured for uploads/JS bridge; for PWA, service worker + manifest.json

*TWA requires verified ownership and Digital Asset Links; keep using standard WebView if you don’t need full PWA immersion.

🧩 Installation Guide

1. Open project in Android Studio and let Gradle sync.
2. Set your URL in Config.kt (e.g., BASE_URL), and define a domain allowlist.
3. Branding: Update app name, icon, colors, and splash assets.
4. Permissions: Enable camera/mic/location/storage only if your site needs them.
5. Push & ads (optional): Add google-services.json, configure FCM/OneSignal and AdMob IDs (test mode).
6. Security: Enforce HTTPS; enable SSL pinning if required; set mixed-content mode to never.
7. Build & test: Run on device/emulator; verify uploads, downloads, deep links, and offline screens.
8. Release: Enable R8/ProGuard, create signing config, generate AAB, and prepare Play listing.

📦 Deliverables

• Complete Android Studio project (Kotlin, AndroidX)
• Configurable WebView wrapper with allowlist and JS bridge
• Offline/error screens, pull-to-refresh, download/file-chooser modules
• Optional integrations (Firebase/OneSignal, AdMob stubs)
• ProGuard/R8 rules, app icon & splash templates
• Quick-start documentation and configuration notes
• GPL license file and redistribution notice

📱 Supported Platforms

• Android phones: API 21+ through latest
• Tablets & Chromebooks: Adaptive layouts and pointer input friendly

🧠 Notes

• License: Distributed under the GPL for learning, auditing, and derivative works.
• Customization tips (Expertise): Centralize BASE_URL, colors, and host allowlist; route external hosts to Custom Tabs; add domain verification for deep links/TWA; expose minimal JS bridge functions for security.
• Performance: Enable HTTP/2 on hosting, compress assets, use service worker caching for PWAs, and minimize heavy iframes.
• Store listing SEO: Use “WebView” + your brand/category keywords, localized descriptions, high-contrast screenshots, and short promo video.
• Compliance & privacy: Provide a privacy policy, disclose data/permissions, and respect user consent (GDPR/CCPA).

👨‍💻 Original Developer Credit

This description acknowledges the original Universal Android WebView authors who publish on marketplaces like
CodeCanyon. Please support the
original developer by purchasing their commercial license when your project requires it.

🔒 Disclaimer

Provided for educational and evaluation purposes under the GPL. This package may reference third-party
services (Firebase, OneSignal, AdMob) that require your own accounts/keys. All trademarks, images, and content are property of their owners.
You are responsible for legal compliance (licenses, assets, privacy) and for honoring any original developer
terms, including purchasing a commercial license if needed. No demo links are included.