indo

Workspaces where each package has its own commit history.

Setup your monorepo with one command:

``sh
npx indo
`

Synopsis

Monorepos are great for keeping a bundle of packages tied together by a commit history, but sometimes a package needs (or already has) its own commit history. For example, you might be developing a fork of someone else's package. Indo lets you choose which packages deserve their own commit history. Just run git clone and Indo will notice. Note: Be sure to add your clones to .gitignore to avoid git submodules (which are not supported by Indo).

Indo automatically searches your monorepo for package.json files, which means it can be used with zero setup. The indo command will (1) create the .indo.json if none is found, (2) clone any missing repos, (3) install dependencies, (4) run build scripts, and (5) link local packages together.

Fun facts:

- Indo never hoists dependencies
- Indo plays nicely with Yarn workspaces
- Indo makes forking a breeze

 

Guides

- Get Started
- Using Vendor Packages
- Using Yarn Workspaces
- Using A Temporary Fork
- Using yarn link
- Configuration

 

Commands

$3

Run this command to bootstrap your Indo-powered monorepo, which involves
cloning any missing repos, installing any dependencies, and linking together your
local packages.

Specify -f/--force to see which packages are linked where. Otherwise, only
newly linked packages are printed.

Note: Packages are ignored when no version exists in their package.json.

 

$3

Print documentation for a specific command.

`sh


What does "indo clone" do?


indo clone help
`

Aliases: -h, --help

 

$3

Shallow clone a repository and add it to "repos" in the nearest .indo.json config.

You can even provide a package name instead of a git url! For example, indo clone lodash
asks npm for the git url and clones it into vendor/lodash by default. You can also pass
an optional directory name (eg: indo clone lodash a/b/c).

 

$3

Link a global package to the ./vendor/ directory, and link it to packages that can use it.

`sh
indo link lodash
`

However, before you can do that, you must call indo link in your lodash clone.

`sh


Clone "lodash" outside your monorepo.

git clone https://github.com/lodash/lodash.git ~/dev/lodash
cd ~/dev/lodash

Add it to Indo's global package registry.

indo link
`

It's basically yarn link except with automatic linking to packages in your monorepo. 😻

For a monorepo whose root package is unnamed, use indo link -g to register it globally.
Then use indo link to link your local packages to it.

 

$3

Remove the current package from Indo's global package registry.

`sh
indo unlink
`

To revert indo link commands, run indo unlink and the given package names
will be removed from the ./vendor/ directory (but only if they were added with indo link).

`sh
indo unlink lodash
`

 

$3

Add dependencies to the current package, using its preferred npm client (eg: yarn or pnpm).

After installing, the dependency is replaced with a local package if possible.

`sh
indo add lodash
`

Supported flags:
- --prod (enabled by default)
- -P/--peer
- -D/--dev
- -O/--optional
- -E/--exact

 

$3

Remove dependencies from the current package, using its preferred npm client.

`sh
indo remove lodash
`

Aliases: rm

 

$3

See which packages are detected by Indo.

`sh
indo list
`

Aliases: ls

 

$3

Run a npm script in every non-vendor package.

`sh
indo run build
`

 

$3

Run an arbitrary command in every non-vendor package.

Note: Piping is not yet supported.

`sh
indo exec -- echo \$PACKAGE_NAME
`

Injected variables include:
- PACKAGE_NAME
- PACKAGE_ROOT

 

$3

Run a git command in every .git repo containing a non-vendor package.

Note: Your customized git aliases are supported!

`sh
indo git status
`

 

$3

Remove one or more packages, cleaning up .indo.json along the way.

For example, indo purge foo bar removes the ./foo and ./bar directories (relative to the current directory) from the filesystem and from the nearest .indo.json file.

The given directories are not required to contain a package.json. For example, you can do indo rm packages
to delete the entire packages directory, which may contain dozens of repos, each with its own package.json. Indo re-installs the dependencies of any non-vendor package that was linked to a removed package.

It's basically rm -rf but with:
- a confirmation prompt
- automatic updates to the nearest .indo.json file
- an install step for depending packages

 

$3

Create an empty .indo.json file in the current directory, replacing any pre-existing .indo.json file.

The indo command automatically invokes this command when neither the current directory nor any of
its ancestors contain a .indo.json` file.