flutter-home-screen-widget

Installation
Summary

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
SKILL.md

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

  1. Initialize Dependencies Add the home_widget package to the Flutter project.

    flutter pub add home_widget
    flutter pub get
    
  2. 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?"
Related skills
Installs
546
Repository
flutter/skills
GitHub Stars
1.9K
First Seen
Mar 9, 2026