Documentation > Users

Brisa puts cards and boards at the center of what you track and work with. A card is anything you want to track, with a title and description by default. You can also tag or label cards so they show up in other places.

When you want to build on a card, you can open it, click the Add (plus icon) button, and choose a board to add to the card.

In the sections below, the views are explained in more detail.

Dashboard and Header

When you first open Brisa, you will be greeted with a dashboard and a small header.

The header has a Plus icon on the left, used to add a new card to your current label. After that, you will see a list of open views (only the Dashboard when you begin).

To the right, there are 3 icons: Fullscreen if you want to focus solely on the organizer, Settings (described in more detail below), and your username.

The dashboard shows a list of labels you can switch between. You can add, remove, or arrange labels in the settings.

When you add a new card, it will be created in the label selected. You can click on cards you've created to view and edit them.

Cards

When you click on a card, a popup allows you to view and edit. A card has a Title and Description by default. You will also see options in the upper right to label/tag your card, delete it, or close it.

In Brisa, you can build on any card by clicking the Plus icon, then creating a board to add to it. The boards are described in more detail next, but currently, they consist of Kanban, Whiteboard, and Sheet.

When you select a board to add, you can enter a tag to apply to all cards within that board. By default, it will use the title + board name (this will likely change) as the tag. For example, if you add a Kanban to a card titled "Work Tasks," it will use the tag "Work Tasks Kanban."

If you would like to expand cards beyond just a Title and Description, you can add Models to them as well. For example, a Recipe might have fields like "Health Rating," "Ingredients," and "Instructions." You can read more about models below.

Boards

Boards allow you to build on a card. They provide a new view and allow you to add more cards within.

Whiteboard

A whiteboard allows you to add cards and arrange them by clicking with your mouse (or touch on phones and tablets) and drag them. It is useful for overviews and grouping similar tasks in an open, visual way.

In a whiteboard, you can add cards by clicking the Plus icon in the header, then dragging the new card.

Kanban

Kanbans allow you to create groups with lists of cards inside. This is usually used to track the status of large lists of tasks (eg To Do, Started, Testing, Done), but it can also be used to categorize items. For example, a Recipe kanban might have groups for Healthy, Quick Meals, and Delicious.

Sheet

Sheets are spreadsheet-like lists. They allow you to add cards, arrange them, and view and edit fields quickly.

By default, the only fields available are Title and Description. This is where Models come in handy for adding additional fields you would like to track and update. Any model you add to a card will be displayed in the sheet.

To the left of each card, there is an arrow icon to rearrange them, and a button with the row number of the card. Clicking the row number expands a popup with the full card, allowing you to view or edit.

Cards in Boards (or Boards in Boards in Boards ...)

All of the entries you create within a board are also cards. That means if a particular card has many tasks or you want to build on it, you simply add a new board to that card to add more to it.

Settings

The settings menu is accessed by the 3 dots in the upper right corner. This is an overview of the 4 main tabs.

1. Current View

The first tab allows you to configure the current view. Currently, it is always blank, except when you are viewing a whiteboard.

The whiteboard config desperately needs to be more usable, but for now, the options are, in order: Background Color, Card Color, background opacity (0 means you don't see the selected background color, 1 means you won't see your theme background), the grid size (1 lets you move a card anywhere, 10 or 15 makes a useful grid to lock cards at specific points), and, last, a paper background (none, lined, or small/large graph paper).

2. Theme

For now, this allows you to select from pre-defined backgrounds. You can choose from a couple images or solid colors.

3. Labels

This allows you to manage labels. You can add a new label, or arrange or remove existing labels.

Labels are just tags that will show up on your dashboard for quick access. In addition, labels will be available within cards to quickly add them to a label in an update.

4. Models

Models allow you to extend the fields in cards beyond just Title and Description. We'll use Recipe as an example model.

You can create a new model by using the New Model option at the bottom. Typing in Recipe and selecting Add will create the new model.

Once you create a model, you can select the model name at the top to add or edit fields. Once you select a model, you will see an "Add Field" option at the bottom. You can type in a field name (such as Health Rating, Ingredients, Instructions), then select the field type and click Add Field to add it. Here are the field types:

Note: Fields marked with a * (most of them) have not been implemented and will only allow single line text.

  • Text, Single Line: One line of text.
  • Text, multi-line: A bigger block of text (useful for things like an ingredient list).
  • * Markdown Text: Allows you to use Markdown formatting for text, such as # Heading, _italic_, **bold**, etc.
  • * HTML: A WYSIWYG editor for writing formatted content.
  • * Integer: A whole number, like 1, 2, 3, 4, -5, etc.
  • * Decimal: Numbers that include a decimal.
  • * Date+Time: This should allow selecting a date + time from a calendar-like popup.
  • * List Group: This should allow you to create lists within the item.

Once you added a field, you can click the name to rename it, or the type to change the field type.

Using Models

There are two main uses for models, expanding details on a card, and sheets.

After you've created a model, you can add it to any card just like you would add a board. Open the card, click the add button, and you'll see your models listed along with the built-in boards. Select a model it will add a tab for it in the card. Click on the tab, and you'll see the list of fields, which you can click to edit.

Models are very useful for sheets. If you add a model to a card within a sheet, that model and its fields will be listed in directly in the sheet, so you can edit the fields easily. Note that when first adding a model, you may need to close and re-open the sheet in order to display it. This will be fixed.