twee-tsTypeScript Twee-to-HTML Compiler

A complete reimplementation of Tweego. Zero runtime dependencies. Node.js 22+.

Drop-in Tweego Replacement

Reads the same .twee, .tw, .css, .js, font, and media files. Respects TWEEGO_PATH. Same output.

Pure TypeScript with no external packages. Runs on Node.js 22+ out of the box.

Use compile(), compileToFile(), and watch() directly from your TypeScript or JavaScript code.

First-class Vite and Rollup plugins with hot reload support for .tw files.

Story formats are automatically downloaded from the Story Formats Archive when not found locally.

Map custom tag names like "library" or "theme" to built-in special tags like "script" and "stylesheet".

# Install
npm install @rohal12/twee-ts

# Initialize a project
npx @rohal12/twee-ts --init

# Compile
npx @rohal12/twee-ts -o story.html src/

Or use the programmatic API:

typescript

import { compile } from '@rohal12/twee-ts';

const result = await compile({
  sources: ['src/'],
  tagAliases: { library: 'script' },
});