What Metalsmith is
Metalsmith is a free static-site generator for NodeJS that works as a pluggable library rather than a framework requiring a set project layout. It turns a directory tree into plain JavaScript objects that plugins can change and build. Developers can shape project structure and output through plugins, and use either a JavaScript API or command-line interface. Metalsmith works with npm, Markdown, JSON, YAML and a chosen templating language, with configuration over code or code over configuration. Example uses include static sites, scaffolding, backups, command-line and deployment tools, as well as eBooks produced from Markdown for PDF, ePUB or MOBI. Starter repositories cover blog, company, resume and clean-blog projects. Builds produce static folders deployable to CDNs, Netlify, GitHub Pages, GitLab Pages, SFTP hosts or custom servers. Plugin examples include Sass, PostCSS, JavaScript bundling, Markdown, collections and layouts. It requires NodeJS and lists API, Linux, macOS and Windows platforms. The supplied pages state no billing terms or prices, and the pricing page returns a 404. Partial rebuilds are not available; documentation recommends a file watcher and browser synchronization package for automatic rebuilds.
Who it suits
Metalsmith suits NodeJS developers who want to assemble a static-site build around plugins and their own project structure. It can also support other file-generation workflows such as eBooks and command-line tools.
Good to know, and what to watch
- Provides both a JavaScript API and CLI.
- Does not require a predefined project structure.
- Supports Markdown, JSON and YAML.
- Builds can be deployed to several hosting targets.
- Requires NodeJS.
- Partial rebuilds are not available.
- Pricing page returns a 404.
- No local preview server is listed.
Plans
Every plan and priceMetalsmith.js
Free plan
The verdict
Metalsmith offers a flexible, plugin-based approach to static output and other build tasks. Developers should account for the NodeJS requirement and lack of partial rebuilds when planning an automatic workflow.
What the maker publishes
- API and CLI
- The package exposes both a JavaScript API and a command-line interface. source
- Billing information
- No billing terms or prices are stated on the supplied pages. source
- Build limitation
- Metalsmith does not yet offer partial rebuilds; the documentation recommends using a file watcher and browser synchronization package for automatic rebuilds. source
- CMS integration
- Yes source
- Community channel
- The project says informal announcements are made periodically in the Gitter community chat. source
- Company attribution
- The site copyright notice attributes the website to webbketje and dates it 2021. source
- Configuration modes
- It supports both configuration over code and code over configuration. source
- Content sources
- markdown source
- Core plugins
- Plugins with the @metalsmith/ prefix are core plugins officially supported by Metalsmith. source
- Current release
- Metalsmith 2.7 requires NodeJS 16 or newer and adds metalsmith.yml configuration support plus init and clean CLI commands. source
- Deployment
- Builds are static folders that can be deployed to a CDN, Netlify, GitHub Pages, GitLab Pages, SFTP host or custom server over SSH. source
- Deployment targets
- Static folders can be deployed to CDNs, Netlify, GitHub Pages, GitLab Pages, SFTP hosts, or custom servers. source
- eBook formats
- An example eBook workflow can produce PDF, ePUB, and MOBI files from Markdown. source
- Founded
- 2014 source
- Free plan
- Yes source
- Incremental builds
- Yes source
- File transformation
- It translates a directory tree into plain JavaScript objects that plugins can manipulate. source
- Integrations
- Examples of plugin integrations include Sass, PostCSS, JavaScript bundling, Uglify, Markdown, collections and layouts. source
- Interfaces
- The package exposes both a JavaScript API and a CLI. source
- Library design
- Metalsmith works more like a library than a framework and does not require a predefined structure. source
- Multilingual support
- Yes source
- Operating systems
- Metalsmith builds are tested on Linux and Windows systems and officially supported NodeJS LTS releases. source
- Package installers
- Installation examples are provided for npm, yarn, and pnpm. source
- Plugin architecture
- Plugins provide control over how projects are conceptualized, structured, and built. source
Checked against the maker's pages on 28 Sept 2026.