Skip to content

Make it look right

A map is looked at before it’s read. If every card is the same size and colour, people have to read every name to find what matters. Make the important parts big, the supporting ones small, and give colour one meaning, and they’ll see the shape of your system before they read a word.

How a part looks never changes what it is or how traffic moves through it. Look and behaviour are separate, so style freely.

On the Checkout system template, make the order path stand out:

  1. Select Orders API, open its Look tab, and pick Large under size. It’s the part the map is about, so it should look it.

  2. Select Payments and pick the Slim card. Stripe runs it, so it needs less room.

  3. Select the lines from Web shop to Orders API and from Orders API to Orders DB, holding ⌘. In Style, set the colour to blue and the weight to bold.

The checkout map styled: a large Orders API, a slim Payments card, and the order path from the web shop through the Orders API to the Orders DB in bold blue.The checkout map styled: a large Orders API, a slim Payments card, and the order path from the web shop through the Orders API to the Orders DB in bold blue.

The library’s Presets shelf holds 117 parts ready to go, such as Cloudflare DNS, a web firewall, a token bucket limiter, a Redis cache, a Kafka topic, Claude or Stripe payments.

The parts library on its Presets shelf, grouped into people and apps, the way in and more, each preset with a logo or icon.The parts library on its Presets shelf, grouped into people and apps, the way in and more, each preset with a logo or icon.

A preset fills in a part’s kind, name, drawing, card, technology and whether someone else runs it, with sensible starting limits: a rate limiter’s limit, a queue’s buffer, a service’s capacity and how it auto-scales. Everything it fills in is only where the part starts. Change any of it afterwards, as with any part.

A search in the library looks through the plain parts and the presets at once. Presets lists them all.

When Flozu knows a part’s technology, its mark is that technology’s logo, in one colour. Otherwise it’s the kind’s icon. Logos come from Simple Icons; the brands belong to their owners. Some brands, such as AWS and OpenAI, don’t allow their logo there, so those parts keep the kind’s icon.

A bigger share of your system can look bigger. Select a part and drag one of its corners. It snaps to the grid, from 160 by 48 up to 640 by 512. Its left and right edges are its ports, so only the corners resize it.

Or pick a size in the Look tab: small, standard, large or extra large, each in the shape of the part’s card. A standard card is 192 by 160, large is 288 by 240 and extra large 384 by 320.

The drawing grows to fill the card and keeps its shape. The name and figure grow a little with it, so a part twice the size reads as bigger without shouting.

Each part picks its card in the Look tab. A map can mix them freely.

CardWhat it shows
StandardThe name on top, then the drawing and one figure.
ShowcaseThe drawing fills the top of the card, with the name and figure below it.
WideA wide card: the name and figure on the left, the drawing on the right.
SlimOne slim line with the icon, the name and the figure, and no drawing.

Each layout has a shape of its own, so picking one also gives the part that layout’s size: a standard card is 192 by 160, showcase 192 by 176, wide 320 by 144 and slim 192 by 64. A large part stays large, and its ports stay at the same height so its lines don’t bend.

You don’t have to pick a layout to change how a card reads. Resizing is enough:

  • A card shorter than 112 shows as a slim line, since there’s no room for a drawing.
  • A standard or showcase card at least twice as wide as it is tall shows as a wide one.

Each part’s panel shows a small live drawing of what it does. Every kind has its own, but any part can show any of the 237 drawings in the library: a service can show a card payment, a queue its dead letters, a worker a video being encoded.

The Look tab for Orders API: its size, four card layouts with Standard picked, the Activity drawing it shows, and a button to browse all drawings.The Look tab for Orders API: its size, four card layouts with Standard picked, the Activity drawing it shows, and a button to browse all drawings.

Under Drawing in the Look tab, the part’s drawing shows as one tile. Browse all opens the gallery beside the inspector. It opens on the drawings suggested for the part; search it, or pick a category from the filter beside the search. Picking a drawing applies it straight away, and the gallery stays open so you can try another.

The drawings gallery open beside the inspector: a search with a filter beside it set to Suggested, and a grid of animated drawings.The drawings gallery open beside the inspector: a search with a filter beside it set to Suggested, and a grid of animated drawings.

Changing a part’s kind keeps a drawing you picked; a part showing its kind’s own drawing switches to the new kind’s. Drawings lists every drawing with what it shows.

Give any part, line, zone or note colours of its own, so a map can mark out its areas: the EU region in blue, a team’s systems in violet, the risky path in red.

The checkout map with its AWS region filled in blue and its background jobs zone in violet.The checkout map with its AWS region filled in blue and its background jobs zone in violet.

Select it and open its Look tab. The Style section has:

Setting What it sets
Border (or Line) The colour of its edge, or of the line. Its button shows the colour; press it for the palette and a picker.
Pattern Solid, dashed or dotted. A line can have no line at all, so only what moves along it shows.
Weight Thin, regular or bold.
Strength How strong the colour is.
Fill and its strength The colour it’s filled with. Lines have no fill.
Effect and Route Lines only: what moves along it and how it runs. See lines.

A strength slider previews on the canvas as you drag it, and saves once when you let go. Reset goes back to the usual look. Select several things, and a change applies to all of them at once, as one step to undo.

Colours are names from one palette (grey, red, orange, amber, yellow, lime, green, teal, blue, indigo, violet and pink), not exact values. Each theme draws them in its own shade, so a map reads well in both dark and light.

Press a colour’s button: the palette sits at the top, and a picker under it takes any colour. Drag in the square for how strong and how bright, slide the rainbow for the hue, or type a hex code such as #3a7bd5 and press Enter. The canvas shows the colour as you drag, and it saves once when you let go. A colour of your own is drawn the same in both themes.

The colours open from a line's colour button: the palette in two rows, then a blue square with a ring in it, a rainbow slider and the hex code #3972BF.The colours open from a line's colour button: the palette in two rows, then a blue square with a ring in it, a rainbow slider and the hex code #3972BF.
  • Give colour one meaning per map, such as the main path, or one team’s parts. A map where everything is coloured reads as if nothing is.
  • A fill is always a tint, so words on it stay easy to read.
  • Anything you leave alone keeps the item’s usual look, such as dashed for a message or dotted for a team.
  • Selection and scenario outlines still show over a style.
  • A coloured zone’s or line’s colour also shows in the map’s small drawing, at home and on the Maps page.