Routing Information
Last updated March 31, 2026
The routing object in onBuildComplete provides complete routing information with processed patterns ready for deployment:
routing.beforeMiddleware
Routes applied before middleware execution. These include generated header and redirect behavior.
routing.beforeFiles
Rewrite routes checked before filesystem route matching.
routing.afterFiles
Rewrite routes checked after filesystem route matching.
routing.dynamicRoutes
Dynamic matchers generated from route segments such as [slug] and catch-all routes.
routing.onMatch
Routes that apply after a successful match, such as immutable cache headers for hashed static assets.
routing.fallback
Final rewrite routes checked when earlier phases did not produce a match.
Common Route Fields
Each route entry can include:
source: Original route pattern (optional for generated internal rules)sourceRegex: Compiled regex for matching requestsdestination: Internal destination or redirect destinationheaders: Headers to applyhas: Positive matching conditionsmissing: Negative matching conditionsstatus: Redirect status codepriority: Internal route priority flag
Was this helpful?