Build Static Sites with Blocks

A modern, simple static site generator with block-based architecture, built-in i18n support, and zero runtime JavaScript required.

Get Started

View on GitHub

Why StaticBlocks?

Everything you need to build modern static websites

Block-Based Architecture

Build pages by composing reusable blocks. Each block is a simple HTML file with props.

Built-in i18n

Multi-language support out of the box. Define translations and generate pages for each locale automatically.

TypeScript-Based

Built with TypeScript for type safety and better developer experience. CLI and core are fully typed.

Fast Builds

Optimized build process with esbuild for JavaScript bundling. Watch mode with instant rebuilds.

SEO-Optimized

Automatic sitemap generation, meta tags, Open Graph, and robots.txt for better search engine visibility.

Zero Runtime JS

Generate pure HTML/CSS. Add JavaScript only where needed with automatic bundling.

Quick Example

# pages/index.yaml
template: main
title: Welcome
blocks:
  - block: hero
    title: Hello World
    description: Build fast, ship faster
  - block: features
    items:
      - title: Simple
        description: Easy to learn

Define pages with YAML and compose them from reusable blocks