Documentation
Complete guide to building static sites with Hammer for Mac. Learn about Hammer tags, Content Mode, hosting, and more.
Welcome to Hammer Documentation
Hammer for Mac is a powerful static site generator that makes building websites fast, simple, and enjoyable. This documentation covers everything you need to know to build amazing static sites with Hammer.
Whether you're building a personal blog, a portfolio, a documentation site, or a complex web application, Hammer provides the tools you need to create beautiful, performant static sites.
Hammer Tags
Hammer tags are powerful directives that extend HTML with dynamic functionality. Use them to include components, manage variables, handle assets, and create dynamic content.
<!-- @include _header -->
<!-- @var pageTitle = "Welcome" -->
<!-- @stylesheet style -->
<!-- @javascript main -->Getting Started
Start with these essential Hammer tags:
- Hammer Includes - Reuse HTML components across your site
- Variables - Create dynamic, maintainable content
- Clever Paths - Automatic path resolution for assets
- Assets - Manage stylesheets and JavaScript files
- Placeholder - Generate placeholder images at build time
Advanced Features
- Navigation Helpers - Automatic current page highlighting
- Live Reload - Automatic browser refresh during development
- Todos - Track tasks directly in your code
- Conditionals - Show or hide content based on conditions
- Loops - Iterate over arrays and collections
Content Mode
Content Mode transforms Hammer into a content-driven static site generator. Generate multiple pages from templates, manage content in Markdown and YAML files, and build dynamic sites with ease.
Quick Start
- Learn what Content Mode is and why you'd want to use it
- Enable Content Mode and set up your first collection
- Understand core concepts like collections, content files, and templates
- See workflow examples for blogs, portfolios, and documentation sites
Complete Guide
- Configuration - Deep dive into content.config.json
- Content Files - Creating and structuring Markdown/YAML
- Templates - Building dynamic page templates
- Publishing & Scheduling - Control content visibility
- UI Management - Using Hammer's content interface
- Advanced Features - Relations, helpers, and more
- Troubleshooting - Solve common issues
- Best Practices - Tips for effective usage
Command Line
Hammer CLI brings the same build engine to your terminal. Build sites, validate content, run health checks, and integrate Hammer into CI/CD pipelines and automation workflows.
Quick Start
- Learn what the CLI is and how it relates to the Hammer app
- Install and run your first build from the terminal
- Explore the full command reference for build, check, info, and doctor
Going Further
- Project Structure - How the CLI finds and configures projects
- Automation & CI/CD - JSON output, scripting, and pipeline integration
- Troubleshooting - Diagnose issues with hammer doctor and more
Hosting & Deployment
Deploy your Hammer sites to production with ease. Hammer integrates seamlessly with Forge for one-click deployment, or use CI/CD workflows for automated deployments.
Deployment Options
- Hosting with Forge - One-click deployment with global CDN and automatic HTTPS
- CI/CD Workflows - Automated builds and deployments with Git integration
Getting Help
Need assistance? Here are some resources:
- Community Forum: Join the discussion
- Changelog: See what's new
- Troubleshooting: Common issues and solutions
