Custom Domains

Custom domain support with allows you to serve your documentation content through any domain (or subdomain) you own rather than via the domain.

You can see a custom domain in action by viewing the Melos repository documentation, using the subdomain.


A couple of manual steps are required before you can serve docs via your custom domain.

1. Domain DNS

The first step is to point your domain at our domains service via a CNAME record. Using your domain provider, create a DNS record:

invertase.devrecord typevalue

Subdomains are also supported:

invertase.devrecord typevalue

If you are using a proxy service (e.g., Cloudflare), ensure you disable the proxy to allow the proxy service to provide SSL for you.

2. Add domain

Create a Pull Request to modify the domains.json file at the root of the repository.

Create a new array entry, adding your domain followed by the GitHub organization and repository, for example:

[["", "invertase/melos"]]

Once your Pull Request is approved and DNS has been propagated, you are ready to start using your custom domain.

Existing documentation

If your users have already been visiting your documentation via the domain, (e.g. and you add a custom domain at a later date, visitors will still be able to view the documentation, however all internal page links will point towards the new domain.

This ensures adding a domain has no impact on users visiting saved URLs.

Local development

If you are contributing to the project whilst running a page with a custom domain, you'll need to modify your local hosts to locally map the domain: will automatically handle ports during local development.