.moon/tasks.yml file configures file groups and tasks that are inherited by every project in
the workspace, while
.moon/tasks/**/*.yml configures for projects based on their language or type.
Learn more about task inheritance!
Projects can override or merge with these settings within their respective
Defines an external
.moon/tasks.yml to extend and inherit settings from. Perfect for reusability
and sharing configuration across repositories and projects. When defined, this setting must be an
HTTPS URL or relative file system path that points to a valid YAML document!
For map-based settings,
tasks, entries from both the extended configuration and
local configuration are merged into a new map, with the values of the local taking precedence. Map
values are not deep merged!
Defines file groups that will be inherited by projects, and also enables
enforcement of organizational patterns and file locations. For example, encourage projects to place
source files in a
src folder, and all test files in
File paths and globs used within a file group are relative from the inherited project's root, and not the workspace.
deps that are implicitly inserted into all inherited tasks within
a project. This is extremely useful for pre-building projects that are used extensively throughout
the repo, or always building project dependencies. Defaults to an empty list.
Implicit dependencies are always inherited, regardless of the
inputs that are implicitly inserted into all inherited tasks
within a project. This is extremely useful for the "changes to these files should always trigger a
inputs, file paths/globs defined here are relative from the inheriting project.
Project and workspace relative file patterns are
supported and encouraged.
Implicit inputs are always inherited, regardless of the
As mentioned in the link above, tasks are actions that are ran within the context of a project, and commonly wrap a system command. For most workspaces, every project should have linting, typechecking, testing, code formatting, so on and so forth. To reduce the amount of boilerplate that every project would require, this setting offers the ability to define tasks that are inherited by many projects within the workspace, but can also be overridden per project.
command: 'prettier --check .'
command: 'eslint --no-error-on-unmatched-pattern .'
command: 'jest --passWithNoTests'
command: 'tsc --build'
Relative file paths and globs used within a task are relative from the inherited project's root, and not the workspace.