Docs · Concepts
Sets
A set is a named group of states that share one grid size and one look.
Sets live in the Library. Built-in sets ship with Flickering Dots, and the sets you save stay on this device under My sets.
- Grid: 3 to 16 dots per axis. Non-square grids like 9×3 are fine.
- States: at least one. Idle, Thinking, Success and Error are standard; you can add custom ones.
- Transition: cut, flip wipe or crossfade, for the whole set or per state.
ts
import type { IndicatorSet } from 'flickering-dots';
const set: IndicatorSet = {
id: 'my-pulse',
name: 'My Pulse',
cols: 7,
rows: 7,
transition: 'flip',
states: {
idle: { kind: 'recipe', recipe: 'idle' },
thinking: { kind: 'recipe', recipe: 'pulse', params: { length: 4 } },
success: { kind: 'recipe', recipe: 'check' },
error: { kind: 'recipe', recipe: 'cross' },
},
tags: ['pulse'],
author: 'you',
source: 'mine',
};