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.
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.