Skip to content
SPECIFICTION
Get listed

Metalsmith

metalsmith.io

Free plan WindowsmacOSLinuxAPI
Visit metalsmith.io
Spec score 8.6 #9 of 35 in Static site generators

What it is

Metalsmith is a free, pluggable static-site generator for NodeJS that works more like a library than a framework. It transforms a directory tree into plain JavaScript objects that plugins can manipulate, without requiring a predefined project structure. Developers can use configuration over code or code over configuration, and access the package through either its JavaScript API or command-line interface. It 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 made from Markdown for PDF, ePUB, or MOBI output. Starter repositories cover blog, company, resume, and clean-blog projects. Builds create static folders for deployment to CDNs, Netlify, GitHub Pages, GitLab Pages, SFTP hosts, or custom servers. Metalsmith requires NodeJS; the listed platforms include Linux, macOS, and Windows. The documentation says partial rebuilds are not available and suggests using a file watcher and browser synchronization package for automatic rebuilds. No billing terms or prices are stated on the supplied pages.

Spec sheet

Deployment
Builds are static folders that can be deployed to a CDN, Netlify, GitHub Pages, GitLab Pages, SFTP host or custom server over SSH.Read 28 Sep 2026 · metalsmith.io
Free plan
YesRead 20 Sep 2026 · metalsmith.io
Integrations
Examples of plugin integrations include Sass, PostCSS, JavaScript bundling, Uglify, Markdown, collections and layouts.Read 28 Sep 2026 · metalsmith.io
Founded
2014Read 28 Sep 2026 · metalsmith.io
API and CLI
The package exposes both a JavaScript API and a command-line interface.Read 28 Sep 2026 · metalsmith.io
Billing information
No billing terms or prices are stated on the supplied pages.Read 28 Sep 2026 · metalsmith.io
Build limitation
Metalsmith does not yet offer partial rebuilds; the documentation recommends using a file watcher and browser synchronization package for automatic rebuilds.Read 28 Sep 2026 · metalsmith.io
CMS integration
YesRead 20 Sep 2026 · metalsmith.io
Community channel
The project says informal announcements are made periodically in the Gitter community chat.Read 28 Sep 2026 · metalsmith.io
Company attribution
The site copyright notice attributes the website to webbketje and dates it 2021.Read 28 Sep 2026 · metalsmith.io
Configuration modes
It supports both configuration over code and code over configuration.Read 28 Sep 2026 · metalsmith.io
Content sources
markdownRead 20 Sep 2026 · metalsmith.io
Core plugins
Plugins with the @metalsmith/ prefix are core plugins officially supported by Metalsmith.Read 28 Sep 2026 · metalsmith.io
Current release
Metalsmith 2.7 requires NodeJS 16 or newer and adds metalsmith.yml configuration support plus init and clean CLI commands.Read 28 Sep 2026 · metalsmith.io
Deployment targets
Static folders can be deployed to CDNs, Netlify, GitHub Pages, GitLab Pages, SFTP hosts, or custom servers.Read 28 Sep 2026 · metalsmith.io
eBook formats
An example eBook workflow can produce PDF, ePUB, and MOBI files from Markdown.Read 28 Sep 2026 · metalsmith.io
File transformation
It translates a directory tree into plain JavaScript objects that plugins can manipulate.Read 28 Sep 2026 · metalsmith.io
Incremental builds
YesRead 20 Sep 2026 · metalsmith.io
Interfaces
The package exposes both a JavaScript API and a CLI.Read 28 Sep 2026 · metalsmith.io
Library design
Metalsmith works more like a library than a framework and does not require a predefined structure.Read 28 Sep 2026 · metalsmith.io
Local preview server
NoRead 20 Sep 2026 · metalsmith.io
Multilingual support
YesRead 20 Sep 2026 · metalsmith.io
Operating systems
Metalsmith builds are tested on Linux and Windows systems and officially supported NodeJS LTS releases.Read 28 Sep 2026 · metalsmith.io
Package installers
Installation examples are provided for npm, yarn, and pnpm.Read 28 Sep 2026 · metalsmith.io
Plugin architecture
All functionality is handled through plugins that manipulate JavaScript file objects.Read 28 Sep 2026 · metalsmith.io
Plugin registry policy
Official registry plugins must be published on npm, include at least one test and pass a brief quality review.Read 28 Sep 2026 · metalsmith.io
Pricing page status
The pricing page returns a 404 and says it is still being forged.Read 28 Sep 2026 · metalsmith.io
Product category
Metalsmith is a static site generator for NodeJS.Read 28 Sep 2026 · metalsmith.io
Product type
Metalsmith is an extremely simple, pluggable static-site generator for NodeJS.Read 28 Sep 2026 · metalsmith.io
Runtime requirement
Metalsmith requires NodeJS and runs on all NodeJS Long-Term Support versions that are not end-of-life and some more.Read 28 Sep 2026 · metalsmith.io
Starter projects
The site provides several starter repositories, including blog, company, resume, and clean-blog starters.Read 28 Sep 2026 · metalsmith.io
Supported formats
It works with NodeJS, npm, Markdown, JSON, YAML and the templating language of the user's choice.Read 28 Sep 2026 · metalsmith.io
Supported languages
JavaScript,TypeScript,Node.jsRead 20 Sep 2026 · metalsmith.io
Supported tools
It works with NodeJS, npm, Markdown, JSON, YAML, and a templating language of choice.Read 28 Sep 2026 · metalsmith.io
Use cases
It can generate static sites, scaffolders, backups, command-line tools, and deployment tools.Read 28 Sep 2026 · metalsmith.io

Plans and prices

Metalsmith.js Free MIT/(L)GPL licensed software Read 28 Sep 2026 · metalsmith.io

Every Metalsmith plan and price →

Strong points and limits

Strong points

  • Plugin architecture controls project structure and builds.
  • Provides both a JavaScript API and CLI.
  • Works with Markdown, JSON, YAML, and templating languages.
  • Builds can deploy to several named hosting targets.
  • Free software for NodeJS.

Limits

  • Requires NodeJS.
  • Partial rebuilds are not available.
  • Automatic rebuilds require a file watcher and browser synchronization package.

Who it suits

Metalsmith suits developers who want to shape a NodeJS site build through plugins and JavaScript rather than adopt a fixed project structure. It may also fit workflows that produce static files or eBooks from Markdown.

Verdict

Metalsmith offers a flexible, plugin-led approach for NodeJS projects and several types of output. Its lack of partial rebuilds matters for automatic rebuild workflows, and the supplied pages state no billing terms or prices.

Where Specifiction places it

Alternatives to MetalsmithAll alternatives →