kiss-ssg

Examples

Fourteen runnable sites ship inside the package, in node_modules/kiss-ssg/examples/. Each is a standalone project: copy the folder, run it, change it.

Whole sites to copy

Start from the one whose situation matches yours rather than assembling a site from the feature examples.

  • From a single file

    A one-page artifact converted into a site that still looks the same: the original kept beside it, the conversion script, a tool that proves the page unchanged, and the site that came out.

    Copy this when you already have a page — an AI artifact, an export, a hand-written HTML file — and want a site a web developer could take over.

    cd examples/12-from-a-single-file && node router

  • Blog

    Posts as a fan-out, pagination, tag pages, an RSS feed, a rename kept alive with aliases, and every internal link written with {{link}}.

    Copy this when the site has posts in it: a blog, a news section, a changelog.

    cd examples/11-blog && node router

  • Data-fed site

    A site built from a folder of records, each validated in its controller. One record is broken on purpose, so the build fails and says which.

    Copy this when the content comes from data you don't control.

    cd examples/8-data-fed-site && node router

  • Versioned outputs

    One build per season into its own folder, published atomically, with an archive index beside them.

    Copy this when you publish a new edition beside the old ones.

    cd examples/7-versioned-outputs && node router

  • Migrated from v1

    Every v1 to v2 migration recipe as running code, in a site that builds clean and ships a recorded knowledge base.

    Copy this when you're moving a v1 project across.

    cd examples/9-migrated-from-v1 && node router

One feature each

Short scripts that answer a narrower question: which call, which option, which helper.