responsive_spacing 1.1.0 icon indicating copy to clipboard operation
responsive_spacing: ^1.1.0 copied to clipboard

Make your app responsive & adaptive with dynamic spacing, margins, paddings, gutters, body-size & columns.

This plugin helps to design and develop beautiful responsive and adaptive flutter apps.

Lightweight, Responsive Spacing #

All design principles have roughly the same elements. For example, Material Design works with margin, gutter, body and has a responsive 12 column system. Our default values are set by the Material Design Guidelines, but you can also easily set your own breakpoints, margins, and spacing.

You can find spacings everywhere in your Project, don't use Magic Numbers, use the context-oriented spacing class instead.

We have developed this plugin so that you can easily make your app adaptive and responsive.

Simple Spacing #

Access your own Spacing-System:

// Example values for a Pixel 7 Pro
context.spacing.xs; // default 2
context.spacing.s; // default 8
context.spacing.m; // default 12
context.spacing.l; // default 16
context.spacing.xl; // default 32
context.spacing.xxl; // default 56

// Example:

// Instead of 
SizedBox(height: 8);

// use
SizedBox(height: context.spacing.s); // Wow!

And whenever your design guru wants to modify the values, you only have to modify it in a single file.

Giga Spacing for all design chads that need more power #

Design Gurus are around the world and you will maybe find one in your own company. If you have such a mysterious creature, use the Giga Spacing class for even more fine tuning.

context.gigaSpacing.xxxs; // default 2
context.gigaSpacing.xxs; // default 8
context.gigaSpacing.xs; // default 10
context.gigaSpacing.s; // default 12
context.gigaSpacing.m; // default 16
context.gigaSpacing.l; // default 24
context.gigaSpacing.xl; // default 30
context.gigaSpacing.xxl; // default 40
context.gigaSpacing.xxxl; // default 46
context.gigaSpacing.xxxxl; // default 64

Set Your Custom Spacings #

In your main, set the global defaults:

void main() {
      globalSpacing: MySimpleSpacing(),

  runApp(const MyApp());

class MySimpleSpacing extends SpacingCollection {

  SimpleSpacing get any => const SimpleSpacing(
    xs: 2.0,
    s: 8.0,
    m: 12.0,
    l: 16.0,
    xl: 32.0,
    xxl: 56.0,

In the previous Example, we used the any override, this will ignore the layout width. If you want to make the spacings responsive, override the values for xl, lg, md, sm2, sm1 & xs

class MySimpleSpacing extends SpacingCollection {
  SimpleSpacing get xs => const SimpleSpacing(
        xs: 2.0,
        s: 8.0,
        m: 12.0,
        l: 16.0,
        xl: 32.0,
        xxl: 56.0,

  SimpleSpacing get sm1 => xs;

  SimpleSpacing get sm2 => xs;

  SimpleSpacing get md => const SimpleSpacing(
        xs: 2 * 2.0,
        s: 2 * 8.0,
        m: 2 * 12.0,
        l: 2 * 16.0,
        xl: 2 * 32.0,
        xxl: 2 * 56.0,

  SimpleSpacing get lg => md;

  SimpleSpacing get xl => const SimpleSpacing(
        xs: 4 * 2.0,
        s: 4 * 8.0,
        m: 4 * 12.0,
        l: 4 * 16.0,
        xl: 4 * 32.0,
        xxl: 4 * 56.0,

Usage #

Instead of using a Scaffold, use the ResponsiveScaffold:

  appBar: AppBar(
    title: const Text("The Title"),
  body: YourWidget()

And in your Widget, access the Spacing class with Spacing.of(context) or context.spacingConfig which returns an object of ResponsiveData. The object has all necessary spacings.


// You are now good to use these properties in your layout.

For example with a Card:

  // use margin
  margin: context.spacingConfig.margin.horizontalEdgeInsets,

  child: Padding(

    // use padding
    padding: context.spacingConfig.padding.allEdgeInsets,
    child: Column(
      children: [
        Text("This is a Title"),
        Text("This is the subtitle, usually you explain something")

Columns, Gutters & Margins #

The responsive layout grid is made up of three elements: columns, gutters, and margins. Read everything about Columns, Gutters & Margins on the material guidelines responsive layout page.

columns, gutter, margin

Example: Access global padding setting in your widget: #


// or


Receive padding for screen sizes:

  • lg = 24
  • md = 24
  • sm = 16
  • xs = 8
columns, gutter, margin

Default Sizes #

The Material Breakpoints are used for all default values.


As an example, the 360 size display has 4 columns, a margin of 16, padding of 8 & gutters of 8.


If you combine this now, you get a responsive layout. See it in action:

Responsive App

Custom Adaptive Breakpoints #

You can also customize your own breakpoints. The default values are Material Design screen sizes:

  • xl: 1920, disabled
  • lg: 1440, enabled
  • md: 1240, enabled
  • sm2: 905, enabled
  • sm1: 600, enabled
  • xs: from 0 to sm1, always enabled

To customize, use the setDefaults method in your main:

void main() {
    globalBreakpoints: Breakpoints(
      xl: const BreakpointEntry(2560, enabled: true),
      lg: const BreakpointEntry(1440),
      md: const BreakpointEntry(1240),
      sm2: const BreakpointEntry(905),
      sm1: const BreakpointEntry(600),

  runApp(const MyApp());

Custom Padding, Gutter, Body & Margin #

Just like the custom breakpoints, you can also set your own spacing, spaces, and margins. Create your own gutter class by extending ResponsiveCollection:

class MyResponsiveGutters extends ResponsiveCollection {
  ScaledSize xl(double width) => const ScaledSize(size: 16);

  ScaledSize lg(double width) => const ScaledSize(size: 16);

  ScaledSize md(double width) => const ScaledSize(size: 8);

  ScaledSize sm2(double width) => const ScaledSize(size: 4);

  ScaledSize sm1(double width) => const ScaledSize(size: 4);

  ScaledSize xs(double width) => const ScaledSize(size: 2);

  ScaledSize fallback(double width) => const ScaledSize(size: 2);

And overwrite the default global gutters in your main:

void main() {
  // optional setting defaults
    globalGutter: MyResponsiveGutters(),
    globalPadding: MyResponsivePadding()

  runApp(const MyApp());

Data Class #

Everything you need is stored in the ResponsiveData class which is accessible via the context.

class ResponsiveData {
  final ScaledSize margin;
  final ScaledSize padding;
  final ScaledSize gutter;
  final ScaledSize body;
  final LayoutColumns layoutColumns;
  // ...

Available Responsive Widgets #

There are two types of widgets, the data widgets that create the spacing context and widgets that use the spacing context.

Data Widgets #

Data widgets create the spacing context and provide responsive values to all widgets created in the tree below. if there are multiple data widgets in the tree, the closest one is taken.

  • ResponsiveScaffold

Widgets #

  • ResponsiveCard
  • ResponsiveGrid
pub points


verified publisher

Make your app responsive & adaptive with dynamic spacing, margins, paddings, gutters, body-size & columns.

Repository (GitHub)
View/report issues


API reference


Icon for licenses.MIT (LICENSE)




Packages that depend on responsive_spacing