Dynamic Routes

Sol SSG supports dynamic route generation using the _param_ directory naming pattern. This allows you to generate multiple static pages from a single template.

Basic Usage

Directory Structure

docs/
└── posts/
    ├── index.md              # Posts listing page
    └── _slug_/               # Dynamic parameter directory
        ├── page.json         # Static params configuration
        └── index.md          # Template for each page

Configuration (page.json)

Define which pages to generate using staticParams:

{
  "staticParams": [
    { "slug": "hello-world" },
    { "slug": "getting-started" },
    { "slug": "advanced-topics" }
  ]
}

Template (index.md)

The template file is used for all generated pages:

---
description: A blog post
---

# Post Page

This content is shared across all generated pages.

Generated Output

With the above configuration, Sol SSG generates:

• /posts/hello-world/index.html

• /posts/getting-started/index.html

• /posts/advanced-topics/index.html

Parameter Naming

The parameter name is extracted from the directory name:

Auto-Generated Titles

If no title is specified in frontmatter, Sol SSG generates one from the parameter value:

• hello-world → "Hello World"

• getting-started → "Getting Started"

Multiple Parameters

You can use multiple parameters in nested directories:

docs/
└── blog/
    └── _category_/
        └── _slug_/
            ├── page.json
            └── index.md

{
  "staticParams": [
    { "category": "tech", "slug": "intro-to-moonbit" },
    { "category": "tech", "slug": "advanced-patterns" },
    { "category": "news", "slug": "release-notes" }
  ]
}

Comparison with Client-Side Routing

For client-side dynamic routing (SPA), see Islands.