app_widget

Package Overview

Package selection guidance compiled from public package information, community data, and project usage.

The app_widget package is a Flutter plugin designed to enable developers to manage app widgets and home screen widgets directly from within a Flutter application. It provides functionality to update, create, or remove widgets on Android devices, allowing dynamic interaction with the home screen. This package integrates seamlessly with Flutter's ecosystem and simplifies widget management without requiring native code. It is particularly useful for apps that benefit from real-time updates displayed on the home screen, such as calendars, weather apps, or task trackers.

Use cases

Updating home screen widgets from within the app
Creating dynamic app widgets
Synchronizing widget data with app state
Enabling user-triggered widget updates
Integrating widget management into app settings

Key features

Android-only support
Simple API for widget updates
Integration with Flutter lifecycle
Supports custom widget configurations
No need for native Java/Kotlin code

Suitable for

Developers building interactive Android apps
Apps requiring live home screen updates
Teams wanting to avoid native platform code
Projects focused on user engagement via widgets
Flutter apps targeting Android home screen integration

Considerations

Limited to Android platform
Requires Android-specific permissions
May not work on all device manufacturers
Widget behavior can vary across Android versions
Needs testing on multiple Android devices

Original README

Original README snapshot from the linked source repository. Visit the repository for the latest content.

Flutter App Widget

App Widget / Home Screen widget plugin for flutter app

Usage

Please see app_widget subdirectory for the usage documentation.

Plaform Support

Android	iOS
✔️

Project Structure

This project follow the standard for flutter plugin development where each pieces are independent of each other. Other platform interface can be easily added by inherit the base platform interface and expose the require api to the main app_wiget plugin.

Contributing

Fork
Checkout to feature branch
Add feature and unit test
Make sure all unit test pass
Add platform integration test and run integration test
Create a PR

Android Integration Test

Make sure to run on the latest and minSdk supported

in app_widget/example/integration_test/app_widget_test.dart

cd app_widget/example
# this will require a connected device for android
flutter test integration_test/app_widget_test.dart

Search categories, packages and repositories

Install package