A TypeScript static site generator for hand‑coded websites

Amagaki is a lightweight, extensible website generator written in TypeScript. It separates structured YAML and Markdown content from HTML templates, includes first-class localization and build profiling, and stays out of your frontend stack's way.

Amagaki illustration

Quick start

Amagaki is distributed as an npm package (Node.js 20+). To scaffold a zero-bundler starter site from examples/starter/, run:

# Create a new Amagaki project interactively
npx create-amagaki my-site
cd my-site

# Start the dev server (renders pages on request)
npm run dev

# Build the static site to ./build/
npm run build

Or install @amagaki/amagaki directly in an existing project:

npm install --save @amagaki/amagaki

Key features

Built-in build profiling

Every build tracks memory usage, output sizes, route counts, and missing translations, with detailed per-template and per-route timing tables via --profile.

Plain HTML, CSS, and TypeScript

Focus on templates, styling, and content architecture without heavy frontend framework boilerplate or opaque build pipelines.

Not a frontend framework

Amagaki generates plain static files. Pair it with vanilla JS, Web Components, Preact, or any frontend tooling you choose.

Extensible in TypeScript

Configure routes, custom YAML types, template filters, Express dev-server middleware, and build hooks directly in amagaki.ts.

First-class localization

Define site, collection, and document locales natively, resolve localized fields with !IfLocale, and manage translatable strings with !pod.string.

Structured content layer

Model repeatable collections, partial modules, and cross-document references in YAML and Markdown without hardcoding URLs.

Why Amagaki?

Amagaki was designed specifically for marketing and informational websites that sit between simple blogs and full single-page applications:

  • TypeScript-first: Write configuration, plugins, and custom routes in TypeScript using the same Node.js ecosystem as your frontend.
  • Clean content/template separation: Store copy, structured fields, and cross-references in YAML/Markdown while keeping presentation in Nunjucks or custom template engines.
  • On-demand dev server: During development, pages render on request rather than triggering full site rebuilds on every edit.
  • Maintenance status: Amagaki continues to be maintained for existing sites with bug fixes and dependency updates. For new projects, we recommend Root.js — Blinkk's modern successor built with TypeScript, Preact/TSX, file routing, i18n, and a built-in CMS.

Open source

Amagaki is released under the MIT License and maintained by Blinkk. View the source code, file issues, or browse related packages on GitHub.