BulletList
Vertical list of short strings with a vermilion arrow or dot marker.
→El contexto
→La pregunta
→La respuesta
Simple
Reusable
Consistente
Install
npx shadcn@latest add @jbm/bullet-listNeeds the @jbm entry in components.json; see Install once.
Also installs @jbm/tokens.
Usage
import { BulletList } from "@/jbm/ui/bullet-list"<BulletList size={28} items={["El contexto", "La pregunta", "La respuesta"]} /><BulletList size={28} marker="dot" items={["Simple", "Reusable", "Consistente"]} />import { BulletList } from "@/jbm/ui/bullet-list"import { Pop } from "@/jbm/motion/pop" // install @jbm/pop separately<BulletList items={["El contexto", "La pregunta"]} renderItem={(node, i) => <Pop at={0.4 + i * 0.6} from="left" dist={14}>{node}</Pop>}/>Props
- Stage
fluidFills its container's width; height is n rows × size × 1.25 plus (n − 1) × gap, so three default rows are 3 × 45 + 2 × 16 = 167 stage px. Long items wrap and add lines.
Flex column of rows; each row is 600-weight sans ink text with line-height 1.25, preceded by an accent → or an 18px accent dot, 16px apart. Pure React; renderItem lets you wrap each row, for example in a motion Pop.
| Prop | Type | Default | Description |
|---|---|---|---|
items | string[] | required | Row strings in order. Each string is also the React key, so items must be unique. |
marker | "arrow" | "dot" | "arrow" | "arrow" (vermilion →) or "dot" (18px vermilion circle). |
size | number | 36 | Font size of each row in stage pixels. |
gap | number | 16 | Vertical space between rows in stage pixels. |
renderItem | (node: React.ReactNode, i: number) => React.ReactNode | none | Optional wrapper called with each finished row node and its index; return the node to render (for example inside a Pop with a staggered at). |
style | React.CSSProperties | none | Inline styles on the column, merged last; set width here in a scene. |
QA checks
- Compare arrow and dot markers: the dot stays vertically centered on the first line and the arrow is vermilion.
- Duplicate strings share a React key and trigger a warning; keep items unique.
- Check the full list height fits the safe area in portrait, where the scene compiler uses a 22px gap.
- With renderItem and Pop, step through the stagger and confirm every row ends fully visible.