caution do not use package.json
for the folder name if you want to clone this project to your machine - it will break yarn
(An unexpected error occurred: "EISDIR: illegal operation on a directory, read".
).
Original version of this document copied from yarnpkg.
See also npm documentation, std-pkg, clean-publish, package-json-validator, cosmiconfig, rc (as an opponent approach to cosmiconfig).