Viewport Addon
The Viewport Addon is an invaluable tool that lets you preview your stories on various viewports. These viewports simulate a realistic environment by:
- Setting width and height boundaries to your story.
- Overriding
MediaQuery'sdevicePixelRatioto ensure your component behaves as as expected on different devices. - Overriding
ThemeData.platformto simulate different platforms.
Usage
widgetbook/lib/widgetbook.config.dart
final config = Config(
// ...
addons: [
ViewportAddon([
Viewports.none,
IosViewports.iPhone13,
AndroidViewports.samsungGalaxyNote20,
MacosViewports.macbookPro,
WindowsViewports.desktop,
LinuxViewports.desktop,
]),
],
);
You can use .all getter to add all available viewports to the addon:
ViewportAddon(Viewports.all) // All platforms
ViewportAddon(IosViewports.all) // Specific platform
Order
Since the order of addons matters. The ViewportAddon should be used before all other addons.
Mode
To use this addon for testing, you can enable the ViewportMode in your stories:
final $Default = _Story(
scenarios: [
_Scenario(
name: 'iPhone 13',
modes: [
ViewportMode(IosViewports.iPhone13),
]
),
],
)
IosViewports.iPhone13,
IosViewports.iPhone12,
]),
],
);
}
}

