Skip to content

Lane

A lane is a column on the board. It is a folder named with a lowercase UUID directly inside the board folder, and its settings live in the index.md inside it. The cards of the lane are the folders next to that file.

---
schema: 1
kind: lane
title: In Progress
order: 2048
icon: {glyph: hammer}
width: 2
presentation: list
locked: [comments]
group: {by: modified, direction: descending}
filter:
- {by: label, op: equal, value: bug}
card-defaults:
labels: [bug]
background: {color: coral}
created: {at: 2026-07-24T18:00:00Z, by: {name: claude, kind: agent, model: opus-5}}
modified: {at: 2026-07-24T18:00:00Z, by: {name: claude, kind: agent, model: opus-5}}
---
Work somebody has started. Move a card back when it is blocked.
KeyTypeDescription
schema integer Always 1. Optional in a lane; a missing value is read as 1.
title text, one line The lane's display name. A lane without a title shows as untitled.
kind text Write lane. The app adds it when the lane is created.
created stamp A stamp recording when the lane was created and by whom.
modified stamp A stamp recording the last time the app rewrote this file's content and who did it.
icon icon The lane's SF Symbol and its tint, as {glyph, color}.
order number A number ranking the lane among the board's lanes, lowest first, left to right. Decimals are fine. A lane without a usable order goes last.
width integer A whole number, 1 or more, that multiplies the standard lane width. The default is 1; a smaller value is read as 1. There is no upper limit.
collapsed boolean true folds the lane into a slim strip. To expand it, remove the key rather than writing false.
presentation text How the lane draws its cards: list for one-line rows, or card (the default) for full card faces. To go back to cards, remove the key. An unknown value is drawn as cards.
group group How the lane's cards are split into sections on screen, written as {by, direction}. It only changes how the lane looks and never edits a card's file.
filter list of filter clauses A list of clauses that narrow which of the lane's cards are shown. A card must match every clause. Hidden cards are not changed.
card-defaults mapping What a new card created in this lane starts with. Applied once, when the card is created, and never when a card is moved in.
background background The lane's background colour, written as {color: …}. It is drawn as a band along the top of the lane.
locked list of lock names A list of what the app's own editing may not change in this lane: content (title, body, attachments and relations) and comments (the comment thread), for example [content, comments]. Absent or empty means unlocked. It binds the app only, not someone editing the files.

The body of the file is free Markdown. Use it for notes about what the lane is for.

Lanes run from left to right by ascending order. The value is a number and decimals are fine, so you can slip a lane between two others by using a number between theirs. Lanes with equal order are placed by folder name. A lane with no order, or one that is not a number, goes after every lane that has one.

collapsed: true folds the lane into a slim strip. Its cards are still there, just not drawn. To expand the lane, remove the key instead of writing collapsed: false. The lane’s width is kept while it is folded.

width is a whole number that multiplies the standard lane width. 2 is twice as wide. It defaults to 1, anything below 1 is read as 1, and there is no upper limit.

presentation: list draws each card as a single full-width row, with the icon, title, chips, paperclip and comment count and no body preview. The default, card, draws full card faces. To go back to cards, remove the key. A value Lanework does not know is drawn as cards and left as written.

A list lane still uses group, and its width sets how wide the rows are.

locked is a list of names saying what the app’s own editing may not change in this lane. Two names are read:

  • content stops edits to a card’s title, body, attachments and relations.
  • comments stops edits to a card’s comment thread.
locked: [content, comments]

Absent or empty means the lane is unlocked. The lock binds the app only. Nothing stops someone from editing the lane’s files by hand, and agents follow the board’s own instructions, so the body of the board’s index.md is the place to say what a lock asks of them. A name Lanework does not know is ignored and left as written. move is reserved for a later version.

group splits the lane’s cards into sections on screen, written as {by, direction}. It only changes how the lane looks and never edits a card’s file. The values for by and direction, and how each one orders the sections, are on the Grouping and filtering page.

filter is a list of clauses, and a card shows only if it matches every one. Hidden cards are not changed. A clause Lanework cannot read is skipped. The clause forms are on the Grouping and filtering page.

card-defaults says what a new card created in this lane starts with. It currently has one subkey, labels, a list of bare names (free labels) or full label entries. The defaults are applied once, when the card is created. Moving, pasting or duplicating a card does not apply them, and changing the defaults later does not touch cards that already exist.

When you create a card by editing files, copy the lane’s default labels into the new card’s labels yourself. See Labels in depth for the rules.

KeyTypeDescription
labels list of labels or names The labels a new card in this lane starts with. Each item is a bare name (a free label) or a full label entry of one of the board's own kinds. They are added to any labels the card already has.

created and modified are stamps, icon is a glyph and a tint, and background is a colour. All of them are explained on the Shared values page: see icon and background. A lane’s background is drawn as a band along its top.