PageGuard vs Metalsmith

Metalsmith is an extremely flexible plugin-based Node.js static site generator with 7.9K+ GitHub stars — everything is a plugin, giving developers full control over the build pipeline — but as a static site generator it has no built-in WCAG accessibility audit, no Core Web Vitals scoring, and no post-deployment health monitoring. PageGuard audits the live deployed URL of any Metalsmith site externally — free, no source code needed, results in 30 seconds.

ADA Title II Deadline: April 24, 2026

State and local government websites must meet WCAG 2.1 AA by April 24, 2026. Government agencies, universities, and nonprofits using Metalsmith for documentation and project sites may not realize that their plugin pipeline can produce inaccessible HTML. Handlebars/Nunjucks template partials can omit alt text on images; layout templates may break heading hierarchy; CSS included via metalsmith-assets may have insufficient color contrast; custom plugins can strip or misplace ARIA attributes. These issues only surface in the deployed HTML and require external runtime validation. PageGuard provides continuous post-deployment accessibility monitoring of your Metalsmith output without modifying your plugin configuration.

PG
PageGuard
Best for: external health monitoring & ADA compliance auditing for any deployed Metalsmith site
  • Free tier — scan any Metalsmith production site instantly, no Node.js or plugin source access needed
  • WCAG 2.1 AA accessibility audit of the live rendered output including Handlebars/Nunjucks template output and plugin-transformed content
  • Core Web Vitals scoring (LCP, CLS, FCP) including template CSS/JS assets and image optimization
  • Technical SEO audit of meta tags, canonicals, structured data, and heading hierarchy in Metalsmith pages
  • Automated monitoring with email alerts on score regression — no Metalsmith rebuild needed
  • Monitor 1–50 sites from $9/month
Metalsmith
Best for: building fully customized static sites via a composable plugin pipeline — documentation, catalogs, and non-standard content structures
  • Minimal core (read files → plugins → write output); 200+ community plugins: metalsmith-markdown, metalsmith-layouts, metalsmith-collections, metalsmith-permalinks
  • Full pipeline control: combine Markdown, YAML, JSON, and any templating engine (Handlebars, Nunjucks, Pug); integrates with gulp, webpack, and npm scripts
  • Ideal for non-standard site structures: API documentation, product catalogs, multi-source content pipelines, and custom publishing workflows
  • No live WCAG/ADA audit of deployed production sites
  • No Core Web Vitals scoring for deployed sites
  • No automated health monitoring or regression alerts for production deployments

Feature Comparison

Feature PageGuard Metalsmith
What is it? External website health monitor — scans any URL for performance, accessibility, SEO, and best practices Extremely simple, pluggable static site generator in Node.js (2014) — everything is a plugin; reads files from /src, runs them through middleware-style plugins, writes to /build; 7.9K+ GitHub stars; popular for project documentation, company blogs, and micro-sites
Free tier Yes — unlimited one-off scans, no signup required Free and open source (MIT license); no SaaS pricing — you install Metalsmith via npm, chain plugins, run the metalsmith command to build, and deploy the static output to any hosting provider
Accessibility audit (WCAG / ADA) Yes — WCAG 2.1 AA scored 0–100 with specific issue list No — Metalsmith generates static HTML via chained plugins but has no built-in WCAG or ADA accessibility auditing; accessibility quality depends entirely on the Handlebars/Nunjucks/Pug templates and any custom plugin transformations applied during the build
Technical SEO audit Yes — meta tags, headings, canonical, structured data No — metalsmith-sitemap generates XML sitemaps; metalsmith-html-minifier can clean output; but no built-in SEO audit scores, structured data validation, or heading hierarchy checking
Performance audit (Core Web Vitals) Yes — LCP, CLS, FCP scored 0–100 per scan No — Metalsmith produces static files which are inherently fast when served correctly, but Core Web Vitals depend on template CSS/JS, image optimization plugins, and CDN configuration; no built-in CWV measurement or scoring
Plugin-based static site generator No — PageGuard is a monitoring tool, not a site generator Yes — Metalsmith's entire architecture is built around plugins: metalsmith-markdown converts .md files, metalsmith-layouts applies Handlebars/Nunjucks/Pug templates, metalsmith-collections organizes content, metalsmith-permalinks generates clean URLs, metalsmith-assets copies static files; compose any pipeline from 200+ community plugins
Extreme flexibility and customization No — PageGuard is a standalone monitoring service Yes — Metalsmith's minimal core (only reads files, pipes through plugins, writes output) gives developers full control; ideal for non-standard content structures like API docs, product catalogs, or multi-source pipelines combining YAML, JSON, and Markdown files; easily integrates with gulp or webpack build systems
Automated website monitoring Yes — weekly or daily scans with email alerts on score drop No — Metalsmith is a build tool; it has no post-deployment health monitoring, accessibility regression alerts, or uptime checking for sites it generates
AI-generated plain-English report Yes — explains issues in non-technical language No — no AI health report for sites built with Metalsmith
ADA Title II compliance monitoring Yes — WCAG audit + alert on accessibility regression No — Metalsmith does not audit or alert on WCAG compliance; Handlebars/Nunjucks template changes can silently introduce accessibility regressions (missing alt text in image partials, incorrect ARIA roles in navigation layouts, poor color contrast in CSS) that only manifest in the deployed HTML and require external runtime validation
Works on any platform Yes — scans any URL on any front-end or platform No — Metalsmith builds your own static site only; it does not audit sites built by others or sites using different generators
Independent external audit Yes — third-party scan, shareable URL for clients/stakeholders No — no built-in tool to generate a shareable external health report for a Metalsmith-generated site
Instant on-demand scan Yes — results in 30 seconds, no code changes needed No — no on-demand health scan; external auditing of Metalsmith sites requires separate tools like Lighthouse or axe after deployment
Multi-site dashboard Yes — 1–50 sites depending on plan Metalsmith builds individual static sites; there is no health monitoring dashboard showing accessibility, SEO, and performance scores across multiple Metalsmith deployments
Pricing for health monitoring Free + from $9/mo for automated monitoring Health monitoring not available — Metalsmith is a static site generator, not a website health monitoring tool

Use PageGuard alongside Metalsmith if you…

  • Run a Metalsmith documentation or project site and need WCAG / ADA compliance verification after each deploy
  • Want to identify accessibility gaps introduced by Handlebars/Nunjucks template partials or custom plugins without inspecting every generated file
  • Run Metalsmith sites for government agencies, universities, or nonprofits subject to ADA Title II by April 24, 2026
  • Need to benchmark Core Web Vitals of template CSS/JS assets and image optimization across your Metalsmith output
  • Want a shareable third-party health report to demonstrate ADA compliance progress to clients, auditors, or procurement teams

Metalsmith alone is sufficient if you…

  • Only need a flexible plugin-based static site generator for non-standard content structures with full pipeline control
  • Use metalsmith-sitemap and integrate axe-core or Pa11y in your CI/CD build for accessibility testing at build time
  • Post-deployment WCAG monitoring and Core Web Vitals checks are handled by separate tooling in your release pipeline
  • Your Metalsmith site is an internal tool or developer documentation with no public accessibility compliance obligations

Audit Your Metalsmith Site Free — No Source Code Required

Get the WCAG accessibility score and Core Web Vitals for your deployed Metalsmith site. Results in 30 seconds. No Node.js, Metalsmith installation, or plugin configuration required.

Results in ~30 seconds. 4 scores: Performance, Accessibility, SEO, Best Practices.

Frequently Asked Questions

Can PageGuard audit a website built with Metalsmith?

Yes — PageGuard scans the live deployed URL of any Metalsmith site hosted on Netlify, GitHub Pages, AWS S3, or a custom server. Enter the public URL and receive a full health report in ~30 seconds covering Core Web Vitals, WCAG 2.1 AA accessibility, technical SEO, and best practices. No Node.js, Metalsmith installation, or plugin source code is required.

Does Metalsmith check website accessibility compliance?

No — Metalsmith generates static HTML through chained plugins and templates with no WCAG compliance checking. Issues in Handlebars partials, Nunjucks macros, and custom plugin output are not validated for accessibility. Common problems include missing alt text in image partials, incorrect heading hierarchy in layout templates, and missing ARIA labels on navigation. PageGuard audits your live Metalsmith site and provides a WCAG 2.1 AA score with specific issues to fix.

Why do Metalsmith sites need external accessibility monitoring?

Metalsmith's plugin pipeline processes files at build time but cannot guarantee the accessibility of the rendered HTML output. Template updates, new plugins, or custom transformations can silently introduce accessibility regressions. Government agencies and nonprofits running Metalsmith documentation sites face ADA Title II requirements by April 24, 2026. PageGuard provides continuous post-deployment monitoring without modifying your plugin pipeline.

Is PageGuard a replacement for Metalsmith?

No — they serve completely different purposes. Metalsmith is a flexible plugin-based static site generator that processes files through a composable middleware pipeline to produce deployable static HTML. PageGuard is an external quality monitoring tool for the deployed output. Organizations using Metalsmith should add PageGuard to continuously monitor the accessibility, SEO, and performance of their deployed sites without modifying their existing plugin pipeline.

Explore More