Static Site is a separate target with a strict HTML-first contract. HTML is fully rendered at build time, CSS handles presentation, and JavaScript is optional and only used for enhancements.

1<pre><code class="language-ts">const msg = "hello";</code></pre>

What Static Site Means

Static Site output guarantees that HTML is fully rendered at build time and remains readable without JavaScript. HTML is the source of truth.

Why It Is a Separate Target

React SSG uses React tooling and bundles even when pages are not hydrated. Static Site exists for content that must remain readable and durable without client frameworks or runtime assumptions.

HTML-First Contract

Every page is a complete HTML document. Links use standard <a href>, and content remains readable without JS.

Progressive Enhancement

Enhancements such as search, copy code, and theme toggle are optional and capability-driven. They must never replace core content.

Capability-Driven JS

Enhancement scripts are included only when capabilities are detected. If no enhancements are needed, no JS is emitted.

Degradation Rules

Incompatible components degrade or emit warnings. Dynamic routes are skipped with explicit warnings to preserve determinism.

Code Blocks and Highlighting

Code blocks render as semantic HTML with optional pre-highlighted output. Client-side highlighting is optional and policy-driven.

Markdown Content

Content strings are parsed as lightweight Markdown. Headings feed the TOC, code fences map to code blocks, and links resolve against known routes.

CSS Responsibilities

CSS must establish layout, typography, and hierarchy. HTML must not rely on JS to look correct.

Accessibility and SEO

Static Site output uses semantic HTML, stable URLs, and optional sitemap and robots.txt generation for SEO.

Routing and Base URL

Routing is filesystem-based with folder style output. baseUrl is resolved during lowering for subpath hosting.

Explicit Non-Goals

Static Site avoids client-side routing, hydration, runtime data fetching, and framework-specific behavior. These are deliberate boundaries.