At https://hyper.is/#config-location, it reads:

macOS: ~/Library/Application Support/Hyper/.hyper.js
Windows: $Env:AppData/Hyper/.hyper.js
Linux: ~/.config/Hyper/.hyper.js

Note: config at ~/.hyper.js still supported, but will be ignored, if config in application directory present. Otherwise it will be moved to the application directory at first run.

Observations:

1. On a fresh install of Hyper on macOS 10.15:

   • ~/.hyper.js is created
   • ~/Library/Application Support/Hyper/.hyper.js is not created

2. Changes saved to ~/.hyper.js are reflected in the app

3. If I copy and paste customized config contents into ~/Library/Application Support/Hyper/.hyper.js and then delete ~/.hyper.js, Hyper does not seem to recognize the customized config.

It seems that the documentation does not represent the current behavior of Hyper.

I have only recently begun to explore Hyper, so I would like to understand this better: is the documentation outdated or is it new information that is planned for a future release, but is not yet relevant?

Either way, the docs should probably be updated to reflect the current app behavior.