@stattic/routing

Routing parser and matcher for Stattic _redirects and _headers files.

The CLI and Vite plugin use this package to validate routing rules before a version is finalized. Install it directly when you need to inspect, compile, or test Stattic routing behavior in your own tooling.

Install

npm install @stattic/routing

Compile Routing Files

import { compileRoutingFiles } from "@stattic/routing/compile";

const routing = compileRoutingFiles({
  redirects: "/old /new 301\n/api/* https://api.example.com/:splat 200",
  headers: "/*\n  x-frame-options: DENY",
});

if (routing.diagnostics.length > 0) {
  console.warn(routing.diagnostics);
}

Match Requests

import { headersForRequest, matchRedirect } from "@stattic/routing/match";

const request = {
  url: new URL("https://example.com/old"),
  headers: new Headers(),
};

const redirect = matchRedirect({ compilation: routing, request });
const headers = headersForRequest(routing, request);

Documentation

• Stattic docs
• CLI docs
• Redirects
• Headers
• LLM guide