Skip to main content

URLs And Routing

W7S maps GitHub repositories to public URLs on w7s.cloud.

Repository paths​

A repository named:

github.com/owner/repo

is served at:

https://owner.w7s.cloud/repo/

Example:

https://w7s-io.w7s.cloud/docs/

Branch environments​

main and master deploy to production, which uses the owner host. Other branches deploy to a branch environment and use a branch-prefixed host:

https://<branch-environment>--owner.w7s.cloud/repo/

The branch environment is DNS-safe. W7S lowercases the branch name, replaces runs of characters outside a-z, 0-9, and - with -, collapses repeated hyphens, trims leading/trailing hyphens, and caps the result at 63 characters. For example:

feature/API.v2_test -> feature-api-v2-test
https://feature-api-v2-test--owner.w7s.cloud/repo/

Owner roots​

If the repository has the same name as the owner:

github.com/owner/owner

it can serve the owner root:

https://owner.w7s.cloud/

This is useful for personal or organization homepages.

Missing routes​

When W7S cannot find a deployment for a requested owner or repository path, it shows a deploy help page with the exact GitHub repository needed for that URL.

For example:

https://sadasant.w7s.cloud/example/

points at:

https://github.com/sadasant/example