Language version 1

Build a site from one readable file.

AppBlocks uses two-space indentation. The first token names the block, quoted values are positional content, and key=value pairs configure behavior.

1. Create a source file

hello.appblocks

site "Acme" theme=blueprint
  meta description="A concise product site."
  page "/" title="Acme"
    hero variant=split
      eyebrow "A sharper workflow"
      title "Move from request to result." level=1
      text "A complete responsive page from semantic blocks."
      button "Start now" href=/signup variant=solid

2. Compile it

terminal

npx app-blocks-web build hello.appblocks --out public

The output contains route HTML, appblocks.css, appblocks.js, a block catalog and an exact build manifest. It runs from any static host.

3. Let the compiler correct the model

diagnostic

error: 8:5 Unknown block 'featre'
  hint: Did you mean 'feature'?

Commands

CLI commands5 records

CLI commands
Command	Purpose
build	Compile deployable static output
dev	Watch, rebuild and serve with live reload
validate	Check syntax, contracts and security boundaries
catalog	Inspect concise machine-readable block manifests
tokens	Measure source-to-output expansion

LLM authoring policy

Read LLMS.txt before generating AppBlocks.
Query only the relevant catalog family.
Prefer one compound block over many layout primitives.
Specify content and exceptions; accept semantic defaults.
Run validate, then build, then inspect the rendered result.