Skip to content
Starlings

Docs

Every document written in the workspace or from Starlings, in one place.

Docs is the company's shared knowledge base, or company second brain: standards, playbooks, research and working documents that people and authorized agents can refer to. Link a document to the project or other subject it informs so knowledge stays connected to work. The phrase describes its role; the area and its controls are still named Docs.

Where

ClientReach it
Mac⌘5
iPhone and iPadThe Docs tab
Web/docs

On Mac, opening a document adds its title to the Docs tab, such as Docs — Proposal.

On iPhone and iPad, use Save link in the Docs tab, or from a subject's Documents view to file the link on that subject. The Links row lists saved links. A saved link keeps the URL, the page metadata and the article as text, under your notes. A paywalled page keeps only what it shows without a subscription, and says so. To save a page from your browser, with the article as you see it, see [Save a page from your browser](../howto/save-a-page-from-your-browser.md). A saved link is yours alone until you file it on a subject or share it; the web marks it Only you. A link saved from a subject's Documents view is filed from the start.

On the web, Links shows each saved link's type (article, video, talk, book, law or other), the site, the day you saved it and its tags. A page that could not be read says Page not read, and a paywalled one says Paywalled. When your notes link to a notes document, the row names it. The arrow opens the page in a new tab. Search the list, or filter it by type or tag. A tag named after a type, such as book, sets the type. A notes document lists the links that point at it under Saved links.

Docs comes with your sign-in. There is nothing to connect. If Docs cannot connect, the surface shows why and a Connect Docs button to try again.

Shape

When signed out on web, the page shows a centered card with the Docs heading and one sign-in action.

The rail has Graph, Recent, Unfiled, one row per category, By project, By lead, Folders (the top-level folders) and Library (the mirrored writing). Each block folds, and the fold is remembered on that device; the order and the blocks that hide while empty are the same on Mac, iPhone, iPad and web. The list sits in the middle and the editor in the inspector. Documents on a subject in Work shows the same documents for that one subject.

Graph shows up to the 5,000 most recent accessible documents as nodes, with a line for each resolved wikilink. Folder colors and grouping are shared across Mac, iPhone, iPad and web; links pull related documents together within their folder groups. Toggle a folder to focus on the remaining groups. Select a node to open its document. The layout is live: it unfolds as the graph loads, links pull documents into place as document details arrive, and it comes to rest on its own. Drag a node to pull its linked documents along; point at one to light up its links and fade the rest. Titles appear as you zoom in, sooner for well-linked documents. The view follows Fit until you pan or zoom, and Fit hands it back. Zoom ranges from 25% to 400% of Fit on every surface.

Categories belong to the workspace. A new workspace has none. On the web, Edit categories at the top of the rail adds, renames, reorders and deletes them; deleting one leaves its documents uncategorized.

When Docs falls behind, the web page says Not syncing and names the parts that stopped.

Unfiled lists documents with no category and no project or lead that still sit in the default folder. The row shows only while there is something to file.

On the Mac, ⌘-click adds a row to the selection and ⇧-click selects a range. Drag documents onto a rail row to file them there: a folder moves them, a project or lead links them, a category sets it.

Floating (Mac)

A document can open in its own small window. You can keep it in view and edit it while you work in other apps. A pinned window stays on top of every app and on every Space. An unpinned window is an ordinary window. When Starlings starts again, it reopens a floating document where it was. To put it away, close its window.

You edit a document in one place at a time. While it floats, the inspector on it offers Bring to Front instead of a second editor.

On the web, paste or drop a PNG, JPEG, WebP or GIF image of up to 10 MB into the text while you edit, and it uploads into the document. A document with two or more top-level headings shows an outline under its title; select a heading to jump to it. While you edit, the bar shows a word count.

Editing (Mac)

While you edit on the Mac, ⌘B and ⌘I wrap the selection in bold or italic, and ⌘K makes it a link (a URL on the clipboard fills the address). Pasting a URL over selected text also makes a link. ⌘S saves without waiting, and ⌘F opens the find bar for the document. Return continues a list item or a quote; Return on an empty one ends it. Tab and ⇧Tab indent and outdent list items.

The outline button lists the document's headings, and a click scrolls to one; on a narrow bar it sits in ⋯. While you edit, the bar counts words.

Paste or drop an image into the text and it uploads into the document, written as ![caption](docs-image:<id>) where the cursor is. A wikilink, [[Title]] or [[Title|label]], opens that document in Docs when Docs knows it and reads muted when it does not. Typing [[surfaces/work|[ suggests titles.

Saving (Mac)

Edits save on their own a moment after you stop typing, and the bar says Saving… until they land. Every edit also goes to a draft on the Mac at once. Quitting saves every open document first; a save that does not land keeps its draft. The next time the document opens, the draft comes back with its title and category and the bar says Restored unsaved changes. If someone saved the document since, the two versions show side by side and you pick one. A document open in the Docs window and in Work at once is one editor, so the two never collide. Renaming or archiving a document from a list reaches its open editor and its window.

Controls

ControlDoesShortcut
New document…A document in the open folder⇧⌘N
Save linkSaves an HTTPS URL with its page metadata and the article as text, under your notes—
Edit / DoneA document opens to read. Edit shows its markdown; Done goes back to the formatted text. On the web and the Mac the markdown is styled as you type, in one pane at the reader's width, and Done returns to the place you were reading. An empty document opens to write⌘E; Esc leaves editing on Mac, iPhone and iPad
MoreThe ⋯ button. On Mac, iPhone and iPad: the document’s path, Send for Signature and Open in Browser—
FileIn a row's menu: Folder, Category, Project, Lead. A tick means the document is already filed there. Pick a ticked project or lead to take it off. On the Mac it applies to every selected row—
Star / UnstarKeeps a document or folder in Home's QUICK ACCESS listdocument row menu or editor; folder row menu. A top-left star badge marks starred rows
CategorySets the row's category—
Add a project, lead or partnerLinks the document to a subject. The folder is where the document is stored. The subject is what it is about—
Show Right Sidebar / Hide Right SidebarPassage comments for the open document. On the web, one header control toggles a column on a wide window or a side sheet on a narrower one; it defaults to closed and remembers an open panel per surfaceheader on web
Copy linkThe document's address—
ShareOn the web, in the document bar: share links, signature requests and who opened the document. On Envisioning it also has Share on envisioning.com. A transcript cannot be shared—
Create linkA share link for anyone with the link, or for one email, as Can comment or Read only—
RevokeTurns a share link off. It stays in the list as Revoked—
Send for signatureMails each signer their own link. With Sign in order, each signer gets theirs after the one before signs—
Cancel requestStops a signature request that is still waiting—
CertificateOn a signature request: its audit certificate, in the Docs app—
Move to…In a row's menu or the document's menu on the web: pick a folder from the list; type to filter it—
Rename…In a row's menu: a new title for the document—
ArchiveIn a row's menu or the document's menu: the document leaves every list; Docs keeps it—
Bold / Italic / LinkWhile editing on the web: wraps the selection. Pasting a URL over words makes them a link. Typing [[ offers document titles, and in the reader such a link opens that document⌘B / ⌘I / ⌘K, [[
Keep mine / Take theirsResolving a save that collided with another editor's. Take theirs asks first, because it replaces your text—
Hide the rail and the listThe editor alone—
GraphOpens the Docs graph: documents as nodes, wikilinks as connections, folder groups as colors—
Zoom in / Zoom out / FitChanges the graph scale or frames the visible nodesscroll or pinch to zoom at the pointer on web; pinch to zoom on Mac, iPhone and iPad; drag the background to pan and a node to move it on every surface
Open in Floating WindowIn a row's menu: the document in a window of its own (Mac)—
Float DocumentThe document open in the inspector, in a window of its own (Mac)⇧⌘F
Keep on Top / Unpin from TopThe floating window's pin: above every app, or an ordinary window—
Bring to FrontIn the inspector, for a document that already floats—

Mirrored bodies (newsletters, reports, research) are read-only, with Open source to where they live.

Row menus (web)

Every Docs row has a menu. Open it with the … on the row, a right-click, or ⇧F10. The … shows when the pointer is over the row or the row has focus; on a touch screen it is always there. A top-left star badge marks a starred document or folder; Star / Unstar stays in the row menu.

RowMenu
A document, in the list or a subject's Documents paneOpen, Open page (a saved link), Copy link / Rename…, Move to… / Archive / Star
The open document's menuThe same, without Open and Star
A rail view, project or leadOpen, Copy link
A folderOpen, Copy link / Star

A mirrored document has no Rename…, Move to… or Archive. A saved link copies the page it points at. The web has no menu for more than one selected row yet.

Leads to

The subject a document is about, in [work]].

Where it works

CapabilitymacOS HostmacOS JoinWebiOS / iPadOSAgent access
Docs: the corpus, read and written from StarlingsWorksWorksWorksWorksdocs_write (MCP), starlings://document/{id}
Docs graph viewWorksWorksWorksWorksHuman only: A picture of the corpus for people. An agent reads the documents.

Verified · docs/help/surfaces/docs.md