Statico Source

Statico

Plain HTML in, fast static sites out. One binary: no framework, no Node, no template language to learn.

Start with Introduction

Contents

  1. 1Getting started

    1. 1IntroductionWhat Statico is, what it is for, and why it stays plain HTML.
    2. 2InstallOne binary for macOS, Linux and Windows; the install script, release downloads, or a build from source.
    3. 3Quick startCreate a site from a template, preview it, check it, and build it.
    4. 4Project structureThe folders of a Statico site and what each one is for.
  2. 2Building pages

    1. 5LayoutsWrap pages in shared shells, pass them attributes, and nest layouts.
    2. 6IncludesReusable pieces of HTML, with attributes, in pages, layouts and markdown.
    3. 7PlaceholdersInsert front matter, site settings, collections and URLs with {braces}.
    4. 8FiltersFormat dates, truncate, slugify and more, right inside a placeholder.
    5. 9LoopsRepeat markup over collections and markdown content with the ForEach tag.
    6. 10ConditionsShow markup only when a condition holds, with a safe expression language.
  3. 3Content and data

    1. 11Markdown contentWrite pages in markdown with front matter, drafts and tables of contents.
    2. 12CollectionsData from JSON, YAML, TOML or CSV files, ready to loop over.
    3. 13PaginationSplit long lists across pages, with links between them.
    4. 14TaxonomiesOne page per tag, category or any other front matter field.
    5. 15FeedsAtom feeds for your content folders, written automatically.
    6. 16SEOMeta tags, Open Graph, Twitter cards and JSON-LD from one placeholder.
    7. 17SchemasValidate front matter per content folder, so mistakes fail the build.
  4. 4Build and deploy

    1. 18BuildingWhat statico build writes: pages, assets, sitemap, feeds, search and more.
    2. 19ConfigurationEvery statico.json setting, all of them optional.
    3. 20TemplatesThe starter templates in the binary, and using any repository or folder.
    4. 21Command lineEvery statico command, its flags and its exit codes.
    5. 22DeployingPublishing to GitHub Pages, including project sites under a sub-path, and to any other static host.
  5. 5Reference

    1. 23AI agentsHow Statico is built to be driven by AI coding agents through its CLI.
    2. 24Error codesEvery stable error and warning code, with what it means.