inappwebview_inspector 0.2.1

A powerful WebView inspector for flutter_inappwebview with real-time console monitoring, JavaScript execution, and script history management.

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

0.2.1 - 2025-09-15

🔧 Maintenance

• Documentation: Updated release date in CHANGELOG for accurate version history
• Version Management: Minor version bump for documentation corrections

---

0.2.0 - 2025-09-15

✨ Major New Features

🚀 Zero Setup Auto UI Injection (Game Changer)

• Automatic UI Injection: Inspector UI now auto-injects as overlay when show() or toggle() is called
• Smart Context Discovery: Automatic BuildContext discovery via WidgetsBinding and NavigatorKey fallback
• NavigatorKey Integration: Optional NavigatorKey support for optimal performance (navigatorKey: InAppWebViewInspector.navigatorKey)
• Hot Reload Compatible: Robust overlay system that works seamlessly with Flutter's hot reload
• Developer-Controlled: Auto-injection is enabled via debug mode initialization

🏗️ New Architecture Components

• InAppWebViewInspectorOverlayManager: Manages automatic UI injection and overlay lifecycle
• Enhanced InAppWebViewInspectorFactory: Improved service management with auto-injection support
• Smart context discovery system with multiple fallback strategies

🔄 Breaking Changes (Backward Compatible)

📦 Simplified Integration

• No Manual Widget Placement Required: Stack widgets with manual InAppWebViewInspectorWidget placement no longer needed
• Streamlined Setup: Just add NavigatorKey to MaterialApp and call toggle() - UI appears automatically
• Backward Compatibility: Old manual placement method still works but is deprecated

⚡ Performance Improvements

• Faster Context Discovery: NavigatorKey provides instant context access
• Reduced Widget Tree: No manual Stack widgets needed
• Optimized Overlay Management: Enhanced overlay lifecycle management

📋 Migration Guide (v0.1.x → v0.2.0)

Step 1: Update Dependency

dependencies:
  inappwebview_inspector: ^0.2.1  # Updated

Step 2: Add NavigatorKey (Recommended)

MaterialApp(
  navigatorKey: InAppWebViewInspector.navigatorKey, // Add this line
  home: YourHomePage(),
)

Step 3: Simplify UI (Optional)

Remove manual Stack placement - Inspector auto-injects as overlay:

// Before (v0.1.x): Manual Stack required
Scaffold(
  body: Stack(
    children: [
      YourContent(),
      const InAppWebViewInspectorWidget(), // Manual placement
    ],
  ),
)

// After (v0.2.0): Auto-injection (recommended)
Scaffold(
  body: YourContent(), // No Stack needed!
)
InAppWebViewInspector.toggle(); // UI auto-injects

🐛 Bug Fixes

• Fixed overlay context discovery issues
• Improved error handling for missing context scenarios
• Better fallback mechanisms for different app architectures
• Enhanced hot reload stability

📚 Documentation Updates

• Comprehensive migration guide in all README files (English, Korean, Japanese)
• Updated code examples showcasing auto-injection
• Enhanced troubleshooting sections
• Clear before/after migration examples

---

0.1.2 - 2025-08-08

🔧 Improvements

• pub.dev Package Score: Improved package metadata and formatting
  • Fixed package description length (199+ → 142 characters for better SEO)
  • Fixed GitHub issue tracker URL typo (baccusff → baccusf)
  • Applied Dart formatting to all source files for consistent code style
• Documentation: Added solution for git-sourced flutter_inappwebview dependency conflicts
  • Added dependency_overrides examples in all README files (English, Korean, Japanese)
  • Resolved common user integration issues with clear step-by-step instructions

🐛 Bug Fixes

• Package Validation: All pub.dev validation checks now pass
• Static Analysis: Applied consistent Dart formatting across all files

0.1.1 - 2025-08-08

🔧 Improvements

• Enhanced Compatibility: Updated SDK version requirements to match flutter_inappwebview ^6.1.5
  • Dart SDK: ^3.0.6 → ^3.5.0
  • Flutter: >=3.0.0 → >=3.24.0
• Updated Dependencies: Kept flutter_lints at ^5.0.0 for broader SDK compatibility
• Documentation:
  • Updated README files and fixed repository URLs
  • Removed outdated build error note about isInspectable vs debuggingEnabled
• Licensing: Added proper MIT License file

0.1.0 - 2025-08-08

🎉 Initial Release

• Developed with Claude AI: This library was created using Vibe coding methodology in collaboration with Claude AI, showcasing AI-assisted development capabilities.

✨ Features Added

• Real-time Console Monitoring: Live monitoring of JavaScript console messages (log, warn, error, debug) with color-coded display and timestamps
• Enhanced JavaScript Execution: Interactive console with intelligent DOM object handling
  • Smart serialization for document.querySelector() and document.querySelectorAll()
  • Automatic conversion of DOM objects to readable format
  • Enhanced error handling with helpful suggestions
• Intelligent Script History System:
  • 15+ pre-loaded commonly used JavaScript snippets
  • Frequency-based sorting with usage tracking
  • Memory-based storage for fast performance
• Multi-WebView Support: Handle multiple WebViews with easy switching and individual monitoring
• Comprehensive Internationalization: Support for 8 languages (English, Korean, Japanese, Spanish, French, German, Chinese Simplified, Portuguese)
• Advanced UI Interface:
  • Draggable overlay with SafeArea constraints
  • Resizable interface (compact/maximized modes)
  • Stack-based popup system for stability
  • Clean design without unnecessary labels

🛠️ Technical Improvements

• Script Utilities: InAppWebViewInspectorScriptUtils for safe DOM object serialization
• Enhanced Error Handling: Comprehensive error messages with suggestions for common DOM operations
• Memory-based History: Fast, lightweight script history management without file I/O
• Clean Console Output: Removed User Input: and Script Result: labels for streamlined debugging

🌐 Platform Support

• Android: ✅ Full support with all features
• iOS: ✅ Full support with all features

📚 Documentation

• Multi-language README: Complete documentation in English, Korean, and Japanese
• Comprehensive Examples: Complete integration examples and advanced usage scenarios
• Developer Guide: Detailed CLAUDE.md for development guidance

🔧 Configuration Options

• Development Mode: Enhanced features with full script history and debugging capabilities
• Production Mode: Minimal impact mode with reduced features
• Custom Configuration: Flexible configuration with callbacks and feature toggles

⚠️ Important Notes

• Widget must be placed inside Scaffold body Stack (not MaterialApp.builder)
• Requires flutter_inappwebview: ^6.0.0
• Flutter >= 3.0.0 and Dart >= 3.0.6 required