Static sites

Generate SEO-friendly static sites from Fission widgets and content.

Use custom widget routes for marketing pages and Markdown content routes for documentation, reference, blogs, and changelogs.

Read static site guide

View this site structure

Static site build

Custom route

/product/overview/

Content route

/docs/learn/quickstart/

Generated

HTML CSS search sitemap

Static site system

Static output without abandoning Fission widgets.

Use Fission components where design matters and Markdown content routes where documentation, references, blogs, and changelogs need to scale.

Custom pages

Designed landing pages

Homepages and product pages are normal Fission widgets rendered to static HTML at build time.

Content routes

Markdown at scale

Documentation and reference pages come from content folders, front matter, explicit sidebars, generated headings, and templates.

SEO

Static output

The site shell emits ordinary HTML, CSS, metadata, search indexes, assets, favicon links, and structured data support.

Site architecture

Custom routes and content routes solve different jobs.

A production static site needs designed pages, navigable content, metadata, assets, search, generated CSS, and publishing output.

Custom pages

Marketing pages are widgets

Homepages and product pages are normal Fission component trees, so layout, theme, links, imagery, and footer structure stay in Rust instead of a separate template language.

Custom pages

Content routes

Markdown scales the docs

Folders under `content/` become route trees with front matter, sidebars, tables, code blocks, in-page links, metadata, generated blog landing pages, and search data.

Content routes

Publishing

Static output is portable

The build emits ordinary HTML, CSS, assets, sitemap, robots, favicon, search index, and optional page elements for GitHub Pages or other static hosts.

Package static sites

Publishing path

Design pages, author content, generate portable HTML.

Design

Build bespoke landing pages with Fission widget components.

Author

Write docs and reference content in Markdown or MDX under content folders.

Publish

Generate static output for GitHub Pages or another static host.

This site is the example

The Fission documentation site is generated by the Fission static site shell, including custom pages, content routes, sidebars, search, and metadata.

Build a content site