flutter-embedding-native-views

Installation
Summary

Embed native Android, iOS, or macOS views and web content directly into Flutter applications.

  • Supports two Android composition modes (Hybrid and Texture Layer) with distinct performance and fidelity tradeoffs; iOS and macOS use Hybrid Composition exclusively
  • Includes step-by-step workflows for implementing platform views on Android and iOS, with validation and troubleshooting guidance
  • Enables embedding Flutter into existing web applications via Full Page or Multi-view (Embedded) mode, with JavaScript and Dart configuration examples
  • Provides performance mitigation strategies, such as rendering native view screenshots as placeholder textures during complex animations
SKILL.md

Integrating Platform Views and Web Content

Contents

Platform Views Architecture

Platform Views allow embedding native views (Android, iOS, macOS) directly into a Flutter application, enabling the application of transforms, clips, and opacity from Dart.

Android Implementations (API 23+)

Choose the appropriate implementation based on your performance and fidelity requirements:

  • Hybrid Composition: Renders Flutter content into a texture and uses SurfaceFlinger to compose both.
    • Pros: Best performance and fidelity for Android views.
    • Cons: Lowers overall application FPS. Certain Flutter widget transformations will not work.
  • Texture Layer (Texture Layer Hybrid Composition): Renders Platform Views into a texture. Flutter draws them via the texture and renders its own content directly into a Surface.
Related skills
Installs
8.2K
Repository
flutter/skills
GitHub Stars
1.9K
First Seen
Mar 13, 2026