@papack/ssg

Minimal static site generator with JSX to File rendering.

Core Idea

- Components can be async
- One-shot rendering (SSG -> static files)
- No state, no reactivity, no hydration
- Every route is just a function

Install

``bash
npm install @papack/ssg
`

Quick Start

`ts
import { StaticSiteGenerator } from "@papack/ssg";

const gen = new StaticSiteGenerator({
out: "./dist",
ctx: { siteName: "Example" },
});

gen.html("/", async (ctx) => {
return

{ctx.siteName}

;
});

await gen.run();
`

Routes

$3

`ts
gen.html("/", () => );
gen.html("/blog", () => );
gen.html("/about.html", () => );
`

Path mapping:

- / -> index.html
- /blog -> blog/index.html
- /about.html -> exact file

$3

`ts
gen.css("/style.css", () => "body {}");
gen.js("/app.js", () => "console.log('hi')");
`

- file extension required
- returns plain strings
- no bundling

$3

`ts
gen.public("/", "./public");
gen.file("/cv.pdf", "./cv.pdf");
`

$3

`ts
gen.notFound(() =>

404

);
`

Generates 404.html.

JSX Helpers

$3

`ts
{(item) =>

{item}

}
`

- single render function
- no keys, no diffing
- SSR-only

$3

`ts



`

Controls existence, not visibility.

Context (ctx)

`ts
new StaticSiteGenerator({
out: "./dist",
ctx: { api, version: "1.0" },
});
``