🚀 ZikZak InAppWebView

The Feature-Rich WebView Plugin for Flutter

---

A Flutter plugin that allows you to add an inline WebView, use an headless WebView, and open an in-app browser window. This is a community-driven fork of flutter_inappwebview focused on active maintenance, stability, and modern platform support.

Sponsor

Thanks to ZikZak AI for sponsoring this project!

ZikZak AI is an AI-Powered Price Comparison app that you scan barcodes, and discover amazing savings instantly. Your personal shopping assistant that never sleeps.

Documentation | Pub.dev | API Reference | Changelog

---

✨ Key Features

• All 6 Platforms: Android, iOS, Web, macOS, Windows, and Linux.
• In-App Browser: Full-featured browser window inside your app with toolbar, progress bar, and navigation controls.
• Headless WebView: Run WebView in the background without a UI — perfect for scraping, pre-rendering, or data extraction.
• Rich API: Comprehensive control over navigation, cookies, JavaScript evaluation, content blockers, scripts, and more.
• Modern Security: Enhanced URL validation, content process recovery, and OEM crash protection.
• SPM + CocoaPods: iOS now uses Swift Package Manager for smaller app sizes and faster builds.

📦 Installation

Add zikzak_inappwebview to your pubspec.yaml:

dependencies:
  zikzak_inappwebview: ^6.3.2

⚙️ Requirements

Platform	Minimum Version	Notes
Flutter	3.10.0+
Android	API 24+	Android 7.0+
iOS	15.0+
macOS	12.0+
Windows	10+	Requires WebView2 Runtime
Linux		Requires WebKitGTK 2.40+
Web	Any

⚠️ Known Issues

[iOS] Flutter 3.47.x: platform views drop overlapping Flutter content (#331)

On the Flutter 3.47.x stable line, iOS platform views — including InAppWebView — can make the Flutter content painted after them vanish from the frame ("rendering layer confusion"): an AppBar turns invisible, a modal bottom sheet's footer and the list items below a WebView card are not drawn. Upgrading from 3.44.x to 3.47.2 triggers it; the same app renders correctly on 3.44.x. It reproduces with Impeller disabled, so it is not an Impeller rasterizer bug.

This is an engine regression in Flutter's texture-layer hybrid composition (TLHC) overlay path, tracked upstream in flutter/flutter#193363 (triaged engine / platform-views, c: regression). It is not a plugin code defect: the on-device mitigation matrix in .specify/bugs/flutter347-platformview-rendering/fix.md (§ Mitigation matrix) leaves the artifact unchanged for every candidate tested.

The symptom, the evidence and the workarounds are documented once, in the package README's Known Issues section — that copy is canonical, so read and edit it there.

🚀 Getting Started

Check out the online documentation for comprehensive guides and examples.

import 'package:zikzak_inappwebview/zikzak_inappwebview.dart';

// ... inside your widget tree
InAppWebView(
  initialUrlRequest: URLRequest(url: WebUri("https://flutter.dev")),
  onWebViewCreated: (controller) {
    // Controller is ready!
  },
)

📦 Migration from flutter_inappwebview

Simply replace the import:

// Before
import 'package:flutter_inappwebview/flutter_inappwebview.dart';

// After
import 'package:zikzak_inappwebview/zikzak_inappwebview.dart';

The API is nearly identical. Version 4.x.x corresponds to upstream 6.x.x. This fork has resolved all 156+ upstream issues and added critical fixes for SPM migration, Web platform support, Windows WebView2, and OEM device compatibility.

Note — JavaScript bridge global. The injected JavaScript bridge global is window.zikzak_inappwebview (not window.flutter_inappwebview). After migrating, call handlers via window.zikzak_inappwebview.callHandler(...). The flutterInAppWebViewPlatformReady event name is unchanged.

📊 Project Stats

• 156+ upstream issues triaged and tracked in UPSTREAM_ISSUES_TRIAGE.md
• 9 packages published to pub.dev
• 6 platforms actively maintained
• Active daily development with CI, code reviews, and automated publishing

⭐ Star History

Star History

🤝 Contributing

Contributions are welcome! If you find a bug or have a feature request, please open an issue.

⚖️ License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.