Concepts

Gain a basic understanding of Brivvy's design so teams can set up their workspace and navigate efficiently.

Basic concepts

Workspace

A Brivvy workspace is the container for all comms, templates and other concepts relating to an individual organization. As a user, accounts can exist on one or many workspaces and switching between these accounts uses the dropdown menu in the top left-hand corner of the application. Workspaces each have a unique URL in the style brivvy.io/example. When logging into Brivvy, the login is to a specific workspace.

Comms

The most basic concept in Brivvy is the comm. Most other concepts in Brivvy are either associated with comms or function to organize comms together.

A comm represents a formal communication piece described in structured content. Comms are used for important website-related content including changelogs, blogs, product announcements, job postings and client-facing communications.

Each comm must belong to a single Brivvy workspace and has a unique identifier.

Comms are required to have a name and status. All other properties are optional. This makes it quick to create comms and reduces unnecessary work.

Supported comm properties include body content, assignee, template, creator and date. Relations between comms can be created to mark dependencies or group related communications.

Comms can be created from anywhere in the app. Access the creation flow through the main navigation or keyboard shortcuts.

Status

As work progresses on comms, they move through statuses that reflect their current state. Statuses help teams track which comms are in draft, review, published or archived states. Default statuses are provided but can be customized in workspace settings.

Status can be updated manually to reflect current progress on that comm. Where possible, integrations or automations update comm status to avoid manual ticket management.

For example, integrations with publishing platforms can move comms to published status automatically when content goes live. Workflow automations can move comms between statuses based on defined triggers.

Templates

Templates provide structure and consistency for comms. A template defines the sections, formatting and content guidelines that comms should follow. Templates are applied during comm creation rather than being pre-built documents.

Templates are organized in a library and can be assigned to specific comm types. For example, a changelog template might include sections for new features, improvements and bug fixes, while a blog post template includes sections for introduction, body and conclusion.

Templates can include:

• Predefined section structure

• Content guidelines for each section

• Formatting rules

• Tone and style requirements

• Required and optional fields

When creating a comm, selecting a template applies these guidelines to help maintain consistency across communications.

Organizing comms

Custom views

Views group comms according to a set of filters. Some views come standard like all comms, draft comms or published comms, and custom views can be defined based on any filter available in Brivvy. Because they are based on filters, views are dynamic. When a comm meets the filter set defining the view it will appear, when it no longer meets those criteria the comm will leave the view. Views can be constructed to be visible to only the creator, specific users or the whole workspace.

Access views to see all comms assigned to a user, created within a date range or using a particular template.

To build custom views, use filters on an existing view and then create a custom view from those parameters. Custom views can also be created from scratch through the Views interface.

Labels

Labels provide flexible categorization for comms. Apply multiple labels to any comm to organize content across different dimensions. Labels might represent content type, audience, priority or any other classification relevant to the organization.

Labels are workspace-wide and can be created by any user. Filter views by label to see all related comms.

Assignees

Each comm can have one assignee responsible for moving the comm forward. Assignees receive notifications about changes to their comms and can be filtered in views to see all comms assigned to a specific person.

Creating and editing

Creation methods

Comms can be created through multiple pathways in Brivvy:

• Through the main user interface in the workspace

• Via integrations with external tools

• Using the MCP server for AI-assisted creation

• Through API endpoints for programmatic creation

Each creation method supports applying templates, setting properties and defining content during the initial creation flow.

Editor

The editor provides a rich content authoring experience for comm body content. Content is formatted using Markdown, supporting common formatting like headings, lists, links, images and code blocks.

The editor validates content against template requirements and provides guidance on structure and formatting. Real-time previews show how content will appear when published.

Collaboration

Multiple team members can work on comms through the assignment and review process. Comments can be added to comms for feedback and discussion. Activity logs track all changes made to a comm including status updates, content edits and property changes.

Taking actions

Whenever something is done in Brivvy that changes a comm, template or another piece of data, an action is being taken.

How it works

Brivvy is designed so that actions can be taken in multiple ways: using buttons, keyboard shortcuts, contextual menus or by searching for the action in the command interface. This makes it easy to figure out how to do anything in the app and build familiarity since the same patterns are always followed.

For example, to apply a label to a comm, any of these steps can be followed:

• Open the comm and click the apply label button

• Right-click on the comm from the list view and use the contextual menu

• Use the keyboard shortcut for labels

• Open the command menu and search for label

To do anything else to a comm (add an assignee, update status, apply a template, set properties), similar steps are followed.

Bulk actions

Multiple comms can be updated at a time in Brivvy. Labels can be applied, status can be changed and assignees can be set for multiple comms at once. Select all comms on a view and then take the action using any of the aforementioned methods.

An undo action reverses most actions.

Keyboard shortcuts

The keyboard is the fastest method for using Brivvy. Even if keyboard shortcuts are not normally used, learning ones for common actions such as creating a comm is recommended. The most helpful shortcuts to learn include:

• Creating a comm in any view

• Opening the command menu

• Selecting items

• Selecting multiple items

• Going back or clearing selections

Shortcuts cannot be remapped in Brivvy at this time, though custom shortcuts may be considered in the future.

Command menu

The command menu allows searching and taking any actions applicable to the current view or selection.

Command menu actions are contextually dependent. For example, if comms are being viewed and the command menu opens, the command menu will first display commands that are related to comms.

Navigation

Navigation buttons, menus and dropdowns exist throughout the app. Right-clicking on comms in lists will bring up contextual menus with available actions.