Introduction
moonrepo is a productivity platform that aims to eliminate pain points for both developers and companies, by automating tiresome and complex workflows, and improving the overall developer experience.
We currently achieve this through the following tools and services:
moon
moon is a repository management, organization, orchestration, and notification tool for the web ecosystem, written in Rust. Many of the concepts within moon are heavily inspired from Bazel and other popular build systems, but tailored for our supported languages.
You can think of a moon as a tool that sits firmly in the middle between Bazel (high complexity, full structure), and make/just/etc scripts (low complexity, no structure).
Why use moon?
Working in a language's ecosystem can be very involved, especially when it comes to managing a repository effectively. Which language version to use? Which dependency manager to use? How to use packages? Or how to build packages? So on and so forth. moon aims to streamline this entire process and provide a first-class developer experience.
- Increased productivity - With Rust as our foundation, we can ensure robust speeds, high performance, and low memory usage. Instead of long builds blocking you, focus on your work.
- Exceptional developer experience - As veterans of developer tooling, we're well aware of the pain points and frustrations. Our goal is to mitigate and overcome these obstacles.
- Incremental adoption - At its core, moon has been designed to be adopted incrementally and is not an "all at once adoption". Migrate project-by-project, or task-by-task, it's up to you!
- Reduced tasks confusion - Tasks (for example,
package.json
scripts) can become unwieldy, very quickly. No more duplicating the same task into every project, or reverse-engineering which root scripts to use. With moon, all you need to know is the project name, and a task name. - Ensure correct versions - Whether it's a programming language or dependency manager, ensure the same version of each tool is the same across every developer's environment. No more wasted hours of debugging.
- Automation built-in - When applicable, moon will automatically install dependencies
(
node_modules
), or sync project dependencies, or even sync TypeScript project references. - And of course, the amazing list of features below!
Supported languages
moon's long-term vision is to robustly support multiple programming languages (and dependency managers) so that a repository composed of projects with differing languages and tools can all work in unison. This is a lofty vision that requires a massive amount of time and resources to achieve, and as such, is not available on initial release, but will gradually be supported over time.
To help achieve this vision, language support is broken down into 4 tiers, allowing us to incrementally integrate and improve them over time. The 4 tiers are as follows:
- Tier 0 No direct integration - Tool is not directly supported in moon, but can still be ran using the "system" task toolchain, which expects the tool to exist in the current environment.
- Tier 1 Project categorization - Projects can
configure their primary language in
moon.yml
, and have a dedicated Rust crate for metadata. - Tier 2 Ecosystem platformization - moon deeply integrates with the language's ecosystem by parsing manifests, lockfiles, and other semantic files to infer dependencies, tasks, and other necessary information.
- Tier 3 Toolchain integration - Language is
directly supported in the toolchain, configured in
.moon/toolchain.yml
, and will automatically be downloaded and installed.
Tier 0 | Tier 1 | Tier 2 | Tier 3 | |
---|---|---|---|---|
Bash/Batch | 🟢 | 🟢 | ||
Bun (JavaScript, TypeScript) | 🟢 | 🟢 | 🟢 | 🟢 |
Deno (JavaScript, TypeScript) | 🟢 | 🟢 | 🟣 | 🟣 |
Go | 🟢 | 🟢 | ||
Node (JavaScript, TypeScript) | 🟢 | 🟢 | 🟢 | 🟢 |
└─ npm, pnpm, yarn | 🟢 | ⚪️ | 🟢 | 🟢 |
PHP | 🟢 | 🟢 | ||
└─ Composer | 🟢 | ⚪️ | ||
Python | 🟢 | 🟢 | 🟣 | 🟣 |
└─ Pip | 🟢 | ⚪️ | 🟣 | |
Ruby | 🟢 | 🟢 | ||
└─ Gems, Bundler |