Skip to main content

Routing


Core · Routing

Core principle — Treat route selection as a deterministic contract, especially when dynamic and catch-all paths coexist.

Routing


Core · Routing

Core principle — Treat route selection as a deterministic contract, especially when dynamic and catch-all paths coexist.
Predictable precedence, parameters, method boundaries, and 404 behaviorPredictable precedence, parameters, method boundaries, and 404 behavior.

Key concepts

Exact path

Highest certainty

Parameter

Validated value

Fallback

Explicit 404

Boundary model

Ownership matrix

Engineering considerations

Routing bugs are often silent: a request reaches a valid handler that was not the intended handler.
Design constraint A route tree is an executable product map; ambiguity is a defect.

Implementation notes

Decision lens

References

Key concepts

Exact path

Highest certainty

Parameter

Validated value

Fallback

Explicit 404

Boundary model

Ownership matrix

Engineering considerations

Routing bugs are often silent: a request reaches a valid handler that was not the intended handler.
Design constraint A route tree is an executable product map; ambiguity is a defect.

Implementation notes

Decision lens

References

Last modified on September 10, 2026