verstak-desktop/docs/WORKSPACE_TEMPLATES.md

1.8 KiB

Workspace Templates

Workspace templates choose which dynamic plugin workspace tabs are visible when a new top-level workspace is created. They do not enable or disable plugins for the whole vault and do not affect global sidebar tools.

Built-in templates

Template Workspace tabs
General Notes, Files, Journal, Activity, Browser Inbox
Project Notes, Files, Todos, Journal, Activity, Browser Inbox
Writing Notes, Files, Journal
Admin Notes, Files, Secrets, Todos, Journal
Minimal Notes, Files

The create-workspace modal displays the selected template description and its included plugin tabs before the folder is created.

Metadata and compatibility

Creation stores a template snapshot in .verstak/workspaces/ metadata. The snapshot contains the template id, name, version, applied time, and an ordered workspaceTools list of plugin IDs. Existing workspace metadata without workspaceTools remains compatible: its workspace continues to show all globally enabled workspace plugins rather than unexpectedly hiding tabs.

Templates are applied once. Editing the built-in catalog or creating another workspace with a different template never changes an existing workspace snapshot. There is no template editor or post-creation template switcher yet.

Global tools and unavailable plugins

Template visibility applies only to workspaceItems in the selected workspace. Global views and sidebar items, such as global Todos, Browser Inbox, and Trash, remain available according to the normal plugin enablement state.

The workspace host intersects the snapshot with dynamically discovered, globally enabled plugin contributions. If a template references a plugin that is missing or disabled, that tab is simply absent; the other template tabs remain usable.