Skip to content

Ubiquitous language

Trove uses a precise vocabulary. The same word always means the same thing — in the app, in the docs, and in support conversations.

A manuscript container. Holds one Manuscript, optional Notes, optional Entities, and a manifest pointing at zero or one World. Status values: drafting, outlining, complete, on-hold. On disk at ~/documents/trove/projects/<slug>/.

A reusable library of Entities (characters, locations, factions, …) that one or more Projects can link to. On disk at ~/documents/trove/worlds/<slug>/.

The writable Document tree inside a Project. Always a structural noun — never used for a single piece of writing.

A single Markdown leaf inside a Manuscript. Has a workflow status (todo | draft | active | done), optional POV, story-time, location, and zero or more Drafts.

A group of Documents and sub-Folders inside a Manuscript.

A versioned snapshot of a Document. Read-only after creation.

A structured record (character, location, faction, item, …) scoped to either a Project or a World. TOML/Markdown frontmatter plus a free-form Markdown body.

Category metadata for Entities — icon, colour, scope (project or world), optional default Template.

A reusable starter for a Document or an Entity — a field set with default values.

A visual card-based layout view of a Manuscript. Cards may be grouped into Acts.

A small typed, coloured note attached to the editor for a single Document.

The user-wide notes feature: a graph of free-form Markdown files (Tome Notes) with backlinks, wikilinks, and folder organisation. Tome lives at the user level — it is not scoped to one Project.

A single free-form Markdown file in the Tome. Backlinks and outlinks between Tome Notes are first-class.

A composite view of a Manuscript Folder’s descendant Documents as a single continuous scroll. Each Document keeps its own file on disk and saves independently.

A timed writing session with a word goal.

The broader writing-time tracker that aggregates words across a Sprint or free writing.

Soft-delete container. Items remain on disk under .trash/ until explicitly purged.

Export of a Manuscript to a final format (DOCX, EPUB, ZIP, plain Markdown bundle). Verb form: compile.

Trove is sold as a lifetime License. A License is trial (14 days from first launch), licensed (a paid activation is present and validated), or expired (no valid activation and the trial window has elapsed). An Activation binds one machine to a License Key. Files always remain visible regardless of state — expiry only switches the editor to read-only.