Examples

Real-world examples and patterns for building with StaticBlocks

Simple Landing Page

A basic landing page with hero, features, and contact form:

# pages/index.yaml
template: main
title: My Product
meta:
  description: The best product ever
blocks:
  - block: header
  - block: hero
    title: Welcome to My Product
    description: Build amazing things
    cta: Get Started
    ctaLink: /signup/
  - block: features
    items:
      - title: Fast
        icon: M13 10V3L4 14h7v7l9-11h-7z
      - title: Simple
        icon: M9 12l2 2 4-4m6 2a9 9 0 11-18 0 9 9 0 0118 0z
  - block: cta-section
    title: Ready to start?
    buttonText: Sign Up Now
    buttonLink: /signup/
  - block: footer

Multi-Language Blog

A blog with i18n support:

# pages/blog/post-1.yaml
template: blog
title: My First Post
meta:
  description: An introduction to our blog
blocks:
  - block: header
  - block: blog-post
    title: "{{translate:blog.post1.title}}"
    content: "{{translate:blog.post1.content}}"
    author: John Doe
    date: 2024-01-15
  - block: footer
// locales/en.json
{
  "blog": {
    "post1": {
      "title": "Getting Started",
      "content": "This is my first post..."
    }
  }
}

// locales/de.json
{
  "blog": {
    "post1": {
      "title": "Erste Schritte",
      "content": "Dies ist mein erster Beitrag..."
    }
  }
}

Translation files for blog content

Portfolio with Projects

A portfolio site with dynamic project listings:

# pages/portfolio.yaml
template: main
title: My Portfolio
blocks:
  - block: header
  - block: hero
    title: John Doe
    description: Web Developer & Designer
  - block: project-grid
    projects:
      - title: E-Commerce Site
        description: Built with React and Node.js
        image: /assets/images/project1.jpg
        link: /projects/ecommerce/
      - title: Dashboard App
        description: Analytics dashboard
        image: /assets/images/project2.jpg
        link: /projects/dashboard/
  - block: footer

Documentation Site

This very site is built with StaticBlocks! Check out the source code to see how it's structured.