Installation

Requirements

• Node.js 18 or later
• pnpm 9 or later (recommended) — or npm/yarn

Create a new site

The fastest way to get started is with create-stedefast:

npm create stedefast my-site
# or
pnpm create stedefast my-site

You'll be prompted to choose a template (blog, docs, portfolio) and a theme (minimal, hacker).

Manual setup

If you prefer to set up manually:

mkdir my-site && cd my-site
pnpm init
pnpm add /core /cli

Then create a stedefast.config.ts:

import { defineConfig } from "@stedefast/core";

export default defineConfig({
  siteTitle: "My Site",
  baseUrl: "https://example.com",
  contentDir: "./content",
  outputDir: "./dist",
  theme: "./theme",
});

Start the dev server

pnpm stedefast dev

Your site runs at http://localhost:3000 with live reload on file changes.

How builds work

stedefast build runs a 7-stage pipeline. Stages 3 and 4 run in parallel:

flowchart TD
  A[1. Config & Validation] --> B[2. Content Graph]
  B --> C[3. Module Static Export]
  B --> D[4. Asset Pipeline]
  C --> E[5. Page Rendering]
  D --> E
  E --> F[6. CF Functions Assembly]
  F --> G[7. Manifest]