# Template Tiger

> **To render a Handlebars template, POST JSON variables to /api/v1/templates/{name}/render with X-API-Key header.**

Template Tiger is a template management and rendering service that allows you to store Handlebars templates centrally and render them via a REST API. It enables teams to move email templates, HTML snippets, and other dynamic content out of application codebases into a centralized, manageable system.

## Quick Start
1. Create API key at `/api-keys`
2. POST to `/api/v1/templates/{name}/render` with JSON variables
3. Receive rendered HTML

## Workflow for Agents

### Using Browser Tools (Recommended)
If you have access to browser tools (e.g., `playwright-mcp`, `browser-mcp`, or "Claude in Chrome"):
1. **Navigate** to `https://app.templatetiger.dev/login`.
2. **Prompt the User** to log in manually or provide their credentials if they haven't already.
3. **Automate Management**: Once logged in, you can automate template creation, API key management, and uploads via the web UI.

### Using cURL (Fallback)
If browser tools are unavailable, you must use `curl` to interact with the web interface.
1. **Credentials**: Prompt the user to provide their username and password in the chat or via a local, git-ignored file. **NEVER** hardcode or commit these credentials.
2. **Authentication Flow**: Fetch login page for CSRF token, POST to `/login` with credentials and token, and store session cookie for subsequent requests.

## Management Guide
To create and manage templates:
1. **Login** at `/login`
2. **Create API Key** at `/api-keys` (requires ADMIN or DEVELOPER role)
3. **Create Template**: Navigate to `/templates/create`, enter name (local filename without extension), and paste Handlebars content.
4. **Set Test Data**: Navigate to `/templates/{name}/configure-test`, enter JSON variables, save and preview.

## Documentation
- [/llms.txt](/llms.txt) - Index and overview
- [/llms/api.txt](/llms/api.txt) - Full API reference with code examples
- [/llms/handlebars.txt](/llms/handlebars.txt) - Handlebars syntax guide
- [/llms/integration.txt](/llms/integration.txt) - App integration guide (code patterns, naming)
- [/llms/errors.txt](/llms/errors.txt) - Error codes and troubleshooting

## API Summary
Base URL: `https://app.templatetiger.dev`

| Endpoint | Method | Description |
|----------|--------|-------------|
| `/api/v1/templates/{name}/render` | POST | Render template with variables, returns HTML |
| `/api/v1/templates/{name}` | GET | Get raw template content for client-side rendering |

Authentication: `X-API-Key` header (create at `/api-keys`)

## OpenAPI Specification
Interactive API docs at `/swagger-ui/index.html`. OpenAPI spec at `/v3/api-docs`.