Workspace and projects
A workspace is the top-level container for a team. It holds members, folders, brand kits, and projects. A project is the main working unit. Each project has its own canvas, datasets, styles, and frames. Create projects from the dashboard. Avoid thinking of a project as a “file” in the Finder sense — it is closer to a Figma file, but the thing you publish or export is usually a frame inside it.Frames and blocks
A frame is a responsive artboard on the canvas. Default breakpoint widths are Desktop 1200, Tablet 768, and Mobile 390 — you can change those per project in the canvas Breakpoints pane. When Responsive is on, width follows the active breakpoint (constrained by max width) and height hugs the content. When Responsive is off, the frame uses a fixed width and either hugs or a fixed height. You also control direction, padding, gap, alignment, and wrap. Blocks are what you put in a frame:
A layout block is a block that can hold other blocks, including other layout blocks. A tooltip or pop-up is a layout block attached to a chart or table, not a separate block type. A pop-up can sit on the mark or open as a modal.
In the editor, clicking a control selects it. The filter runs in Preview, on a published link, and in an embed. The choice is not saved with the project. A tooltip or pop-up on the canvas shows its template tokens, such as
{Value}. Preview fills those in from the mark you hover or click.
An element is a selectable piece inside a block — a bar, an axis title, a text span. The layers panel shows frames, blocks, and elements as one tree.
Datasets
A dataset is tabular data living on the project: CSV, TSV, JSON upload, or a pasted blank. The original upload is not overwritten — edits and transformations sit on a derived view. Connect a dataset to one or more chart blocks, then map columns to roles (X, Y, color, series, facet, and so on). Sample datasets are available if you want to click around before using your own file. Connected datasets link a Google Sheet tab or an Airtable view from the New dataset menu (same flow from a chart’s empty “Link dataset” state). Florence stores a read-only snapshot in the project — use Refresh in the dataset data view when you want the latest remote rows. Upload and paste workflows are unchanged.Assets: styles, templates, themes
Open the Assets tab in the left sidebar.- Styles — saved colors and text definitions. Apply a text style to headings or chart labels; edit the style once to update everything linked to it.
- Templates — a saved frame (structure, blocks, and content). Insert one to get a new frame you can retarget to a different dataset and override. V1 copies the source; it is not a live-linked component.
- Themes — a saved styling snapshot (colors, fills, strokes, spacing) without changing content or structure. Apply a theme to reskin a frame.

