# Dot Matrix Text
Text rendered as a configurable animated dot matrix.
## Installation
Start from a Svelte 5 application, then install the component package, shared theme, and Bits UI peer:
```bash
pnpm add coss-svelte @coss-svelte/theme bits-ui
```
Import `@coss-svelte/theme/style-coss.css` after Tailwind from the application's global stylesheet.
## Usage
```svelte
```
## Anatomy
- `DotMatrixText`
## API Reference
### DotMatrixText
Text rendered as a configurable animated dot matrix.
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| `text` | `string` | - | Text to render; unsupported characters appear as a box. |
| `dot` | `string \| number` | `8` | Dot diameter as pixels or a CSS length. |
| `gap` | `string \| number` | `2` | Gap between dots as pixels or a CSS length. |
| `color` | `string` | `"currentColor"` | CSS color of each dot. |
| `motion` | `DotMotion` | `"reveal"` | Reveal, wave, scan, or still motion. |
| `duration` | `number` | `2.4` | Animation duration in seconds. |
| `stagger` | `number` | `0.045` | Delay between neighbouring dots in seconds. |
| `playing` | `boolean` | `true` | Whether animation is enabled. |
| `label` | `string` | `text` | Accessible label; pass an empty string for decoration. |
Inherits from [Svelte
attributes](https://svelte.dev/docs/svelte/basic-markup#Attributes).
## Implementation Details
| Field | Value |
| --- | --- |
| Status | Experimental |
| Foundation | native |
| Category | Feedback & Status |
| Particles | 1 |
## Status
Render accessible bitmap text with configurable dots, motion, and reduced-motion support.
## Agent Notes
- Import Svelte exports directly from `coss-svelte`.
- This is Svelte 5 code: use `class`, lowercase event properties, runes, snippets, and documented `bind:*` contracts. Do not emit JSX, React hooks, `className`, `asChild`, or Base UI imports.
- Prefer this route's example and generated API table over React COSS snippets; COSS React particles are design references only.
- The copy-and-own registry is a preview. Inspect `/r/dot-matrix-text.json` for the complete local file and dependency closure.
- Treat Dot Matrix Text as experimental and preserve the limitations described in Status.