Minimal Static Site Generator

Minimal Static Site Generator (mSSG) is a minimal static site framework built on Next.js, MDX, and shadcn/ui. Content lives as plain .mdx files on disk, without databases or CMS's.

Checkout the repository on GitHub.

Features

• File-based routing — URL paths map directly to content/ on the filesystem
• MDX — write content in Markdown with custom directives
• GitHub Flavored Markdown — tables, strikethrough, task lists, and more
• Static generation — every page is pre-rendered at build time
• Dark mode — follows system settings
• Math — KaTeX rendering via remark-math + rehype-katex
• Syntax highlighting — Shiki with github-light / github-dark themes
• Sitemap — auto-generated /sitemap.xml from all content routes

Documentation

Start from Getting Started.

• guides/customization
  Customization

  How to customize the site's appearance, fonts, and theme tokens.

  Read
• guides/getting-started
  Getting Started

  Fork, configure, and run mSSG in minutes.

  Read
• guides/writing-content
  Writing Content

  How the file-based content model works and how to write MDX pages.

  Read

• reference/configuration
  Configuration

  Reference for site.config.ts and the SiteConfig schema.

  Read
• reference/frontmatter
  Frontmatter

  Complete reference for all supported frontmatter fields.

  Read
• reference/mdx-directives
  MDX Directives

  Overview of all built-in directives available in content files.

  Read
• reference/sidebar
  Sidebar

  How to configure the sidebar navigation using content/_nav.mdx and the nav-section directive family.

  Read

Directives

Each built-in directive has its own reference and examples.

Visit Directives for an exhaustive list.