curlytag

CurlyTag - Open Source JavaScript Template Engine

Quick Start

import { template } from './curlytag.js';

template.parse('Hello, !', { name: 'World' });
// → Hello, World!

template.addPath('views/');
const html = await template.render('home', { title: 'Welcome' });

Full documentation: curlytag.com

Development

This project uses Vite+ for formatting (Oxfmt), linting (Oxlint), and commit hooks.

Using Dev Container (recommended)

Open the project in VS Code and select “Reopen in Container”. The container will automatically:

Install Node.js (LTS)
Install vp CLI (Vite+)
Install project dependencies

After the container starts, you’re ready to work.

Without Dev Container

Install Vite+:

macOS / Linux:
```
 curl -fsSL https://vite.plus | bash
```
Windows:
```
 irm https://vite.plus/ps1 | iex
```
Alternatively, download and run vp-setup.exe from setup.viteplus.dev.

[!NOTE]

vp-setup.exe is not yet code-signed. Your browser may show a warning when downloading. Click “…” → “Keep” → “Keep anyway” to proceed. If Windows Defender SmartScreen blocks the file when you run it, click “More info” → “Run anyway”.

Install dependencies:
```
 vp install
```
Set up commit hooks:
```
 vp config
```

Commands

vp check          # Format, lint, and type-check
vp check --fix    # Auto-fix formatting and lint issues
vp lint           # Lint only
vp fmt            # Format only
vp test           # Run tests once

Test Layout

Tests are organized by feature and should stay split across small files instead of growing a shared catch-all suite.

tests/output/ contains plain output and `` variable rendering tests.
tests/filters/ contains filter tests, with array filters in tests/filters/array/.
tests/tags/ contains tag behavior tests.
tests/render.test.js and tests/add-filter.test.js stay at the top level because they cover broader integration behavior.

When adding a new filter or tag, prefer creating or extending a focused file in the matching directory rather than restoring cases to a monolithic curlytag.test.js file.

Playground

Run the playground in development mode:

vp dev

Vite serves the playground from playground/ using the config in vite.config.ts. Open the local URL printed by the command to work on the editors and examples.

Development Workflow

Run tests in watch mode — tests re-run automatically on file changes:

vp test --watch

Run tests with a browser UI for interactive exploration:

vp test --ui --watch

[!NOTE]

The UI starts at http://localhost:51204/__vitest__/ and stays open as long as the process is running. Always use --watch together with --ui, otherwise the server exits right after the test run.

This site is open source. Improve this page.