meta
tool for turning many repos into a meta repo. why choose many repos or a monolithic repo, when you can have both with a meta repo?
What is meta?
tool for turning many repos into a meta repo. why choose many repos or a monolithic repo, when you can have both with a meta repo?
Overview of meta
What it is
meta is a tool for managing multi-project systems and libraries. It allows users to work with a meta repo that references multiple individual repositories, providing the benefits of both a monorepo and many repos. meta is built on loop and uses plugins to execute commands against some or all of the repos in a solution at once. It is packaged with several core plugins by default.
Key features
- Clone a many-project architecture in one line - Execute arbitrary commands against many repos simultaneously - Super simple plugin architecture using commander.js - Easily wrap commands for working with any platform, not just Node - meta repo keeps code in per project repos, benefiting deployment and reuse - Use the same tools you always use, with no strange side effects of git submodules or subtree - Give different teams different slices of your architecture with multiple metarepos - Use
meta project migrateto migrate mono-repos to a meta repo consisting of many repos
Use cases
- Product Development Team: Group multiple applications and services so every developer can clone a single project to get everything needed for development. A docker-compose file or Makefile at the root can run all services and applications.
- Developing a Library with many modules: Meta itself is developed with meta, providing a monorepo-like feel while developing with individual components that have their own release cycles. It takes advantage of
npm linkfor a good development experience. - Migrating a Monorepo to many repos:
meta project migratehelps move from a monorepo to a meta repo by moving directories from the existing repo.
Getting started
To install: npm i -g meta To initialize a new meta project: 1. Create a new directory: mkdir my-meta-repo 2. Initialize a git repository: cd my-meta-repo && git init 3. Initialize as a meta repo: meta init 4. To create a new project: meta project create [folder] [repo url] 5. To import an existing project: meta project import [folder] [repo url] To clone an existing meta repo: meta git clone [email protected]:mateodelnorte/meta.git To get meta project updates: sh git pull origin master meta git update
License and pricing
The license is MIT. The pricing type is open source.
Based on the project's public README and repository metadata.