Monorepo to hold tools made for DX ⚡
| Name | Description | Documentation |
|---|---|---|
vland |
🦉 CLI to init a new project in Variable Land | vland (CLI reference) |
run-run |
🦊 CLI + plugin ecosystem for scripts in Variable Land | run-run (CLI reference) |
shared |
🛠 Internal utilities shared across both CLIs | clibuddy, loggy |
The run-run ecosystem ships as opt-in pieces: the @rrlab/cli kernel + four official plugins (@rrlab/{biome,oxc,ts,tsdown}-plugin) + their shared config presets (@rrlab/{biome,ts,tsdown}-config). See run-run/CLAUDE.md for the architecture.
To get started with any package, navigate to the respective package directory and follow the installation and usage instructions in its README.
To use this monorepo, you need to have the following tools installed:
-
Clone the repository:
git clone git@github.com:variableland/dx.git
-
Install dependencies:
pnpm install
-
Run tests:
pnpm test
This monorepo uses Turborepo to manage tasks. Here are some useful commands:
pnpm build- Build all packagespnpm test- Run tests for all packages
Additionally, the monorepo itself uses the CLIs run-run and vland:
pnpm rr- Run therun-runCLI in development modepnpm vland- Run thevlandCLI in development mode
If you have mise installed, you can use the following commands directly:
rr- Run therun-runCLI in development modevland- Run thevlandCLI in development mode
This monorepo uses Changesets to manage releases. The Changesets bot is also installed in the repository.
Preview Release:
To preview changes in any package, create a pull request using the branch pattern feat/* or fix/* or add a label preview to the PR. This triggers a special GitHub workflow that publishes the package with the changes to the npm registry under the tag pr-<PR_NUMBER>. To preview your changes, install the package with the corresponding tag:
pnpm add @vlandoss/<package>@pr-123For @rrlab/*-plugin packages, rr plugins add accepts the same @<tag> suffix and propagates it to the plugin's @rrlab/*-config sibling — falling back to latest for any sibling the preview didn't publish:
rr plugins add biome@pr-123