A rocket πŸš€ fast, πŸ’­ light-weight and flexible static site πŸ€– generator.

I know, another static site generator! This one is different - it's totally minimalistic. Basically, it's just two functions. The first, the getPages() function, allows you to retrieve a list of pages, and the allPages() function allows you to iterate through them.

You get a static site generator that is:

Install package

yarn add @sphido/core # that's all

Create index.js

#!/usr/bin/env node

import {dirname, relative, join} from 'node:path';
import {getPages, allPages, readFile, writeFile} from '@sphido/core';
import slugify from '@sindresorhus/slugify';
import {marked} from 'marked';

const pages = await getPages({path: 'content'}, // ... extenders
    (page) => {
        page.slug = slugify(page.name) + '.html';
        page.dir = dirname(page.path);
    });

for (const page of allPages(pages)) {
    page.output = join('public', relative('content', page.dir), page.slug);
    page.content = marked(await readFile(page.path));
    await writeFile(page.output, `<!DOCTYPE html>
        <html lang="en" dir="ltr">
        <head>
            <meta charset="UTF-8">
            <script src="https://cdn.tailwindcss.com?plugins=typography"></script>
            <title>${page.name} | Sphido Example</title>
        </head>
        <body class="prose mx-auto my-6">${page.content}</body>
        <!-- Generated by Sphido from ${page.path} -->
        </html>
    `);
}

Run script

node index.js
Sphido requires Node 14.x and newer. To load an ES module, set `"type": "module"` in the `package.json` or use the `.mjs` extension.

Need more examples?

Let's look at the source code of the site or the examples repository.