- Home
- Static site generators
- Metalsmith
Metalsmith
Metalsmith · Belgium · founded 2014
What it is
Metalsmith is a free static-site generator for NodeJS that works as a pluggable library rather than requiring a predefined project structure. It turns a directory tree into plain JavaScript objects that plugins can transform, giving developers control over how projects are arranged and built. It provides both a JavaScript API and a command-line interface, and supports configuration over code as well as code over configuration. Metalsmith works with npm, Markdown, JSON, YAML, and a templating language of choice. Example uses include static sites, scaffolding, backups, command-line and deployment tools, and eBooks built from Markdown for PDF, ePUB, or MOBI output. Starter repositories include blog, company, resume, and clean-blog projects. Builds create static folders that can be deployed to CDNs, Netlify, GitHub Pages, GitLab Pages, SFTP hosts, or custom servers. Plugin examples include Sass, PostCSS, JavaScript bundling, Markdown, collections, and layouts. Metalsmith requires NodeJS; the listed platforms include API, Linux, macOS, and Windows. Partial rebuilds are not available, and the documentation recommends using a file watcher and browser synchronization package for automatic rebuilds.
For and against
For
- Free software under the MIT/(L)GPL license.
- Offers both a JavaScript API and CLI.
- Supports Markdown, JSON, YAML, and templating languages.
- Builds can target CDNs and several hosting options.
- Starter repositories cover blog, company, and resume projects.
Against
- Requires NodeJS.
- Partial rebuilds are not available.
- No local preview server is listed.
- The pricing page returns a 404.
The verdict
Metalsmith offers a flexible, plugin-oriented approach to building static outputs, with an API and CLI and several deployment targets. Developers who need partial rebuilds should note that this capability is not yet offered.
Who it suits
Metalsmith suits developers who want a NodeJS-based generator with plugin-driven project structure and build steps. It may also fit users creating static sites, command-line tools, deployment tools, or Markdown-based eBooks.
Plans and prices
Metalsmith.js
MIT/(L)GPL licensed software
Read 28 Sep 2026 · metalsmith.io
On the record
- API and CLI
- The package exposes both a JavaScript API and a command-line interface.metalsmith.io · read 28 Sep 2026
- Billing information
- No billing terms or prices are stated on the supplied pages.metalsmith.io · read 28 Sep 2026
- Build limitation
- Metalsmith does not yet offer partial rebuilds; the documentation recommends using a file watcher and browser synchronization package for automatic rebuilds.metalsmith.io · read 28 Sep 2026
- CMS integration
- Yesmetalsmith.io · read 20 Sep 2026
- Community channel
- The project says informal announcements are made periodically in the Gitter community chat.metalsmith.io · read 28 Sep 2026
- Company attribution
- The site copyright notice attributes the website to webbketje and dates it 2021.metalsmith.io · read 28 Sep 2026
- Configuration modes
- It supports both configuration over code and code over configuration.metalsmith.io · read 28 Sep 2026
- Content sources
- markdownmetalsmith.io · read 20 Sep 2026
- Core plugins
- Plugins with the @metalsmith/ prefix are core plugins officially supported by Metalsmith.metalsmith.io · read 28 Sep 2026
- Current release
- Metalsmith 2.7 requires NodeJS 16 or newer and adds metalsmith.yml configuration support plus init and clean CLI commands.metalsmith.io · read 28 Sep 2026
- Deployment
- Builds are static folders that can be deployed to a CDN, Netlify, GitHub Pages, GitLab Pages, SFTP host or custom server over SSH.metalsmith.io · read 28 Sep 2026
- Deployment targets
- Static folders can be deployed to CDNs, Netlify, GitHub Pages, GitLab Pages, SFTP hosts, or custom servers.metalsmith.io · read 28 Sep 2026
- eBook formats
- An example eBook workflow can produce PDF, ePUB, and MOBI files from Markdown.metalsmith.io · read 28 Sep 2026
- Incremental builds
- Yesmetalsmith.io · read 20 Sep 2026
- File transformation
- It translates a directory tree into plain JavaScript objects that plugins can manipulate.metalsmith.io · read 28 Sep 2026
- Integrations
- Examples of plugin integrations include Sass, PostCSS, JavaScript bundling, Uglify, Markdown, collections and layouts.metalsmith.io · read 28 Sep 2026
- Interfaces
- The package exposes both a JavaScript API and a CLI.metalsmith.io · read 28 Sep 2026
- Library design
- Metalsmith works more like a library than a framework and does not require a predefined structure.metalsmith.io · read 28 Sep 2026
