STATIC SITES
Publish fast, crawlable sites without creating a second frontend stack.
Use Fission widgets for designed pages and Markdown routes for documentation, references, blogs, and changelogs. The result is portable HTML, CSS, metadata, and search that any static host can serve.
# fission.toml for this documentation site
[site]
base_url = "https://fission.rs"
generate_sitemap = true
[[site.routes]]
kind = "content"
path = "/docs"
source = "content/docs"
template = "fission::site::documentation"
$ fission site build --project-dir documentation
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.
01
Design
Build bespoke landing pages with Fission widget components.
02
Author
Write docs and reference content in Markdown or MDX under content folders.
03
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.