PlyLoom lays a complex topic out on sheets. Each sheet answers one question, and the same entity can stand on several sheets at once — you edit it once. Below: how it works, three ways to start and everyday actions; everything else is in the user guide.
Runs in the browser, no installation or account. The map never leaves your computer.
PlyLoom in a minute
Picture a folder of sheets. Each sheet holds a small diagram about one side of a topic: requirements, architecture, tests, sources. When the same thing is needed on two sheets you do not draw a copy — you put the same entity on the second sheet. Change its text in one place and it changes everywhere.
Project
The whole map: sheets, nodes, relations and dictionaries. Kept in one .plyloom file.
Sheet
One side of the topic, one question. A name, colour, type and tags. There is no node limit.
Node (entity)
A requirement, component, idea, person or risk — any unit of meaning: one name, a text, attributes and, if you like, a picture.
Appearance
Where a node stands on a particular sheet. Each appearance has its own position; the text is shared.
Relation
An arrow between nodes with a type (“depends on”, “supports”…) and a label, including between sheets.
Three kinds of lines
Solid — a relation on one sheet. Dashed — a relation to a node on another sheet. Gold — the same entity on different sheets.
The screen
The window: menus and views at the top, the sheet bar, nodes on the left, the sheet in the middle, properties on the right.
Menus — Project (files, version history, documents, comparing, import, export, examples), AI, Dictionaries, Settings, Filter, Story, Help; the Reading button shows the map without editing.
Undo · Redo — the ↶ ↷ buttons, or Ctrl+Z and Ctrl+Shift+Z (Ctrl+Y), ⌘ on a Mac. Next to them: the map's name, the language and ⌃ to fold the top (Ctrl+.).
Views — Sheet, All sheets, Spreads, Stack, Contents, Architecture, All-to-1; the view's settings are on the right of this row.
Sheet bar — ← n/N → and the sheet tabs, + for a new sheet, the map's counts and the saving state.
Nodes — the palette of types: drag a type onto the sheet, or click it. The ‹ arrow folds the panel into a narrow strip.
Canvas — the sheet in the middle; around it the passe-partout with the neighbouring sheets, Passe-partout ▾ in the corner, and at the bottom right the zoom, Fit, Optimize, Unfold all, Snapshot and “?”. These buttons are the same in every view, and after a jump to a node a ↩ Back button appears next to them.
Properties — the sheet on top, the selected node below, the project check last. The › arrow folds the panel.
Three ways to start
Choose by what you already have. They mix well: get a draft from an AI, then build on it by hand.
A
From scratch: sheet by sheet
When you can already see the sides of the topic: Requirements, Architecture, Tests.
Project → New empty project: a title and the first sheet.
+ in the sheet bar adds a sheet for each side of the topic. A sheet is a question, not a folder of 15 nodes.
Fill the sheet: drag types from the Nodes panel or double-click empty space; to name a node, just type.
Connect nodes: drag from a dot on the edge of a card to another node.
Needed on another sheet too? In node properties choose + another sheet…. It is the same node, not a copy.
Look at the whole: Spreads and All sheets.
B
From scratch: entity by entity
When the structure is not clear yet and you untangle the topic as you go, from one idea to its neighbours.
One sheet, say Draft, and one node.
Drag from a node's dot and release on empty space: a new connected node appears. Type its name right away.
Repeat. Change a relation's type in node properties: Related nodes → ✎.
Is the sheet answering two questions now? Sheet properties → Lay the sheet out by a key, or move nodes to a new sheet with + another sheet….
Links between sheets are not lost: they show on the passe-partout around the sheet.
C
With AI: from your materials
When you have texts, notes or documents and need a draft map quickly.
AI → A new map… → the task → where the facts come from → Copy the prompt.
Paste it into any AI chat and add your question and materials at the end.
Copy the whole answer, paste it into the same window and press Show the map: text around the JSON does no harm.
PlyLoom checks the structure and shows a preview; Open and replace — the map is ready.
Review the facts and sheet boundaries; Help → Check project points out isolated nodes and empty sheets.
PlyLoom does not connect to an AI and sends nothing over the network: you decide which service to trust with your materials.
Step C1: the AI window — the prompt is copied with one button, the answer is pasted back into it.Step C4: a preview and a check before the file opens.
Nodes and relations: everyday actions
Add and name a node
Drag a type from the Nodes panel onto the sheet, click a type, double-click empty space or press + Node…. A new node is named after its type. To rename it, select it and type — as in draw.io: what you type replaces the old name, Enter keeps it, Esc brings the old one back. Enter or F2 edits the name without erasing it.
A type is dragged from the palette straight onto the sheet.
Connect two nodes
Hover a card and four dots appear on its edges. Drag any of them to another node, including one in the other half of a spread or a card on the passe-partout. A dot is only a grip: the line picks its side by itself and re-routes when nodes move. Release on empty space to create a connected node. A click on a line selects the relation: change its type, label and arrow, or press Del to delete it.
A relation is drawn from a dot; on empty space a new node appears.
Read a node
↘ in the card's lower right corner unfolds it in place: the picture, the text and the attributes, each section folding on its own, and neighbours move aside on screen. Unfold several cards and read them side by side; Unfold all ▾ unfolds every card on screen. ↖ folds it back; nothing changes in the file. A click on the name of an unfolded card edits the name right away.
Unfolded cards: sections fold one by one, neighbours moved aside.
Edit the text and attributes
Click the text of an unfolded card and it is edited in place, the field growing with the text; a click on the attributes opens their fields. The text understands **bold**, - lists and | … | tables. Edits are shared by every sheet the node is on.
The text is edited right in the unfolded card.
Nodes from other sheets
Around the sheet is the passe-partout: the nodes of other sheets linked to this one, a group per neighbouring sheet. By default it is folded — thin strips at the edges, a segment per sheet; a click on a segment shows its cards. Unfolded, it is cards around the sheet: groups, plates and “N more sheets”, and a group's header drags it to another side. Passe-partout ▾ in the sheet's corner chooses its state (unfolded or folded) and which sheets to show. A click on a card goes to the node on its sheet. More about the passe-partout
The unfolded passe-partout: a group slides along its side and moves to another, the sheet pans inside.
A picture in a node
Drop a file on the card or paste a picture with Ctrl+V while the node is selected; or use Properties → Picture. The picture is made small at once, the original is not kept, and only its caption ever goes to an AI.
One entity on several sheets
Node properties → + another sheet…, or drag the card into the other half of a spread. Text and attributes are shared, each sheet keeps its own position; “+N” on the card leads to its other sheets.
Undo and redo
The Undo and Redo buttons, or Ctrl+Z, Ctrl+Shift+Z, Ctrl+Y (⌘ on a Mac). Inside text fields the keys undo typing, as usual.
Find and filter
Filter selects nodes by type, tag and attribute; the search line looks through names, text and values. Enter goes to the next match.
Views
Sheet
One sheet with its passe-partout. Pick the sheet from its tab in the sheet bar; Alt+← and Alt+→ page through.
All sheets
Every sheet of the project on one canvas. Drag a sheet by its header, fold it with the ⌃ chevron, double-click to open it. Selected only: with a node selected, its links; with a sheet selected, every link of its nodes to other sheets.
All sheets: one sheet folded, only the selected node's links shown.
Spreads
2–6 sheets side by side, in a grid or one under another. Lines between the halves show relations and shared entities; drag a card into the other half and the node stands on that sheet too.
A spread, Selected only: the selected node's links; the gold line is the same entity on the other sheet.
Stack
Sheets as plates one above another, up to five per stack: you see an entity pass through the sheets. As a picture ↓ for a slide or an article.
The stack: cards lie on the plates, the sheet's name is on the front edge.
Contents
A diagram of the sheets with the number of links between them, or a list of sheets with their nodes.
Architecture
Sheets as blocks in the manner of C4, with nodes of chosen types inside.
All-to-1
Every entity once, in its own arrangement: the whole picture.
Story and reading
A story leads the reader step by step — views of the map with a title and a few lines. Reading shows the map without editing: a click unfolds a card, a relation leads to the other end. Watch the story “PlyLoom about itself”
Saving and sharing
Autosave
The map saves itself in this browser after every edit, and before large changes PlyLoom puts the previous version aside: Project → Version history…. But all of it is in one browser: clear the site data or switch browsers and the map is not there.
Backup and transfer
Project → Download .plyloom. Keep the file like any document; open it with Project → Open .plyloom…. In Chrome and Edge you can Save to a file… — then every edit is also written straight to a file on your disk.
Import and export
draw.io, Obsidian Canvas and BPMN add sheets after a preview; CSV is read too. Export to .drawio, Canvas and a JSON tree. To keep everything, keep the .plyloom.
Next: the user guide
The user guide covers every feature in order: from how a map is built and the passe-partout to views, dictionaries, the filter, file formats, keys and the technical description, with ready-made recipes. The same guide is in the app: Help → User guide, and Help → The guide as a map opens it as a map.
It unfolds the card itself: the card grows wider and shows its picture, text and attributes — each section folds on its own. Neighbours move aside on screen; their positions in the file do not change. ↖ folds the card.
Do I have to enlarge the sheet as it grows?
No. The sheet has no size limit: pan and zoom it inside the window, while the passe-partout with the neighbouring sheets stays at the edges. Fit picks the zoom.
How do I walk someone through the map?
Record a story: open the view you want and press Story → Add a step, then write titles and a few lines in Steps…. Story → Watch shows the steps one after another. The Reading button takes away everything that changes the map.
Where does my data go?
Nowhere: the app runs without a server or network. Download the .plyloom to transfer or back it up.
Try it on a ready-made example
Examples open in a separate working copy and leave your own map alone.