Skip to content

Board

The board file is the index.md at the root of a board folder, named <Name>.lanework/index.md. It holds the board’s title, its identity and its settings, and its body describes the board.

---
schema: 1
kind: board
id: 6c887de3-5b1e-4c8a-9d2f-0a7e3f41b9d6
title: Website
icon: {glyph: globe}
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}}
config: {show-card-body: 3, due-soon: 2}
---
Everything for the marketing site: copy, design and releases.
## Instructions for agents
File new ideas in the first lane. Keep card titles short.
KeyTypeDescription
schema integer Always 1. Required in the board's own index.md.
title text, one line The board's display name. If you leave it out, the folder name without .lanework is used.
kind text Write board. The app adds it when the board is created.
created stamp A stamp recording when the board was created and by whom.
modified stamp A stamp recording the last time the app rewrote this file's content and who did it. Reordering alone does not update it.
icon icon The board's SF Symbol and its tint, as {glyph, color}.
id UUID The board's identity, a lowercase UUID. The app adds one the first time it opens a board without one. Never change it: every lanework:// link to the board's cards uses it.
config mapping The board's settings. Edit one subkey at a time and leave the others as they are. See the Configuration page for each subkey.
background background Has no effect on a board. Only lanes and cards draw a background. If the key is already present the app leaves it as written.
template mapping Only meaningful when the board sits in a template store, where it holds picker details such as order. On an ordinary board it does nothing.
workspace mapping Not read by the app yet. Reserved for describing the board's role in a group of boards, for example role: pipeline.

id is a lowercase UUID. The app writes one the first time it opens a board that has none, and you should never change it afterwards. Every lanework:// link to the board’s lanes and cards starts with it. When you create a board by hand, write a fresh UUID. A duplicate of the board made by the app gets its own.

Unlike lanes and cards, the board file requires schema: 1.

The text above the first ## heading is the board’s description. Everything below that heading is free-form, and is where the owner puts instructions for agents working on the board. A body with no ## heading is entirely description.

config holds the board’s settings as a mapping. Each subkey is described on the Configuration page. Edit one subkey and leave the others as they are.

A background on the board file is not drawn. Only lanes and cards have one. If the key is already there, Lanework leaves it as written.

Stamps, icons and identities are explained on the Shared values page.