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: 1kind: boardid: 6c887de3-5b1e-4c8a-9d2f-0a7e3f41b9d6title: Websiteicon: {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.| Key | Type | Description |
|---|---|---|
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. |
Identity
Section titled “Identity”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
Section titled “Config”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.
Background
Section titled “Background”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.