[Animations] add example to openCntainer

packages/animations/CHANGELOG.md

@@ -1,6 +1,7 @@
-## NEXT
+## 2.1.2
 
 * Updates minimum supported SDK version to Flutter 3.35/Dart 3.9.
+* Adds an example of using `OpenContainer`
 
 ## 2.1.1
 

packages/animations/lib/src/open_container.dart

@@ -66,7 +66,46 @@ typedef ClosedCallback<S> = void Function(S data);
 /// `T` refers to the type of data returned by the route when the container
 /// is closed. This value can be accessed in the `onClosed` function.
 ///
-// TODO(goderbauer): Add example animations and sample code.
+/// The following example shows an [OpenContainer] that transforms a blue
+/// container widget into a full screen page using the Material container
+/// transform animation. When the user taps the closed widget, the container
+/// expands and morphs into the destination page defined in [openBuilder],
+/// while the original widget from [closedBuilder] fades out during the
+/// transition.
+///
+/// ```dart
+/// OpenContainer(
+///   transitionDuration: const Duration(milliseconds: 500),
+///   transitionType: ContainerTransitionType.fadeThrough,
+///   openBuilder: (context, action) {
+///     return Scaffold(
+///       appBar: AppBar(title: const Text('Details Page')),
+///       body: const Center(
+///         child: Text(
+///           'This page opened with Container Transform animation',
+///           style: TextStyle(fontSize: 18),
+///           textAlign: TextAlign.center,
+///         ),
+///       ),
+///     );
+///   },
+///   closedBuilder: (context, action) {
+///     return Container(
+///       width: 200,
+///       height: 120,
+///       alignment: Alignment.center,
+///       decoration: BoxDecoration(
+///         color: Colors.blue,
+///         borderRadius: BorderRadius.circular(16),
+///       ),
+///       child: const Text(
+///         'Open Details',
+///         style: TextStyle(color: Colors.white, fontSize: 18),
+///       ),
+///     );
+///   },
+/// ),
+/// ```
 ///
 /// See also:
 ///

packages/animations/pubspec.yaml

@@ -2,7 +2,7 @@ name: animations
 description: Fancy pre-built animations that can easily be integrated into any Flutter application.
 repository: https://github.com/flutter/packages/tree/main/packages/animations
 issue_tracker: https://github.com/flutter/flutter/issues?q=is%3Aissue+is%3Aopen+label%3A%22p%3A+animations%22
-version: 2.1.1
+version: 2.1.2
 
 environment:
   sdk: ^3.9.0