Component-Based Architecture
Blog
Guides and tutorials for building modern websites
Learn how to build, structure, and optimize component-based Metalsmith sites. From architecture fundamentals to advanced techniques.

Building a Component from Scratch
A comprehensive guide to creating your own Metalsmith component from the ground up, complete with validation, documentation, and submission to the library
Adding Header Search to Your Site
A step-by-step guide to adding a header search form from the Metalsmith Components library to your starter project
Adding Dark/Light Theme Switcher
A step-by-step guide to adding a dark/light theme toggle from the Metalsmith Components library to your starter project
Installing Metalsmith Components in Your Project
Step-by-step guide to downloading and installing component packages. Learn how to add sections and partials to your Metalsmith project with automated install scripts.
Getting Started with the Metalsmith2025 Starter
Complete guide to setting up your first Metalsmith project. From installation to deployment, learn how to build modern static sites with structured content and reusable components.
Understanding Component Validation with Manifest Schemas
Learn how to use JSON Schema validation in manifest.json files to catch errors early, provide better developer experience, and ensure component configurations are correct.