Repository convention

A realm is a git repo whose name begins with realm- (e.g. realm-github, realm-stripe, realm-research). The host installs a realm by cloning it into a world’s realms/ directory.

Realm sources are configured at the host level. A typical host configuration:

# host application.yml
embabel:
  directory:
    realm-sources:
      - name: embabel
        type: org
      - name: johnsonr
        type: user

Each entry exposes the realms whose name matches realm-* from the given GitHub org or user.