# template-builder

> Free, open-source SDK to preview, validate and create WhatsApp message templates, maintained by Talqui. MIT licensed.

One JSON schema describes a template. The core package validates it against the rules Meta applies at review (73 typed issue codes) and builds the request that creates it on the Meta Cloud API, Twilio or Talqui. The React and Vue packages render a preview calibrated against a real iPhone.

## Key links

- [Agent quickstart](https://template-builder.dev/agents): install, validate, build the create request
- [JSON Schema](https://template-builder.dev/schema.json): every field a template accepts
- [Template catalog](https://template-builder.dev/whatsapp-template.md): 157 free templates by industry, as Markdown
- [Playground](https://template-builder.dev/playground): free online WhatsApp template builder and preview
- [Editor](https://template-builder.dev/editor): embeddable template editor for React and Vue apps
- [GitHub](https://github.com/talqui-oss/template-builder)
- [npm](https://www.npmjs.com/package/@talqui-oss/template-builder)

## Getting started

```sh
npm i @talqui-oss/template-builder
```

```ts
import { validate, toRequests, toCurl } from "@talqui-oss/template-builder";
import { meta } from "@talqui-oss/template-builder/adapters/meta";

const { valid, issues } = validate(template);
console.log(toCurl(toRequests(template, meta({ wabaId: "123" }))));
```

## Integrations

Meta Cloud API (verified), Talqui (verified), Twilio Content API (beta), any other provider through `defineAdapter`. Preview and editor components for React and Vue (`TemplatePreview`, `TemplateEditor`).

## Skills

- [template-builder skill](https://github.com/talqui-oss/template-builder/blob/main/skills/template-builder/SKILL.md): `npx skills add talqui-oss/template-builder`

## Optional

- [Full text](https://template-builder.dev/llms-full.txt): this file plus every catalog template with its JSON
- Markdown pages: append `.md` to any https://template-builder.dev/whatsapp-template URL