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 Interactive Components with JavaScript
Learn JavaScript patterns for interactive Metalsmith components. Master dynamic library loading, event handling, state management, and modular architecture without frameworks.
Working with Data in Metalsmith Components
Learn how to structure, load, and use JSON data files in Metalsmith components. Master data-driven components with real-world examples from maps, logos, and collections.
Building a Site-Wide Search System
Learn how to implement a robust search system for your Metalsmith site using metalsmith-search plugin and client-side filtering with Fuse.js.
Theming Architecture
Comprehensive guide to implementing dark mode in component-based static sites. Learn about semantic color tokens, adaptive vs. design choice sections, and component-level theme considerations.
How Component Bundling Works
Deep dive into automatic component discovery and bundling with metalsmith-bundled-components. Learn how CSS and JavaScript are automatically optimized for each page.
Building Structured Pages
Complete guide to understanding how Metalsmith transforms YAML configurations into HTML pages. Learn the template hierarchy, Nunjucks macros, data flow, and debugging techniques.