Keys, phones and the technical description.
Keys and gestures
Everything works with a mouse or fingers; keys speed up frequent actions.
| Action | How |
|---|
| Undo · redo | Ctrl+Z · Ctrl+Shift+Z or Ctrl+Y (⌘ on a Mac) |
| Previous / next sheet | Alt+← · Alt+→ |
| Delete the selected node or relation | Del (⌫ on a Mac) |
| Copy the selected card | Ctrl+C (⌘+C on a Mac) |
| Paste: on another sheet the same card, on its own sheet a copy | Ctrl+V |
| Paste as a separate copy | Ctrl+Shift+V |
| Text from another program as a new note | Ctrl+V on a sheet |
| Select a relation | click its line |
| Clear the selection, close menus, cancel linking | Esc |
| Next search match | Enter in the search line |
| Select a card from the keyboard | Enter or Space |
| Pan · zoom | drag empty space or the wheel · Ctrl + wheel, pinch |
| Scroll horizontally | Shift + wheel |
| New node · relation | double-click empty space · drag a dot on a card's edge |
| Unfold · fold a card | ↘ · ↖ in the lower right corner |
| Rename a node with the mouse | a click on the name of a selected or unfolded card |
| Rename the selected card | start typing · Enter or F2 to edit |
| Fold or show the top | Ctrl+. |
| Story: a step on and back · end | → · ← · Esc |
| Overview: move a sheet or node · zoom | arrow keys (Shift: faster) · + − |
| Stack: the active plate | ↑ · ↓ |
| Paste a picture into the selected node | Ctrl+V |
Phones and tablets
On a narrow screen everything is the same; the panels slide in from buttons.
- The Nodes and Properties panels open from the ☰ and ⓘ buttons in the sheet bar; tap a type to add a node.
- Pan the sheet with one finger, zoom with two.
- In a spread the halves stand one under another: scroll down, or pick a sheet from the tabs.
- Fold the top with ⌃ and the sheet gets almost the whole screen.
See also: Spreads
Technical description
One HTML file without a server: what is inside, where it is stored and how the format works.
- Application
- One HTML file with the interface, code and illustrations inside. No server, installation or account; it also runs from disk (file://). The page's security policy forbids network requests (connect-src 'none') and external images, and allows one script only — its own, named by its SHA-256: no inline handler or other code on the page runs.
- Browsers
- Current Chrome, Edge, Firefox and Safari (Chrome/Edge 107+, Firefox 104+, Safari 16+). JavaScript is required.
- Storage
- The map and its version history live in this browser's IndexedDB. Every write is numbered: a tab writes only if storage still holds the version it continues from — the check and the write share one transaction — and tabs tell each other about every write (BroadcastChannel and the storage event). The version from before a large change is written in the same transaction as the change. If IndexedDB is unavailable, localStorage is used, without version history; if both are blocked, the work stays in memory and a red bar says so. Save to a file uses the File System Access API. Node pictures are kept apart, each once: the map and the versions in the history hold references only, and pictures nothing refers to are deleted in the background. Recent searches, folded panels and palette groups are kept in the browser too.
- Identity
- A node has one id. Memberships are the sheets array; the first sheet is the primary one. Positions (pos) and geometry (appearance) are per sheet; name, body, type and attributes are shared. Gold lines are not stored — they follow from memberships.
- Passe-partout
- Its two states — unfolded and folded to strips — are remembered by the browser, apart from the map (the earlier “hidden” reads as folded). Unfolded, it is tied to the window, not to the sheet; the sheet keeps at least 60 % of the width and height, and the passe-partout holds up to 16 sheets. Choices made by hand are stored in sheet.externals under the neighbouring sheet's key: side and along — the side and the place along it (a share of its length), state — open, folded or parked (in “More”). Neighbours moved by an unfolded card move on screen only.
- Limits
- No node or sheet limit. Import up to 128 MiB, confirmed above 20 MiB. Undo keeps 100 steps until the page reloads; the version history keeps the last 20 versions and one a day for a month, up to 100 MB (but at least three versions). A picture is a PNG, JPEG, WebP or GIF up to 25 MB and 40 Mp; it is kept small: 640 and 192 px on the long side, WebP.
- Privacy
- The map never leaves your computer. RU/ENG translates the interface and built-in examples; your text and IDs are never rewritten.
File format
.plyloom is JSON in UTF-8, version 3; a map with pictures is version 4 (PlyLoom 0.14 and later open it):
{
"version": 3,
"title": "…",
"types": { "nodes": [], "edges": [], "sheets": [], "tags": [], "attributes": [] },
"sheets": [{ "id", "name", "typeId", "tags", "color", "description",
"overviewPos", "overviewSize", "overviewCollapsed", "tocPos", "archPos",
"externals": { "<sheet id>": { "side", "along", "state" } } }],
"nodes": [{ "id", "name", "kind", "body", "attributes",
"sheets": ["s1", "s2"],
"pos": { "s1": { "x", "y" }, "s2": { "x", "y" } },
"appearance": { "s1": { "width", "height", "shape" } },
"image": { "id": "img_<16 hex>", "alt" } }],
"edges": [{ "id", "from", "to", "kind", "label", "directed", "routes" }],
"savedViews": [], "flatPositions": {},
"architecture": { "kinds", "nodes", "off", "hiddenSheets", "links" },
"story": { "title", "steps": [{ "id", "title", "text", "view", "camera", "selected", "expanded", "frame" }] },
"assets": { "img_<16 hex>": { "type": "image/webp", "w", "h", "micro": "<base64>", "mini": "<base64>" } }
}
Pictures: the id is the start of the SHA-256 of the picture itself, so one picture on several nodes is kept once. A file carries only the pictures nodes refer to; on reading, each is checked — type, size, base64, only the described keys.
Attributes: definitions live in types.attributes (text, number, boolean, date, url, select, multi), values in node.attributes by definition id; null means attached but empty.
See also: Saving and backups, Open, fold, pin a group