README

Reun Media moon configuration.

Installation

Requirements

moon binary available in PATH

A global installation of moon is recommended. If moon is installed locally (e.g. via npm), it must still be available in PATH.

From npm

bun add -D @reunmedia/moon-config

With Composer

composer require --dev reun/moon-config

Manually

Copy desired configuration files manually from .moon/** to your project.

Usage

Initialize moon:

moon init

Run the included script to generate moon configuration files. The location of the script depends on how you installed the package.

Note: The script requires Bash to run. Refer to manual installation if you aren't running Bash.

# npm installation
bun reun-moon-config

# Composer installation
./vendor/bin/reun-moon-config

Enable Git hooks

Git hooks are not enabled by default and must be synced manually.

moon sync hooks

Task package dependencies

Most tasks require specific dependencies to be installed. See the comments in .moon/**/*.yml for list of packages to install. You may disable specific tasks to avoid installing all dependencies.

Disabling specific tasks in project

If you don't want or can't use specific tasks in projects e.g. due to missing dependencies, you can exclude them in local project's moon.yml:

# Example of a PHP project without `php-cs-fixer`, `phpstan` and `package.json`
workspace:
  inheritedTasks:
    exclude:
      - php-cs-fixer
      - phpstan
      - lint-package-json

Upgrading

Clean moon cache to refresh tasks after upgrading to a new version.

moon clean --lifetime 0

reun / moon-config

Maintainers

Details