# Motion drawings

More ways to draw Candor's animations, and motion for show: blur, flip, swing, skew and wipe for dialogs, menus, arrivals and pops (set with --cd-motion-<family>-variant), and, off until a brand file turns them on (the --cd-show-* tokens), cards and tiles arriving as a page draws, plots drawing in along the reading direction, and cards lifting or glowing under the pointer. Every one is off at the Off level and under reduced motion, and ends on the real content. Import styles/candor-motion-drawings.css after candor.css.

- Registry name: `motion-drawings` (`@candor/motion-drawings`)
- Tier: Pro. Installing it needs a Pro, Premium or Team licence key: the person runs `npx candor-ui key <key>` themselves; never ask for the key in chat or write it to a file.
- Docs: https://candor.themethodic.com/docs/motion-drawings

## Install

```bash
npx candor-ui add motion-drawings
```

Run `npx candor-ui@latest init` once first (https://candor.themethodic.com/get-started.md). Without the CLI: `npx shadcn@latest add @candor/motion-drawings`.
It brings in: tokens.

## Terms used here

- **Calm level**: What Candor's motion does for a person whose operating system asks for reduced motion: the highest-precedence setting, above the app's own motion level (`none`, `calm`, `subtle` or `expressive`) and the brand file. A theme tunes how a change looks, never when it happens, so nothing depends on seeing the motion. (https://candor.themethodic.com/glossary.md#calm-level)

## Rules for using Candor UI

- Components take plain typed data. Never pass model output as HTML or render it as a link; messages are typed blocks.
- A control that can't be used says why: wrap it in `<Locked reason="…">`, don't just disable it.
- Don't show a value you don't have: leave it out (it renders as —) rather than guess. An estimate is labelled as one.
- Nothing is pre-selected in a decision a person makes, and the agent is named from your app's data, never from model output.
- Your app's words go in `LocaleProvider`: its fixed strings in `strings`, its nouns in `nouns`; entity kinds and agent roles in `EntityKindsProvider` and `AgentRolesProvider`.