Routing

Jamrock uses file-system routing inspired by SvelteKit. Routes are defined by creating files in your pages directory, and the file path determines the URL path.

File-Based Routes

Files ending with +page.html or +page.md define routes:

Dynamic Segments

Use brackets for dynamic route parameters:

Optional Parameters

Use parentheses for optional segments:

Parameter Syntax

There are two equivalent syntaxes for parameters:

• $param — short form: $id+page.html
• [param] — bracket form: [id]+page.html

Both result in the same route. The bracket form is required for catch-all parameters.

Special Files

Each directory can have special files:

Layouts

Layouts wrap all pages in their directory and nested directories:

pages/
├── +layout.html          # Root layout (wraps everything)
├── index+page.html       # / — wrapped by root layout
└── admin/
    ├── +layout.html      # Admin layout (wraps /admin/*)
    └── dashboard+page.html  # /admin/dashboard — wrapped by both layouts

Route Groups

Directories wrapped in parentheses don't affect the URL:

pages/
├── (marketing)/
│   ├── about+page.html   # /about
│   └── contact+page.html # /contact
└── (app)/
    └── dashboard+page.html # /dashboard

This is useful for grouping routes under a shared layout without affecting the URL structure.

Ignored Segments

Segments starting with _ are ignored in the URL:

File Extensions

Use [.ext] to preserve file extensions in routes: