Building pages

Widget reference

Every widget you can write. Names follow Flutter's; the editor completes props for each one as you type, and the properties panel shows the same props with descriptions.

Wrapping a widget in a parent

To put a widget inside another, such as adding padding around a heading, hover its layer in the Layers panel and click the wrap icon. Choose a parent from the list: it takes the widget's place, with the widget inside it, and opens ready to set up. This works on text, buttons, images, and the rows and columns inside sections.

A parent that can't go there is greyed out, and hovering it says why. These are the same limits as Flutter's: Positioned only works inside a Stack, and Expanded inside a Row, Column or Flex. A widget with one of those limits can't be moved away from the parent it needs.

A few layers can't have a new parent, because the builder finds them by their exact place: the page's root and body column, the header and footer and their main parts, and a section's page-width box and card structure. Their wrap icon is greyed out, and hovering it says why. You can still wrap a whole section.

Removing a parent

To take a parent away and keep what's inside, click the unwrap icon on its layer. Its children move up into its place, in order. The icon is greyed out, with the reason, when they can't go there: several children can't move into a widget that holds only one, and an Expanded can't leave its Row for a Container. A section's own named parts can't be removed this way.

Boxes & spacing

Wrap one child to give it size, space, shape or alignment.

<Container>One child
A box that combines padding, margin, size, constraints, background, border and alignment. The workhorse.
<Padding>One child
Insets its child by the given padding.
<Center>One child
Centres its child within itself.
<Align>One child
Aligns its child within itself.
<SizedBox>One child
A box with a fixed size. An empty SizedBox is a fixed gap.
<ConstrainedBox>One child
Sets a minimum and maximum width and height for its child.
<AspectRatio>One child
Sizes its child to a width:height ratio. Frame images with it.
<FractionallySizedBox>One child
Sizes its child to a fraction of the space available.

Arranging

Place several children in relation to each other.

<Column>Many children
Lays out children vertically.
<Row>Many children
Lays out children horizontally.
<Flex>Many children
A Row or a Column chosen per breakpoint, e.g. stacked on phones and side by side from md.
<Wrap>Many children
Lays out children in lines, wrapping onto the next line when full.
<Stack>Many children
Overlaps its children: text over an image, a badge on a corner.
<GridView>Many children
A grid with a column count per breakpoint. Children can span columns.
<ListView>Many children
A scrollable list, with an optional separator between items.
<Carousel>Many children
Slides side by side, with arrows, dots and a counter.

Inside rows, columns & stacks

These only work in a particular parent. The editor says where if you misplace one.

<Expanded>One child
Makes its child fill the remaining space in a Row, Column or Flex.
<Flexible>One child
Lets its child flex in a Row, Column or Flex without forcing it to fill.
<Spacer>No children
Takes up flexible empty space in a Row, Column or Flex.
<Positioned>One child
Pins its child at offsets inside a Stack.

Effects

Change how one child looks or behaves.

<Opacity>One child
Makes its child partially transparent.
<ClipRRect>One child
Clips its child to a rounded rectangle.
<Transform>One child
Rotates, scales or moves its child.
<SingleChildScrollView>One child
Makes its child scrollable.
<Sticky>One child
Keeps its child pinned while the page scrolls.

Text & media

What visitors read and see.

<Text>No children
Styled text. Set semanticsTag to h1–h6, p or span.
<Image>No children
An image, with fit, hover zoom and alt text.
<Icon>No children
Any of more than 2,000 icons, chosen from a searchable grid. See Icons.
<Video>No children
A video player.
<Embed>No children
An embedded page: maps, YouTube and similar.
<Html>No children
Raw HTML, for snippets you can't build from widgets.

Buttons & links

Take an action. Buttons use onPressed; Link uses href.

<FilledButton>No children
A solid button in the primary colour. The main call to action.
<ElevatedButton>No children
A raised button with a shadow.
<OutlinedButton>No children
A button with an outline. Good for secondary actions.
<TextButton>No children
A flat, text-only button.
<IconButton>No children
A tappable icon.
<Link>One child
Makes its child a real link: cards, images, whole rows.

Surfaces & labels

Small building blocks for cards and lists.

<Card>One child
A rounded, raised surface.
<ListTile>No children
A row with a title, subtitle and leading/trailing parts.
<Chip>No children
A compact label, optionally with an icon: Sale, New, a filter.
<Badge>One child
A small label or dot on the corner of its child, like a notification count.
<CircleAvatar>No children
A circle showing an image or initials.
<Divider>No children
A thin horizontal line with space around it.
<VerticalDivider>No children
A thin vertical line, for use in a Row.

Feedback & forms

<EmailSignup>No children
A newsletter sign-up: an email field and a button.
<LinearProgressIndicator>No children
A horizontal progress bar.
<CircularProgressIndicator>No children
A circular spinner.
<Placeholder>No children
A box with a cross, for sketching a layout.

Logic

You don't write these tags. They're what .map() and conditions become, and how they appear in Layers.

<For>Many children
Repeats its children once per item of a list: {list.map((item) => …)}.
<If>Many children
Shows its children only when a condition is true: {cond && …}.