Routes requests to multiple apps by domain, subdomain, or path prefix patterns.
npx skills add https://github.com/rangojs/rango --skill host-router-rangojs
Please help me install this Agent Skill. Skill: host-router Source: https://github.com/rangojs/rango/tree/main/packages/rangojs-router/skills/host-router Command: npx skills add https://github.com/rangojs/rango --skill host-router-rangojs
admin.*, **.example.com, or example.com/api and map each to an inline handler or a lazily imported sub-app. - Middleware and fallback handling: Attach global or per-route middleware, configure a fallback for cookie-override errors, and catch NoRouteMatchError for unmatched hosts. - Cookie-based host override for development: Route requests to different apps from a single domain using a validated cookie, with optional custom validation logic. - Use Case: A team serves a marketing site, an admin dashboard, and an API from one Cloudflare Worker or Vercel function, dispatching by subdomain while testing each app locally via a dev cookie. ## Quick Start Create a host router that routes admin subdomain requests to the admin app and all other requests to the main app.High-intent search queries and answers about installing and using this skill.
Create a host router with createHostRouter and register host patterns like admin.* or api.*, each mapped via .lazy() to a sub-app module. Incoming requests are matched against patterns in registration order, and the first match handles the request.
Use .map for an inline handler that returns a Response directly, and .lazy for a dynamic import of a sub-app handler or nested host router. Passing a lazy import to .map is a type error because a module is not a Response.
Yes, but the export shape differs. On Cloudflare you export a fetch handler that calls router.match; on node and vercel presets you export the HostRouter instance itself so the generated RSC entry can call hostRouter.match for you.
Unmatched hosts throw NoRouteMatchError. On Cloudflare, catch it in your worker fetch using the isNoRouteMatchError guard and return a 404; on node and vercel presets, the generated entry catches it and returns 404 by default.
Yes, configure hostOverride with a cookie name and allowedHosts. When the cookie is present and the request host is allowed, the cookie value is used as the effective hostname, letting you exercise different host routes during development.
mathfalconDefine code-based route trees with createRootRoute and createRoute for React apps.
tgunawandevAutomate Cloudflare infrastructure administration via kctl-cloudflare CLI and Terraform.
kcc989Define structured routing and middleware pipelines for rwsdk Cloudflare Workers apps.
MassimilianoPiliConfigure Nginx reverse proxy patterns for self-hosted services.