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 JSX components embedded
• 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.

Below is an exhaustive list of all documentations.

• Customization

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

• Getting Started

  Fork, configure, and run mSSG in minutes.

• Writing Content

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

• Configuration

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

• Frontmatter

  Complete reference for all supported frontmatter fields.

• MDX Components

  Reference for all built-in MDX components available in content files.