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
Each addon has a corresponding Mode to lock its value in scenarios. For this addon, use ViewportMode:
final $Default = _Story(
scenarios: [
_Scenario(
name: 'iPhone 13',
modes: [
ViewportMode(IosViewports.iPhone13),
]
),
],
)
IosViewports.iPhone13,
IosViewports.iPhone12,
]),
],
);
}
}

