> ## Documentation Index
> Fetch the complete documentation index at: https://docs.heyflorence.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Core concepts

> Workspace, project, frame, block, dataset, breakpoint, and canvas mode.

Florence uses a small set of words on purpose. If something feels like Figma, it probably maps — but the names below are the ones the product uses.

## 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. Width follows the active **breakpoint** (Desktop 1200, Tablet 790, Mobile 400). Height hugs the content. You control direction, padding, gap, alignment, and wrap.

**Blocks** are what you put in a frame:

| Block   | What it is for                                                |
| ------- | ------------------------------------------------------------- |
| Chart   | Connect a dataset, map columns, style the graphic             |
| Text    | Heading, paragraph, or block quote                            |
| Image   | Raster on the frame                                           |
| Legend  | Color or size key, linked to a chart                          |
| Table   | Tabular display of a dataset                                  |
| Layout  | Nested flex container (rows, columns, stacks)                 |
| Divider | Line or spacer                                                |
| Control | Dropdown filter (radio, checkbox, and slider are coming soon) |

A **layout block** is a block that can hold other blocks, including other layout blocks.

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.

Google Sheets and other live connections are coming soon.

## 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.

**Brand kits** collect styles, templates, and themes so other projects can link to them. See [Brand kits](brand-kits.md).

## Breakpoints and canvas mode

Breakpoints resize frames and can carry overrides for blocks, charts, and text. Switch with the canvas toolbar or **⌘ ⌥ 1 / 2 / 3**.

**Canvas mode** (light / dark) is how the *graphic* looks — frame surfaces, chart defaults, placeholder colors. It is independent of the app theme (your editor chrome). A dark graphic in a light editor is intentional.

## Selection

Florence has three mutually exclusive selection tiers: **frames**, **blocks**, and **elements**. Clicking into a block keeps you in block selection until you click the frame background. Chart elements (bars, ticks, labels) are selectable on the canvas; some decorative children (image thumbnail, divider line) select the parent block instead.


## Related topics

- [Florence help](/index.md)