flutter-home-screen-widget

SKILL.md

Native home screen widgets for Flutter apps on iOS and Android with cross-platform data sharing.

Establishes data sharing between Dart and native platforms via App Groups (iOS) and SharedPreferences (Android), enabling widget updates from your Flutter app

Supports simple text-based widgets and complex Flutter UI rendered as static images for native display

Requires native setup in Xcode (Widget Extension target with Swift TimelineProvider) and Android Studio (AppWidgetProvider with XML layout and Kotlin implementation)

App Group IDs and widget names must match exactly across Dart, Swift, and Kotlin; native code changes require full rebuild and widget re-addition on the home screen

flutter-home-screen-widgets

Goal

Implements native home screen widgets (iOS and Android) for a Flutter application using the home_widget package. It establishes data sharing between the Dart environment and native platforms via App Groups (iOS) and SharedPreferences (Android), enabling text updates and rendering Flutter UI components as images for native display. Assumes a pre-existing Flutter project environment with native build tools (Xcode and Android Studio) configured.

Instructions

Initialize Dependencies
Add the home_widget package to the Flutter project.

flutter pub add home_widget
flutter pub get

Decision Logic: Platform & Feature Selection
Determine the target platforms and required widget capabilities.
[BLOCKING] User Consultation
BEFORE performing any implementation, you MUST ask:

"Which platforms are you targeting?"

"Do you need simple text or complex UI?"