# Product visualizations

Use for operational metrics, usage, activity, commercial performance, and other non-scientific product charts. Scientific measurements remain governed by the scientific profile, even inside a product. A dashboard can contain both; scope each profile to its actual plots. Ask when the data's role is ambiguous.

## Choose the encoding

Load the shared visualization fundamentals and the relevant chart-type guide. Use a line for ordered change, grouped bars for category comparisons, and an area only when magnitude relative to zero is meaningful. Start bars and areas at zero; preserve negative values. Do not smooth observations or bridge missing values. Missing is not zero. Do not use a filled area just to decorate a line.

The initial Fractal UI presets cover line charts, grouped vertical bars, and single-series areas. They use equally spaced labeled buckets, such as consecutive days or months; they do not infer temporal spacing from strings. Use an appropriate numeric/time scale for irregular measurements. Dense scientific plots, uncertainty intervals, heatmaps, and arbitrary compositions need a suitable renderer and their own evidence, not a forced fit into these presets.

## Product palette

A single series defaults to blue. Unordered multiple series use the fixed categorical order blue, purple, green, orange, pink, with equal stroke weight and no implied ranking. Use semantic `--chart-series-1` through `--chart-series-5` tokens. Maintain a stable category-to-token assignment across charts, filters, and sessions; set each series color explicitly when series membership or order changes. Do not silently cycle the palette. More than five categories generally calls for faceting, grouping with a disclosed rule, or another encoding.

Light mode maps those tokens to each family's 500 stop; dark mode uses the 300 stops. These are categorical choices, not samples from a continuous scientific map. Keep legend labels and distinct line patterns; this palette is not a claim of universal color-vision safety. Verify contrast and distinguishability at final size. A transparent area must have a full-opacity boundary and accessible exact values.

Status colors apply only when product data actually denotes a status such as success, warning, or failure. Use `--chart-success`, `--chart-warning`, and `--chart-error` deliberately, with labels. Do not assign those meanings to ordinary scientific series. The current presets encode position and series identity, not continuous color magnitude; choose a sequential or diverging map explicitly before adding heatmaps or midpoint-based encodings.

## Typography and interaction

Use Mirror Sans and semantic foreground tokens. Titles, labels, and legends are sentence case; preserve acronyms and notation. Placeholder text always uses normal weight (400), never Medium or heavier. Avoid all-caps overlines. Chart axes and legends use normal weight; title hierarchy comes from placement and size.

Keep backgrounds, axes, and grids neutral. A chart is not automatically a card: compose its frame in the owning product layout. Show units, a useful title, and any material transformation or missing-data explanation. Keep peer series equally prominent unless actual selection warrants emphasis.

Tooltips supplement accessible content; they must not be the only way to get values. Support keyboard inspection and provide a labeled data-table view. Show loading, error, no-data, and missing values distinctly; zero-only data is real data. Honor reduced motion and avoid decorative animation. Verify both themes, narrow widths, long labels, negative and missing values, and keyboard operation.

## Implementation boundary

Use the installed `@mirror-physics/fractal-ui` chart presets when their supported encoding matches the question. Inspect the package for exact exports and props. The package owns the React API; Fractal owns this policy and the canonical chart tokens in `resources/tokens/charts.css`. Apps and packages consume those tokens. For custom renderers, keep the same policy and explicitly verify accessibility and data fidelity.

## Interactive point markers

Product line and area charts hide point markers at rest. Show the active point on hover or keyboard inspection. Keep line patterns and labeled legends to distinguish series without persistent dots. This product default does not override scientific observation-marker guidance.
