unwrapper 0.0.1

Published Aug 12, 2025

SDKflutter

Platformandroidioswindowslinuxmacosweb

Unwrapper is a lightweight Flutter widget that lets you 'unwrap' a parent widget and render one of its inner children instead. It's useful for dynamically skipping layout wrappers (like Container, Padding, or Column) and directly rendering their contents. Supports optional fallback rendering, custom unwrapping logic, and post-processing via a wrapper builder.

🧩 Unwrapper

Unwrapper is a lightweight and flexible Flutter widget that lets you unwrap a parent widget and render one of its children directly — useful for dynamically skipping layout wrappers like Container, Padding, or custom widgets.

Features

Skip rendering the outer widget and show only its inner child or a specific child.
Custom unwrapping logic via a resolver callback.
Select a child by index when the widget has multiple children.
Optionally wrap the unwrapped widget using a wrapperBuilder.
Fallback widget if unwrapping fails.
Clean, declarative, and reusable API.

Getting Started

Add the dependency in your pubspec.yaml:

dependencies:
  unwrapper: latest_version

Then install it:

flutter pub get

Basic Usage

import 'package:unwrapper/unwrapper.dart';

Unwrapper(
  unwrap: true,
  child: Container(
    child: Text('Hello World'),
  ),
);

This renders just the Text('Hello World'), skipping the Container.

Parameters

Parameter	Type	Description
`child`	`Widget`	The widget to potentially unwrap. (Required)
`unwrap`	`bool`	Whether to unwrap or render the widget as-is. (Default: true)
`childrenIndex`	`int`	Index to use if `child` has a `children` list. (Default: 0)
`fallback`	`Widget`	Fallback widget if unwrapping fails. (Default: SizedBox.shrink())
`wrapperBuilder`	`Widget Function(Widget unwrapped)`	Optional builder to wrap the unwrapped widget.
`resolver`	`Widget? Function(Widget wrapper)`	Custom logic to determine what to unwrap.

Example with `childrenIndex`

Unwrapper(
  unwrap: true,
  childrenIndex: 1,
  child: Column(
    children: [
      Text('Header'),
      Text('Main Content'),
    ],
  ),
);

This unwraps and renders only the second child (Text('Main Content')).

Example with `resolver` (Custom Widget)

You can define your own custom wrapper widget and use a resolver to unwrap it:

/// A custom wrapper widget with a `customChild` property.
class MyWrapper extends StatelessWidget {
  final Widget customChild;

  const MyWrapper({super.key, required this.customChild});

  @override
  Widget build(BuildContext context) {
    return Container(
      padding: const EdgeInsets.all(12),
      decoration: BoxDecoration(border: Border.all()),
      child: customChild,
    );
  }
}

// Usage with Unwrapper
Unwrapper(
  unwrap: true,
  resolver: (widget) {
    if (widget is MyWrapper) {
      return widget.customChild;
    }
    return null;
  },
  child: MyWrapper(
    customChild: Text('Unwrapped from custom widget'),
  ),
);

This unwraps the MyWrapper and renders only the Text widget.

Example Project

For a complete example, check out the example folder in the repository.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Contributing

We welcome contributions! Feel free to submit issues or pull requests to improve this package.

Happy coding with Unwrapper!

unwrapper 0.0.1⧉