Skip to content

Manuscript

A Manuscript in Trove is one container of writing — one novel, novella, or short story collection. It owns a Manuscript Tree of Scenes and a manifest pointing at the Codex that holds its Entities.

  • One writable Manuscript Tree under scenes/.
  • A manifest (manifest.toml) with status, word target, and the link to its Codex.
  • Drafts (snapshots of Scenes) under .snapshots/.
  • Attachments (reference files bound to Scenes) under .attachments/.
  • Trash under .trash/.

On disk:

manuscripts/{slug}/
manifest.toml
scenes/
.snapshots/
.attachments/
.trash/

The manifest.toml is plain TOML:

name = "Bridgepoint"
slug = "bridgepoint"
status = "drafting" # drafting | outlining | complete | on-hold
wordTarget = 95000
codexPath = "../../codexes/the-riverlands"

A Manuscript is a structural container. A trilogy is usually three Manuscripts, all linked to the same Codex. The thing inside a Manuscript that you read continuously is the Manuscript Tree — see Scene.

Entities never live inside a Manuscript — they always live in a Codex. When you create a Manuscript, Trove provisions a dedicated Codex for it automatically, so [[ ]] references and the Entity browser work from the first minute. If you’d rather share a setting across books, link an existing Codex instead via the codexPath field — two Manuscripts pointing at the same Codex share the same cast.