moon

moon is a build system and repo management tool designed to streamline development in the web ecosystem. Key capabilities include:

Management

• Smart hashing: Ensures deterministic and reproducible builds by collecting inputs from multiple sources.
• Remote caching: Persists builds and hashes across teammates and CI/CD.
• Integrated toolchain: Automatically manages versions for Node.js and other tools.
• Multi-platform: Supports Linux, macOS, and Windows.

Organization

• Project graph: Maps dependency and dependent relationships.
• Code generation: Scaffolds new applications and libraries.
• Dependency workspaces: Works alongside package manager workspaces.
• Code ownership: Manages owners, maintainers, and generates CODEOWNERS.

Orchestration

• Dependency graph: Optimizes performance by understanding task relationships.
• Action pipeline: Executes actions in parallel/order using a thread pool.
• Action distribution: Distributes actions across multiple machines.
• Incremental builds: Rebuilds only what has changed via smart hashing.

Notification

• Flakiness detection: Automatic retries for flaky builds.
• Webhook events: Triggers webhooks for pipeline events.
• Terminal notifications: Build status updates directly in the terminal.
• Git hooks: Manages Git hooks to enforce workflows.

Starting with version 1.7, moon introduced a rewritten configuration system powered by schematic. This update provides several key improvements for developers managing moon configuration files:

• Strict Parsing: moon now performs strict parsing using serde. If you include unknown fields or provide invalid value types in your configuration, moon will return a descriptive error message identifying the specific failure and the file that failed to parse. This helps catch typos and incorrectly nested settings.
• Recursive Validation: Instead of stopping at the first error, moon now aggregates all validation errors. This includes errors from deeply nested fields, allowing you to see all configuration issues at once rather than fixing them one by one.
• Enhanced Error Reporting: moon uses the miette crate to render all errors and diagnostics. This provides a much better developer experience with improved formatting and, in some cases, code frames that point to the exact location of the error within your configuration files (e.g., in JSON files).

moon provides capabilities across four main pillars:

Management

• Smart hashing: Ensures deterministic and reproducible builds by collecting inputs from multiple sources.
• Remote caching: Shares builds, hashes, and caches between teammates and CI/CD environments.
• Integrated toolchain: Automatically manages and installs explicit tool versions (e.g., Node.js) to ensure environment consistency.
• Multi-platform: Supports Linux, macOS, and Windows.

Organization

• Project graph: Maps dependency and dependent relationships between projects.
• Code generation: Scaffolds new applications, libraries, and tooling.
• Dependency workspaces: Integrates with package manager workspaces to maintain distinct dependency trees.
• Code ownership: Manages owners, maintainers, and support channels, and can generate CODEOWNERS files.

Orchestration

• Dependency graph: Optimizes performance by understanding task dependencies.
• Action pipeline: Executes actions in parallel and in order using a thread pool.
• Action distribution: Distributes actions across multiple machines for higher throughput.
• Incremental builds: Uses smart hashing to only rebuild projects that have changed.

Notification

• Flakiness detection: Automatically retries builds to mitigate flaky results.
• Webhook events: Sends webhooks for pipeline events (useful for metrics).
• Terminal notifications: Provides build status updates directly in your terminal.
• Git hooks: Manages Git hooks to enforce contributor workflows.