Skip to content

Subdomain registry

Unlike is-a.dev and Open Domains where subdomain ownership data is coupled with DNS records in one JSON file per subdomain, we chose to seperate them from the underlying DNS records to seperate concerns without having to maintain additional code parsing them and programmatically manage them (we use octoDNS for YAML-based DNS records as code) and to simplify maintainer workload.

Where they are managed?

Subdomain registry data are stored and managed as good old YAML files in the data directory. Subdomain maintainers can edit their own data via the GitHub/GitLab flow.

Our YAML schema for those are in the root of data directory named as registry-data.json file for use in your editors and validation tooling.

API Docs

API documentation for the registry is available at https://api.lorebooks.wiki/docs (source code), alongside some utilities we built around the data.

Examples