Skip to main content

Teams

Shared Folders

Shared folders are how a team shares talking points. Because each content file carries its own mapping rules, dropping content in a synced folder gives everyone on the team both the notes and the rules that place them — no central server, no manual setup on each machine.

The idea

A shared folder is any directory that syncs across your team — an iCloud Drive, Google Drive, or Dropbox folder, or a network share. You point Promptr at it, and Promptr indexes the content files inside. The mappings live inside those files (in frontmatter, or a sidecar for rich text), so they travel with the content. When a teammate’s copy syncs, their Promptr picks up the same rules.

No database to sync

Nothing depends on a shared database. The folder holds files; the rules are in the files. That’s the whole system — which is what makes it robust across different Macs and sync providers.

Adding a folder

Open Shared Folders… from the menu, click add, and choose the directory. Promptr starts watching it (via filesystem events, with a periodic re-scan) and indexes every supported file. Newly added folders are enabled by default.

  • Enable / disable — toggling a folder off immediately stops it from matching; toggling it on rebuilds its index.
  • Priority — each folder has a priority number. Lower number = higher precedence when more than one folder could match. New folders get the next number automatically.

Folder-level settings (optional)

You can drop a .promptr.yaml file at the root of a shared folder to override its display name and priority for everyone who syncs it:

.promptr.yamlyaml
name: "Sales — Demo Scripts"
priority: 10

How teammates inherit mappings

  1. You author content and map it (by hand, or via Learning Mode, which writes rules back into the files).
  2. The files sync through iCloud / Drive / Dropbox to your teammates.
  3. Each teammate’s Promptr re-indexes the folder — on a filesystem change, or on its periodic scan — and the new rules become active for them.

How matches resolve

When your live context matches rules from more than one place, Promptr picks a single winner:

  1. Your own local mappings win first. A personal override always beats shared content.
  2. Then shared folders in priority order (lower number first).
  3. Within a folder, an anchor-specific rule beats a page-level one.

See Mappings for the full matching model.

Cloud-storage aware

Promptr handles the realities of synced folders: it won’t wipe your mappings when a cloud folder is briefly unreachable, it downloads files that a provider has evicted to save space, and it skips “conflicted copy” duplicates so they don’t compete as mappings.

Next: authoring the content

Ready to write shareable content? Authoring Shared Content covers the exact frontmatter and sidecar syntax, with copy-paste examples.

Licensing

Shared Folders are available during your free trial and on all paid plans, and disabled once a trial expires without a license. See Licensing & Plans.