Your First Page

Build a page out of blocks

Every page is a markdown file in src/pages/ whose frontmatter declares a blocks array. Create src/pages/hello.md:

src/pages/hello.md 
---
name: Hello
permalink: /hello/
blocks:
  - type: hero
    content: |
      # Hello, world
  - type: markdown
    content: |
      My first page, built from two blocks.
---

Save it and the dev server renders /hello/ immediately.

Finding the right block

The blocks page renders standalone-previewable block types beside schema-backed YAML examples; collection-restricted contextual blocks show usage guidance instead. Copy a relevant example, confirm consequential fields in the repository's BLOCKS_LAYOUT.md, and adjust it. Invalid block names and top-level fields fail the build with the file and block number.

Structure worth knowing

  • src/pages/ - one file per page
  • src/news/ - dated posts with an Atom feed
  • src/guide-pages/ - documentation pages like this one
  • src/snippets/ - reusable block compositions
  • src/images/ - images, processed into responsive formats