# Typecaast

> Simulate & record chat conversations in pixel-faithful renderings of real chat UIs (Slack, iMessage, Telegram, …) from one JSON config. Embed as a React <Typecaast> component or export to video.

A Typecaast simulation is one JSON config: `meta`, `participants`, optional `pacing`, and a `timeline` of steps. The docs below explain how to author or edit that config by hand — no visual playground needed. Validate with `npx @typecaast/cli validate config.json` or the @typecaast/mcp server's `validate_config` tool.

## Docs
- [Authoring configs by hand](https://typecaast.com/docs/authoring-configs) — raw markdown: https://typecaast.com/docs/authoring-configs/raw — Every top-level field and timeline step type — write or edit the JSON config without the playground.
- [Pacing & timing](https://typecaast.com/docs/pacing) — raw markdown: https://typecaast.com/docs/pacing/raw — Gaps, delays, and typing speed — including how to get ~1–2s between messages.
- [Message content](https://typecaast.com/docs/message-content) — raw markdown: https://typecaast.com/docs/message-content/raw — Message bodies: Slack-style mrkdwn and Block Kit content nodes.

## Schema
- [JSON Schema](https://typecaast.com/schema/v1/typecaast.schema.json): the config contract (draft-07). Add `"$schema": "https://typecaast.com/schema/v1/typecaast.schema.json"` to a config for editor autocomplete.

## Tools
- @typecaast/cli (npm): `npx @typecaast/cli validate config.json`; `typecaast render config.json` for video.
- @typecaast/mcp (npm): an MCP server exposing `validate_config`, `get_json_schema`, `list_skins`, and `scaffold_config` — run it in your own editor/project to assemble and validate configs (e.g. from a screenshot).
- @typecaast/react (npm): the `<Typecaast config={…} />` component.

## Skins
Set `meta.skin.id` to one of: slack, telegram, claude-code, imessage, messages-macos, whatsapp, cursor, discord.

## More
- [Playground](https://typecaast.com/playground): build a config visually.
- [Gallery](https://typecaast.com/gallery): example configs.
- [Docs index](https://typecaast.com/docs)
- [llms-full.txt](https://typecaast.com/llms-full.txt): the authoring + pacing guides inlined in one file.