# November 7, 2026

Attachment docs, per-variant trace installs, scroll-fade and shimmer utilities.

> For the complete documentation index, see [llms.txt](/llms.txt). Markdown variants are available by appending `.md` to any URL or sending an `Accept: text/markdown` header. An agent skill is available at [/.well-known/agent-skills/site-skill.md](/.well-known/agent-skills/site-skill.md).

This release adds the **Attachment** docs page with six examples, per-variant install commands for **Trace**, and two CSS utilities: **scroll-fade** for edge-aware scroll containers and **shimmer** for animated loading text.

- [Attachment](#attachment): Docs page with six examples.
- [Hover Card](#hover-card): Rich content on hover, portal-based.
- [Progress](#progress): Task completion indicator with smooth transitions.
- [Slider](#slider): Range input with single, range, and vertical modes.
- [Questionnaire](#questionnaire): Multi-step form primitive with headless engine.
- [Scroll fade](#scroll-fade): Mask gradient utilities for scroll containers.
- [Shimmer](#shimmer): Animated gradient text utility.

<hr className="my-16 border-border/40" />

### Attachment [#attachment]

<ComponentPreview name="attachment" title="attachment.tsx" previewClassName="h-auto py-8">
<AttachmentDemo />
</ComponentPreview>

**Attachment** renders a compact file card with media, title, description, and actions. It supports idle, uploading, processing, error, and done states with size variants for dense layouts. Pass `variant="image"` to render a thumbnail, or wrap with `AttachmentTrigger` to make the whole card interactive.

#### Installation [#installation]

<Steps>
<Step>
Install the primitive
</Step>

```bash
npx frakment add attachment
```

<Step>
Use it in your app
</Step>

```tsx
import {
Attachment,
AttachmentContent,
AttachmentDescription,
AttachmentMedia,
AttachmentTitle,
} from "@/components/ui/attachment";
```
</Steps>

#### Minimal usage [#minimal-usage]

```tsx
<Attachment>
  <AttachmentMedia>
    <FileTextIcon />
  </AttachmentMedia>
  <AttachmentContent>
    <AttachmentTitle>report.pdf</AttachmentTitle>
    <AttachmentDescription>PDF · 2.4 MB</AttachmentDescription>
  </AttachmentContent>
</Attachment>
```

See the [Attachment docs](/docs/components/attachment) for the full API reference.

<hr className="my-16 border-border/40" />

### Scroll fade [#scroll-fade]

<ComponentPreview name="scroll-fade-overflow" title="scroll-fade-overflow.tsx">
<Component />
</ComponentPreview>

**scroll-fade** applies a scroll-aware mask to the edges of a scroll container. The fade tracks the scroll position, only appearing when there is content beyond the visible area. Variants: `scroll-fade-x` for horizontal, `scroll-fade-{t,b,l,r,s,e}` for single edges, and `scroll-fade-none` to disable.

#### Installation [#installation-1]

```bash
npx frakment add scroll-fade
```

#### Minimal usage [#minimal-usage-1]

```tsx
<div className="scroll-fade overflow-y-auto">{/* ... */}</div>
```

See the [Scroll Fade docs](/docs/utilities/scroll-fade) for the full reference.

<hr className="my-16 border-border/40" />

### Shimmer [#shimmer]

<ComponentPreview name="shimmer-demo" title="shimmer-demo.tsx">
<Component />
</ComponentPreview>

**shimmer** is a CSS utility that animates a gradient over text. Replaces the previous inline-style `<Shimmer>` component with a class that supports color, duration, spread, and angle modifiers.

#### Installation [#installation-2]

```bash
npx frakment add shimmer
```

#### Minimal usage [#minimal-usage-2]

```tsx
<p className="shimmer">Generating response&hellip;</p>
```

See the [Shimmer docs](/docs/utilities/shimmer) for the full reference.

<hr className="my-16 border-border/40" />

### Hover Card [#hover-card]

<ComponentPreview name="hover-card" title="hover-card-demo.tsx">
<Component />
</ComponentPreview>

**Hover Card** displays rich content in a portal when the user hovers over a trigger. It opens after a short delay, stays open while the pointer is over the card, and closes on mouse leave. Built on Radix `HoverCard`, it supports `side`, `align`, `openDelay`, and `closeDelay`.

#### Installation [#installation-3]

<Steps>
<Step>
Install the primitive
</Step>

```bash
npx frakment add hover-card
```

<Step>
Use it in your app
</Step>

```tsx
import {
HoverCard,
HoverCardContent,
HoverCardTrigger,
} from "@/components/ui/hover-card";
```
</Steps>

#### Minimal usage [#minimal-usage-3]

```tsx
<HoverCard>
  <HoverCardTrigger asChild>
    <Button variant="link">@fraktment</Button>
  </HoverCardTrigger>
  <HoverCardContent>
    Registry primitives for React.
  </HoverCardContent>
</HoverCard>
```

See the [Hover Card docs](/docs/components/hover-card) for the full API reference.

<hr className="my-16 border-border/40" />

### Progress [#progress]

<ComponentPreview name="progress" title="progress-demo.tsx">
<ProgressDemo />
</ComponentPreview>

**Progress** shows how much of a task has completed. The indicator animates smoothly on every value change with a 500ms ease-out transform. Optional `ProgressLabel` and `ProgressValue` render a header row with the current percentage.

#### Installation [#installation-4]

<Steps>
<Step>
Install the primitive
</Step>

```bash
npx frakment add progress
```

<Step>
Use it in your app
</Step>

```tsx
import { Progress } from "@/components/ui/progress";
```
</Steps>

#### Minimal usage [#minimal-usage-4]

```tsx
<Progress value={60} />
```

See the [Progress docs](/docs/components/progress) for the full API reference.

<hr className="my-16 border-border/40" />

### Slider [#slider]

<ComponentPreview name="slider" title="slider-demo.tsx">
<Component />
</ComponentPreview>

**Slider** lets the user pick a value or range from a track. It supports single values, ranges with two thumbs, multiple thumbs, and vertical orientation. Built on Radix `Slider`, it handles keyboard navigation, focus rings, and disabled state out of the box.

#### Installation [#installation-5]

<Steps>
<Step>
Install the primitive
</Step>

```bash
npx frakment add slider
```

<Step>
Use it in your app
</Step>

```tsx
import { Slider } from "@/components/ui/slider";
```
</Steps>

#### Minimal usage [#minimal-usage-5]

```tsx
<Slider defaultValue={[50]} max={100} step={1} />
```

See the [Slider docs](/docs/components/slider) for the full API reference.

<hr className="my-16 border-border/40" />

### Questionnaire [#questionnaire]

<ComponentPreview name="questionnaire" title="questionnaire-demo.tsx">
<QuestionnaireDemo />
</ComponentPreview>

**Questionnaire** is a multi-step form **component** that bundles a headless engine. Each step renders one question with a title, optional description, a set of choices, optional freeform input, and inline error. Navigation between steps and the final submit are handled by the headless engine in `lib/questionnaire`, which ships as a registry dependency.

#### Installation [#installation-6]

<Steps>
<Step>
Install the primitive (pulls the engine automatically)
</Step>

```bash
npx frakment add questionnaire checkbox radio-group button card
```

<Step>
Use it in your app
</Step>

```tsx
import {
Questionnaire,
QuestionnaireActions,
QuestionnaireChoice,
QuestionnaireChoices,
QuestionnaireItem,
QuestionnaireNext,
QuestionnairePrevious,
QuestionnaireSubmit,
QuestionnaireTitle,
} from "@/components/ui/questionnaire";
```
</Steps>

#### Minimal usage [#minimal-usage-6]

```tsx
<Questionnaire items={items} onSubmit={handleSubmit}>
  <QuestionnaireItem name="scope" required>
    <QuestionnaireTitle>What should the agent change?</QuestionnaireTitle>
    <QuestionnaireChoices>
      <QuestionnaireChoice value="component">Component only</QuestionnaireChoice>
      <QuestionnaireChoice value="feature">Complete feature</QuestionnaireChoice>
    </QuestionnaireChoices>
  </QuestionnaireItem>
  <QuestionnaireActions>
    <QuestionnairePrevious />
    <QuestionnaireNext>Next</QuestionnaireNext>
    <QuestionnaireSubmit>Save</QuestionnaireSubmit>
  </QuestionnaireActions>
</Questionnaire>
```

See the [Questionnaire docs](/docs/modules/questionnaire) for the full API reference.

<hr className="my-16 border-border/40" />

### Context [#context]

<ComponentPreview name="context-demo" title="context-demo.tsx" src="examples/context-demo.tsx">
<ContextDemo />
</ComponentPreview>

**Context** is a compact context-window indicator. Hovering the badge reveals a token breakdown and a progress bar showing how much of the model's limit is in use.

#### Installation [#installation-7]

```bash
npx frakment add hover-card progress button
```

#### Minimal usage [#minimal-usage-7]

```tsx
<HoverCard>
  <HoverCardTrigger asChild>
    <Button size="sm" variant="outline">{percent}% context</Button>
  </HoverCardTrigger>
  <HoverCardContent>
    <Progress value={percent} />
  </HoverCardContent>
</HoverCard>
```

See the [Context docs](/docs/ai-elements/context) for the full composition.

<hr className="my-16 border-border/40" />

### Inline Citation, Message, Model Selector [#inline-citation-message-model-selector]

Three AI element tutorials ship: **Inline Citation** for source badges, **Message** for a complete message row with actions, and **Model Selector** for a composer with model and effort pickers. Each is a composition, not a primitive.

#### Installation [#installation-8]

```bash
npx frakment add hover-card input-group dropdown-menu message bubble tooltip button markdown
```

Each tutorial has its own page:

- [Inline Citation](/docs/ai-elements/inline-citation)
- [Message](/docs/ai-elements/message)
- [Model Selector](/docs/ai-elements/model-selector)