tutuca

name: tutuca description: Use when authoring or reviewing tutuca modules — `component({...})` definitions, `html`...`` views, `@`-directives, `input` / `bubble` / `receive` / `response` / `alter` handlers, macros, or `getTests` exports — or when running the `tutuca` CLI (`lint` / `test` / `render` / `show`). Covers the post-edit `tutuca lint <module>` → `test` → `render --title "<example>"` verification recipe.

Tutuca is an immutable-state SPA framework. See core.md for the framework primer and the post-edit verification recipe (tutuca lint <module> → test → render --title "<example>").

Companion skills

When authoring tutuca code, also load these if available:

immutable-js — every immutable export is reachable through tutuca (List, IMap, OMap, ISet, Record, Seq, fromJS, is, …). Reach for it whenever the work touches state values.
margaui — the Tailwind v4 / daisyUI-compatible class library. Reach for it when the project uses MargaUI / Tailwind class lists in class= / :class=.

Routing

Task	File
Authoring `component({...})`, `html`...`` views, macros, fields, events, lists, styles	core.md
Designing components — responsibilities, state ownership, channel choice, do's & don'ts	component-design.md
CLI commands, flags, exit codes, full linter rule list	cli.md
`bubble` / `send`-`receive` / async `request`-`response` channels, `$unknown`, request-handler registration	request-response.md
Drag & drop, dynamic bindings (`*x`), pseudo-`x`, custom seq types, Tailwind/MargaUI	advanced.md
Runtime semantics — path steps, transaction lifecycle, dyn-var teleporting, async key pinning (`livePath`)	semantics.md
Authoring tests — `getTests` shape, calling methods/input/receive/bubble/response/alter handlers, designing handlers for testability	testing.md
Task-oriented recipes — iteration, filtering, conditional content, conditional attributes, dynamic vars, composition, events	patterns/README.md

Read core.md first. Reach for the others only when the task touches them — each is referenced inline from core.md so you'll be pointed there when relevant.